diff --git a/docs/source/index.rst b/docs/source/index.rst
index eb80b4eca..3869c9a0e 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -30,6 +30,7 @@
    command-line-interface
    importers_link
    PIPELINES-AVID
+   advisory-schema
 
 .. toctree::
    :hidden:
diff --git a/docs/source/schemas/vulnerablecode-advisory.schema-0.1.json b/docs/source/schemas/vulnerablecode-advisory.schema-0.1.json
index cdd9f5508..8c26c663a 100644
--- a/docs/source/schemas/vulnerablecode-advisory.schema-0.1.json
+++ b/docs/source/schemas/vulnerablecode-advisory.schema-0.1.json
@@ -57,13 +57,13 @@
       "required": [
         "package"
       ],
-      "title": "AffectedPackageV2",
+      "title": "Affected Package",
       "type": "object"
     },
     "PackageCommitPatchData": {
       "properties": {
         "vcs_url": {
-          "title": "VCS URL",
+          "title": "Version Control Systems URL",
           "type": "string"
         },
         "commit_hash": {
@@ -75,7 +75,7 @@
         "vcs_url",
         "commit_hash"
       ],
-      "title": "PackageCommitPatchData",
+      "title": "Package Commit Patch",
       "type": "object"
     },
     "ReferenceV2": {
@@ -96,13 +96,13 @@
           "type": "string"
         }
       },
-      "title": "ReferenceV2",
+      "title": "Reference",
       "type": "object"
     },
     "VulnerabilitySeverity": {
       "properties": {
         "scoring_system": {
-          "title": "System",
+          "title": "Scoring System",
           "type": "string"
         },
         "score": {
@@ -137,10 +137,10 @@
             }
           ],
           "default": null,
-          "title": "Url"
+          "title": "Severity URL"
         }
       },
-      "title": "VulnerabilitySeverity",
+      "title": "Vulnerability Severity",
       "type": "object"
     }
   },