CBG-4503 use natural language for openapi

docs/api/admin.yaml

@@ -198,8 +198,6 @@ tags:
     description: Create and manage database users and roles
   - name: Session
     description: Manage user sessions
-  - name: OpenID Connect
-    description: Manage OpenID Connect
   - name: Document
     description: Create and manage documents and attachments
   - name: Replication

docs/api/paths/admin/db-_ensure_full_commit.yaml

@@ -8,7 +8,7 @@
 parameters:
   - $ref: ../../components/parameters.yaml#/db
 post:
-  summary: '/{db}/_ensure_full_commit'
+  summary: Ensure Full Commit
   description: |-
     This endpoint is non-functional but is present for CouchDB compatibility.
 

docs/api/paths/admin/db-_replication-.yaml

@@ -53,17 +53,3 @@ post:
   tags:
     - Replication
   operationId: post_db-_replication-
-head:
-  summary: /{db}/_replication/
-  responses:
-    '200':
-      description: OK
-    '404':
-      description: Not Found
-  tags:
-    - Replication
-  description: |-
-    Required Sync Gateway RBAC roles:
-
-    * Sync Gateway Replicator
-  operationId: head_db-_replication-

docs/api/paths/admin/db-_replicationStatus-.yaml

@@ -34,17 +34,3 @@ get:
   tags:
     - Replication
   operationId: get_db-_replicationStatus-
-head:
-  summary: /{db}/_replicationStatus/
-  responses:
-    '200':
-      description: OK
-    '400':
-      description: Bad Request
-  tags:
-    - Replication
-  description: |-
-    Required Sync Gateway RBAC roles:
-
-    * Sync Gateway Replicator
-  operationId: head_db-_replicationStatus-

docs/api/paths/admin/db-_session.yaml

@@ -72,13 +72,3 @@ post:
   tags:
     - Session
   operationId: post_db-_session
-head:
-  summary: /{db}/_session
-  responses:
-    '200':
-      description: OK
-    '404':
-      $ref: ../../components/responses.yaml#/Not-found
-  tags:
-    - Session
-  operationId: head_db-_session

docs/api/paths/admin/db-_user-.yaml

@@ -59,19 +59,3 @@ post:
   tags:
     - Database Security
   operationId: post_db-_user-
-head:
-  summary: /{db}/_user/
-  responses:
-    '200':
-      description: OK
-    '404':
-      $ref: ../../components/responses.yaml#/Not-found
-  tags:
-    - Database Security
-  description: |-
-    Required Sync Gateway RBAC roles:
-
-    * Sync Gateway Architect
-    * Sync Gateway Application
-    * Sync Gateway Application Read Only
-  operationId: head_db-_user-

docs/api/paths/admin/keyspace-_all_docs.yaml

@@ -77,30 +77,3 @@ post:
   tags:
     - Document
   operationId: post_keyspace-_all_docs
-head:
-  summary: /{db}/_all_docs
-  responses:
-    '200':
-      description: OK
-    '400':
-      $ref: ../../components/responses.yaml#/request-problem
-    '404':
-      $ref: ../../components/responses.yaml#/Not-found
-  tags:
-    - Document
-  parameters:
-    - $ref: ../../components/parameters.yaml#/include_docs
-    - $ref: ../../components/parameters.yaml#/Include-channels
-    - $ref: ../../components/parameters.yaml#/include-access
-    - $ref: ../../components/parameters.yaml#/include-revs
-    - $ref: ../../components/parameters.yaml#/include-seqs
-    - $ref: ../../components/parameters.yaml#/keys
-    - $ref: ../../components/parameters.yaml#/startkey
-    - $ref: ../../components/parameters.yaml#/endkey
-    - $ref: ../../components/parameters.yaml#/limit-result-rows
-  description: |-
-    Required Sync Gateway RBAC roles:
-
-    * Sync Gateway Application
-    * Sync Gateway Application Read Only
-  operationId: head_keyspace-_all_docs

