Clarify graph collection removal, add missing collection/View response descriptions, improve OpenAPI rendering (#467)

* Clarify graph collection removal

* WIP Add missing response descriptions

* Improve OpenAPI rendering

* Show default value
* Fix logic for determining whether a (sub-)property is required/always present
* Render description with page context to generate proper internal links
* Handle the corner case of top-level type array without items attribute

* Log first 4 lines of OpenAPI block in case of YAML unmarshalling error for context

* Substitute relative links with absolute URLs for OpenAPI JSON / Swagger UI

* Don't render anchor/fragment identifier of polymorphic endpoints

* Convert default values to JSON for properties (but not parameters), use proper attribute for params

* Display descriptive HTTP status next to the code

* Render possible enum values at end of description

* Add missing and improve existing request and response descriptions for collections, Views, named graphs

* Add link from jobs API to HTTP request handling

* Documenting default values for responses doesn't make much sense

Author: Simran-B

site/content/3.10/develop/http-api/graphs/named-graphs.md

@@ -1817,7 +1817,7 @@ paths:
           in: query
           required: false
           description: |
-            Drop the collection as well.
+            Drop the collection in addition to removing it from the graph.
             The collection is only dropped if it is not used in other graphs.
           schema:
             type: boolean
@@ -2803,7 +2803,7 @@ paths:
           in: query
           required: false
           description: |
-            Drop the collection as well.
+            Drop the edge collection in addition to removing it from the graph.
             The collection is only dropped if it is not used in other graphs.
           schema:
             type: boolean
@@ -3261,7 +3261,7 @@ paths:
           in: query
           required: false
           description: |
-            Drop the collection as well.
+            Drop the edge collection in addition to removing it from the graph.
             The collection is only dropped if it is not used in other graphs.
           schema:
             type: boolean

site/content/3.11/develop/http-api/graphs/named-graphs.md

@@ -1817,7 +1817,7 @@ paths:
           in: query
           required: false
           description: |
-            Drop the collection as well.
+            Drop the collection in addition to removing it from the graph.
             The collection is only dropped if it is not used in other graphs.
           schema:
             type: boolean
@@ -2803,7 +2803,7 @@ paths:
           in: query
           required: false
           description: |
-            Drop the collection as well.
+            Drop the edge collection in addition to removing it from the graph.
             The collection is only dropped if it is not used in other graphs.
           schema:
             type: boolean
@@ -3261,7 +3261,7 @@ paths:
           in: query
           required: false
           description: |
-            Drop the collection as well.
+            Drop the edge collection in addition to removing it from the graph.
             The collection is only dropped if it is not used in other graphs.
           schema:
             type: boolean