Update api-ref

Fix a typo and update the headings currently missing the resource
name (may seem redundant, but it's important because some have '_'
and some have '-' in the name).

Change-Id: I47bf40759b9f298dbdc2fcc59e0617d8b5f3fc0b

api-ref/source/v3/attachments.inc

@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
-Attachments
+Attachments (attachments)
-===========
+=========================
 
 Lists all, lists all with details, shows details for, creates, and
 deletes attachment.

api-ref/source/v3/group-replication.inc

@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
-Group replication
+Group replication (groups, action)
-=================
+==================================
 
 Lists targets, enables, disables, and fails over group replication.
 

api-ref/source/v3/group-snapshots.inc

@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
-Group snapshots
+Group snapshots (group_snapshots)
-===============
+=================================
 
 Lists all, lists all with details, shows details for, creates, and
 deletes group snapshots.

api-ref/source/v3/group-type-specs.inc

@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
-Group type specs
+Group type specs (group_types, group_specs)
-================
+===========================================
 
 Create or update group specs for a group type
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

api-ref/source/v3/group-types.inc

@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
-Group types
+Group types (group_types)
-===========
+=========================
 
 To create a generic volume group, you must specify a group type.
 

api-ref/source/v3/groups.inc

@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
-Generic volume groups
+Generic volume groups (groups)
-=====================
+==============================
 
 Generic volume groups enable you to create a group of volumes and
 manage them together.

api-ref/source/v3/messages.inc

@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
-Messages
+Messages (messages)
-========
+===================
 
 Lists all, shows, and deletes messages. These are error messages generated by
 failed operations as a way to find out what happened when an asynchronous

api-ref/source/v3/resource-filters.inc

@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
-Resource Filters
+Resource Filters (resource_filters)
-================
+===================================
 
 Lists all resource filters, available since
 microversion 3.33.

api-ref/source/v3/vol-transfer-v3.inc

@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
-Volume transfer (3.55 or later)
+Volume transfers (volume-transfers) (3.55 or later)
-===============================
+===================================================
 
 Transfers a volume from one user to another user.
 This is the new transfer APIs with microversion 3.55.

api-ref/source/v3/volume-type-access.inc

@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
-Volume type access (volumes)
+Volume type access (types, action) (types, os-volume-type-access)
-============================
+=================================================================
 
 Private volume type access to project.