Update the API docs to describe `user`s, not `login`s.

1 files changed, 21 insertions, 17 deletions

diff --git a/docs/api/initial-setup.md b/docs/api/initial-setup.md
index c2bdaec..0179397 100644
--- a/docs/api/initial-setup.md
+++ b/docs/api/initial-setup.md
@@ -18,7 +18,8 @@ New instances of this service require an initial setup step before they can full
 
 ## Requests before setup completed
 
-Before the service is set up, all API endpoints, other than those specifically documented as exceptions, will return a status of `503 Service Unavailable` to all requests.
+Before the service is set up, all API endpoints, other than those specifically documented as exceptions, will return a status of
+`503 Service Unavailable` to all requests.
 
 Initial setup can be completed only once.
 
@@ -27,9 +28,9 @@ Initial setup can be completed only once.
 
 Initial setup performs the following tasks:
 
-* Create the first login for the service.
+* Create the first user for the service.
 
-	This is the only login that does not require an [invitation](./invitations.md).
+  This is the only user that does not require an [invitation](./invitations.md).
 
 **This endpoint does not require an `identity` cookie.**
 
@@ -39,16 +40,16 @@ Initial setup performs the following tasks:
 
 ```json
 {
-	"name": "example username",
-	"password": "the plaintext password",
+  "name": "example username",
+  "password": "the plaintext password"
 }
 ```
 
 The request must have the following fields:
 
-| Field      | Type   | Description |
-|:-----------|:-------|:--|
-| `name`     | string | The initial login's name. |
+| Field      | Type   | Description                                  |
+|:-----------|:-------|:---------------------------------------------|
+| `name`     | string | The initial login's name.                    |
 | `password` | string | The initial login's password, in plain text. |
 
 <!-- Reproduced in invitations.md. Edit in both places. -->
@@ -65,27 +66,29 @@ The proposed `name` must be valid. The precise definition of valid is still up i
 
 <!-- This prose is duplicated from authentication.md, with small changes for context. If you edit it here, edit it there, too. -->
 
-This endpoint will respond with a status of `200 Okay` when successful. The body of the response will be a JSON object describing the newly-created login:
+This endpoint will respond with a status of
+`200 Okay` when successful. The body of the response will be a JSON object describing the newly-created user:
 
 ```json
 {
-	"id": "Labcd1234",
-	"name": "Andrea"
+  "id": "Uabcd1234",
+  "name": "Andrea"
 }
 ```
 
 The response will include the following fields:
 
-| Field       | Type   | Description |
-|:------------|:-------|:--|
-| `id`        | string | A unique identifier for the newly-created login. This can be used to associate the login with other events, or to make API calls targeting the login. |
-| `name`      | string | The login's name. |
+| Field  | Type   | Description                                                                                                                                        |
+|:-------|:-------|:---------------------------------------------------------------------------------------------------------------------------------------------------|
+| `id`   | string | A unique identifier for the newly-created user. This can be used to associate the user with other events, or to make API calls targeting the user. |
+| `name` | string | The user's name.                                                                                                                                   |
 
 The returned name may not be identical to the name requested, as the name will be converted to [normalization form C](http://www.unicode.org/reports/tr15/) automatically. The returned name will include this normalization; the service will use the normalized name elsewhere, and does not store the originally requested name.
 
 The provided password will also be converted to normalization form C. However, the normalized password is not returned to the client.
 
-The response will include a `Set-Cookie` header for the `identity` cookie, providing the client with a newly-minted identity token associated with the initial login created for this request. See the [authentication](./authentication) section for details on how this cookie may be used.
+The response will include a `Set-Cookie` header for the
+`identity` cookie, providing the client with a newly-minted identity token associated with the initial user created for this request. See the [authentication](./authentication) section for details on how this cookie may be used.
 
 The cookie will expire if it is not used regularly.
 
@@ -95,5 +98,6 @@ This endpoint will respond with a status of `400 Bad Request` if the proposed `n
 
 ### Setup previously completed
 
-Once completed, this operation cannot be performed a second time. Subsequent requests to this endpoint will respond with a status of `409 Conflict`.
+Once completed, this operation cannot be performed a second time. Subsequent requests to this endpoint will respond with a status of
+`409 Conflict`.