Improve documentation formatting

Author: Sporiff

src/docs/auth.adoc

@@ -4,11 +4,8 @@
 
 The `auth` endpoint exposes operations for authenticating against the API.
 
-[[actions-auth]]
-== Actions
-
 [[actions-login]]
-=== Log in
+== Log in
 
 [source,httprequest]
 ----
@@ -21,7 +18,7 @@ These values must match the values of the user's account.
 operation::auth-token[snippets='request-fields,curl-request,response-fields,http-response']
 
 [[actions-refresh]]
-=== Request a new access token
+== Request a new access token
 
 You can request a new access token by passing a valid refresh value to the API.
 

src/docs/index.adoc

@@ -3,7 +3,7 @@
 :icons: font
 :source-highlighter: highlightjs
 :toc: right
-:toclevels: 2
+:toclevels: 1
 :sectlinks:
 
 This server implements the https://openpodcastapi.org[Open Podcast API].

src/docs/subscriptions.adoc

@@ -8,23 +8,20 @@ A subscriptionEntity represents two things:
 1. A podcast feed
 2. The relationship between a user and a podcast feed
 
-[[actions-subscriptions]]
-== Actions
-
 [source,httprequest]
 ----
 POST /api/v1/users
 ----
 
 [[actions-subscriptions-create]]
-=== Create subscriptions
+== Create subscriptions
 
 When a user adds a subscription to the system, a corresponding `subscriptionEntity` object is fetched or created depending on whether a matching subscriptionEntity is present.
 A link is then created between the user and the subscriptionEntity.
 
 operation::subscriptions-bulk-create-mixed[snippets='request-headers,request-fields,curl-request,response-fields,http-response']
 
-==== Responses
+=== Responses
 
 If all feeds are valid and no problems are encountered, the server responds with an array of `success` objects and an empty array of `failure` objects.
 
@@ -39,27 +36,27 @@ If the server receives a mix of responses, both arrays are populated.
 include::{snippets}/subscriptions-bulk-create-mixed/http-response.adoc[]
 
 [[actions-subscriptions-list]]
-=== List subscriptions
+== List subscriptions
 
 When a user fetches a list of subscriptions, their own subscriptions are returned.
 The subscriptions of other users are not returned.
 
 operation::subscriptions-list[snippets='request-headers,query-parameters,curl-request,response-fields,http-response']
 
-==== Include unsubscribed
+=== Include unsubscribed
 
 operation::subscriptions-list-with-unsubscribed[snippets='curl-request,http-response']
 
 [[actions-subscriptionEntity-fetch]]
-=== Fetch a single subscriptionEntity
+== Fetch a single subscriptionEntity
 
 Returns the details of a single subscriptionEntity for the authenticated user.
 Returns `404` if the user has no subscriptionEntity entry for the feed in question.
 
 operation::subscriptionEntity-get[snippets='request-headers,path-parameters,curl-request,response-fields,http-response']
 
 [[actions-subscriptionEntity-update]]
-=== Unsubscribe from a feed
+== Unsubscribe from a feed
 
 Unsubscribes the authenticated user from a feed.
 This action updates the user subscriptionEntity record to mark the subscriptionEntity as inactive.

src/docs/users.adoc

@@ -5,11 +5,8 @@
 The `users` endpoint exposes operations taken on user accounts.
 Users may update and delete their own user record, but only admins may update and alter the records of other users.
 
-[[actions-users]]
-== Actions
-
 [[actions-users-get]]
-=== Get all users
+== Get all users
 
 [source,httprequest]
 ----