Skip to content

Commit 12ef8bc

Browse files
committed
Document the dev:populate script
1 parent 1d94485 commit 12ef8bc

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

doc/CONFIGURE.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -50,10 +50,15 @@ osmosis --read-pbf greater-london-latest.osm.pbf \
5050
5151
## User Management
5252

53-
After creating a user through the web interface at [http://localhost:3000/user/new](http://localhost:3000/user/new), you may need to perform additional user management tasks.
53+
Many features of the website require a user. The following script can get you started:
5454

55-
> [!TIP]
56-
> If you don't want to set up your development box to send emails, you can manually confirm users and grant permissions through the Rails console.
55+
```bash
56+
$ bundle exec rails dev:populate
57+
```
58+
59+
This will create two users: `admin` (with administrator privileges) and `mapper` (with normal privileges). For either of them, the password is `password` (feel free to change it).
60+
61+
Alternatively, you can create users manually using the web interface at [http://localhost:3000/user/new](http://localhost:3000/user/new). If you go this route, you may need to perform additional user management tasks. At the very least, new users need to be activated in order to sign in. You can do this via the Rails console as follows.
5762

5863
### Managing Users via Rails Console
5964

@@ -100,7 +105,9 @@ There are two built-in applications which communicate via the API, and therefore
100105
* **iD** - the web-based editor
101106
* **The website itself** - for the Notes functionality
102107

103-
You need to register these applications with *one* of the users you created. After that iD and Notes functionality becomes available to every user of the website.
108+
If you used the `dev:populate` script to create your initial users, this step should not be necessary.
109+
110+
Otherwise, you need to register these applications with *one* of the users you created. After that iD and Notes functionality becomes available to every user of the website.
104111

105112
### Automated OAuth Setup (Recommended)
106113

0 commit comments

Comments
 (0)