From 70dcf822349d8042e2db98b7f69a3aa3dc0fd6f9 Mon Sep 17 00:00:00 2001 From: Amy Gale Ruth Bowersox Date: Fri, 17 Apr 2026 19:46:08 -0500 Subject: [PATCH] update README and TODO --- README.md | 11 ++++------- TODO.md | 6 +++--- 2 files changed, 7 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 51e523f..00c6244 100644 --- a/README.md +++ b/README.md @@ -114,14 +114,9 @@ in your `PATH`. Then run `go generate` to regenerate the CSS file before you run ## Installing Amsterdam -You will need a MySQL database to store Amsterdam data. Create a new empty database, then, from the command line, use the command: +You will need a MySQL database to store Amsterdam data. Create a new empty database. -> `mysql -u root -p _databasename_ \< setup/mysql-database.sql` - -(Replace _databasename_ with the name of your database. If you use a user other than `root` for administrative access to your -MySQL server, use that.) - -Ensure a user in your database is granted SELECT, INSERT, UPDATE, and DELETE privileges to all tables in your new database. +Ensure a user in your database is granted all privileges to all tables in your new database. This is the user that you will configure Amsterdam to use. The database may be specified to Amsterdam with the following command line options or environment variables: @@ -133,6 +128,8 @@ The database may be specified to Amsterdam with the following command line optio All these options may also be specified via the configuration file (see below). +The first time you execute Amsterdam, the necessary database tables will be created and populated. + Amsterdam also requires access to a local SMTP server, as it sends out E-mail messages such as account verification, password reminders, subscribed posts, and messages from conference or community hosts. It may be specified to Amsterdam with the following command line options or environment variables: diff --git a/TODO.md b/TODO.md index 16c16be..04e8d71 100644 --- a/TODO.md +++ b/TODO.md @@ -14,9 +14,9 @@ After the point where it reaches feature parity with Venice circa 2006. ## Immediate Cleanups Required -* A better way to set up the database than `setup/database.sql`. Bring the table setup into the application somehow. - The [migrate](https://github.com/golang-migrate/migrate) library might be of use here. -* Database format migrations. +* A better way to set up the database than `setup/database.sql`. Bring the table setup into the application somehow. + The [migrate](https://github.com/golang-migrate/migrate) library might be of use here. +* ~~Database format migrations.~~ * Allow use of Postgres as a database. * Dockerization. * Implement proper help and online documentation.