docs/api/paths/admin/keyspace-_changes.yaml

@@ -176,20 +176,3 @@ post:
   tags:
     - Database Management
   operationId: post_keyspace-_changes
-head:
-  summary: /{db}/_changes
-  responses:
-    '200':
-      description: OK
-    '400':
-      description: Bad Request
-    '404':
-      description: Not Found
-  tags:
-    - Database Management
-  description: |-
-    Required Sync Gateway RBAC roles:
-
-    * Sync Gateway Application
-    * Sync Gateway Application Read Only
-  operationId: head_keyspace-_changes

docs/api/paths/admin/keyspace-_raw-docid.yaml

@@ -112,20 +112,3 @@ get:
   tags:
     - Document
   operationId: get_keyspace-_raw-docid
-head:
-  summary: /{keyspace}/_raw/{docid}
-  responses:
-    '200':
-      description: Document exists
-    '400':
-      $ref: ../../components/responses.yaml#/request-problem
-    '404':
-      $ref: ../../components/responses.yaml#/Not-found
-  tags:
-    - Document
-  description: |-
-    Required Sync Gateway RBAC roles:
-
-    * Sync Gateway Application
-    * Sync Gateway Application Read Only
-  operationId: head_keyspace-_raw-docid

docs/api/paths/common/_ping.yaml

@@ -19,12 +19,3 @@ get:
   tags:
     - Server
   operationId: get__ping
-head:
-  responses:
-    '200':
-      description: Server is available
-  tags:
-    - Server
-  summary: Check if API is available
-  description: Returns OK status if API is available.
-  operationId: head__ping

docs/api/paths/public/db-_ensure_full_commit.yaml

@@ -8,7 +8,7 @@
 parameters:
   - $ref: ../../components/parameters.yaml#/db
 post:
-  summary: '/{db}/_ensure_full_commit'
+  summary: Ensure Full Commit
   description: This endpoint is non-functional but is present for CouchDB compatibility.
   responses:
     '201':

docs/api/paths/public/db-_session.yaml

@@ -114,13 +114,3 @@ delete:
   tags:
     - Session
   operationId: delete_db-_session
-head:
-  summary: /{db}/_session
-  responses:
-    '200':
-      description: OK
-    '404':
-      $ref: ../../components/responses.yaml#/Not-found
-  tags:
-    - Session
-  operationId: head_db-_session

docs/api/paths/public/keyspace-_all_docs.yaml

@@ -65,26 +65,3 @@ post:
   tags:
     - Document
   operationId: post_keyspace-_all_docs
-head:
-  summary: /{db}/_all_docs
-  responses:
-    '200':
-      description: OK
-    '400':
-      $ref: ../../components/responses.yaml#/request-problem
-    '404':
-      $ref: ../../components/responses.yaml#/Not-found
-  tags:
-    - Document
-  parameters:
-    - $ref: ../../components/parameters.yaml#/include_docs
-    - $ref: ../../components/parameters.yaml#/Include-channels
-    - $ref: ../../components/parameters.yaml#/include-access
-    - $ref: ../../components/parameters.yaml#/include-revs
-    - $ref: ../../components/parameters.yaml#/include-seqs
-    - $ref: ../../components/parameters.yaml#/keys
-    - $ref: ../../components/parameters.yaml#/startkey
-    - $ref: ../../components/parameters.yaml#/endkey
-    - $ref: ../../components/parameters.yaml#/limit-result-rows
-  description: ''
-  operationId: head_keyspace-_all_docs

docs/api/paths/public/keyspace-_changes.yaml

@@ -156,16 +156,3 @@ post:
   tags:
     - Database Management
   operationId: post_keyspace-_changes
-head:
-  summary: /{db}/_changes
-  responses:
-    '200':
-      description: OK
-    '400':
-      description: Bad Request
-    '404':
-      description: Not Found
-  tags:
-    - Database Management
-  description: ''
-  operationId: head_keyspace-_changes