Docs: linting

docs/api.md

@@ -147,7 +147,7 @@ This API will retrieve information about a specific user. The first API version
 
 Where `login` is a GitHub username, case insensitive.
 
-##### Response
+##### Response: by GitHub username
 
 If a link is not found for the GitHub user
 
@@ -188,7 +188,7 @@ This API returns an array if there is at least one matching account or accounts.
 
 Where `id` is an AAD ID.
 
-##### Response
+##### Response: by AAD ID
 
 If a link is not registered for this user
 
@@ -233,7 +233,7 @@ Required API scope: `link`
 
 > POST /api/people/links
 
-#### Request
+#### Request: create a link
 
 ```text
 BODY
@@ -249,7 +249,7 @@ BODY
 
 > If the account is a Service Account, the `corporate` object should also include a field called `serviceAccountMail` that points to a contact for the service account.
 
-#### Response
+#### Response: create a link
 
 ```http
 Status: 201 OK