docs: add docs for new schemas

Author: jaredhendrickson13

docs/BUILDING_CUSTOM_ENDPOINT_CLASSES.md

@@ -108,6 +108,11 @@ The `tag` property is used to define the [OpenAPI tag](https://swagger.io/docs/s
 for the endpoint. This is used to group related endpoints together in the API documentation. This property is optional 
 and defaults to the first section of the URL after the `/api/v2/` prefix.
 
+### deprecated
+
+The `deprecated` property is used to indicate if the endpoint is deprecated. This property defaults to `false`. When set
+to `true`, the endpoint will be marked as deprecated in applicable documentation and schemas.
+
 ### requires_auth
 
 The `requires_auth` property is used to specify whether the endpoint requires authentication and authorization. This property

docs/NATIVE_SCHEMA.md

@@ -0,0 +1,39 @@
+# Native Schema
+
+The package's framework also generates a proprietary schema that describes components of the API in more detail than 
+the OpenAPI or GraphQL schemas. This is intended for third-party tools and integrations that need more context about
+the API's structure, behavior and attributes. The native schema is generated by extracting data the codebases PHP class 
+properties directly and use internal metadata that is not normally exposed.
+
+## Accessing the Schema
+
+The native schema can by obtained by making a `GET` request to the `/api/v2/schema/native` endpoint. This endpoint
+does not require authentication and is accessible to all users as it only provides descriptive metadata about the API
+that is already publicly available by referencing the code on GitHub.
+
+## Understanding the Structure
+
+Since the native schema is generated from the codebase itself, the easiest way to understand its contents is to 
+review the properties available to [Endpoint](BUILDING_CUSTOM_ENDPOINT_CLASSES.md#define-__construct-method-properties),
+[Model](BUILDING_CUSTOM_MODEL_CLASSES.md#define-__construct-method-properties) and [Field](BUILDING_CUSTOM_MODEL_CLASSES.md#define-field-objects)
+classes. Below is a basic outline of the schema's structure:
+
+```json
+{
+  "endpoints": {
+    "/endpoint/url/path": {
+      ...
+    }
+  },
+  "models": {
+    "ModelName": {
+      "fields": {
+        "field_name": {
+          ...
+        },
+        ...
+      }
+    }
+  }
+}
+```

mkdocs.yml

@@ -26,6 +26,7 @@ nav:
       - Building Custom Dispatchers: BUILDING_CUSTOM_DISPATCHER_CLASSES.md
       - Building Custom Caches: BUILDING_CUSTOM_CACHE_CLASSES.md
       - Building Custom Content Handlers: BUILDING_CUSTOM_CONTENT_HANDLER_CLASSES.md
+      - Native Schema: NATIVE_SCHEMA.md
       - PHP Reference: https://pfrest.org/php-docs/
 theme:
   name: readthedocs