feat(api): troubleshooting tests for publishing

Author: isabellaenriquez

develop-docs/backend/api/public.mdx

@@ -423,6 +423,23 @@ and add the `Component: API` label.
 The team responsible for the endpoint will review the stability of the endpoint. If the endpoint
 will not have breaking changes in future, they can determine whether to make it public.
 
+### Test Troubleshooting
+*Problem*: `TypeError: Cannot read properties of null (reading 'type')`
+If you have a `ChoiceField` that can be null, make sure you're using the right option. `allow_blank` should be used for textual choices, while `allow_null` should be used for numeric and other non-textual choices.
+
+*Problem*: `must have required property '<property>'`
+Your example response is missing one of the required properties specified by the response class. The property should either be made optional or you should add it to the example.
+
+*Problem*: `must NOT have additional properties`
+Your example response includes a property not included in the response class. This either needs to be added to the response class or removed from the example. s
+
+*Problem*: `must be <type>`
+The type of the value for a property in your example response does not match the type for the property specified by the response class. The example value or the type of the property in the response class should be fixed.
+
+*Problem*: `sentry.apidocs.utils.SentryApiBuildError: projects is not defined by OPENAPI_TAGS in src/sentry/apidocs/build.py for <endpoint title>`
+You need to add the endpoint to a section of the API docs with the `@extend_schema(tags=['<section title>'])`. Section tags live at [`src/sentry/apidocs/build.py`](https://github.com/getsentry/sentry/blob/isabella/proj-env-details/src/sentry/apidocs/build.py).
+
+
 ### FAQs
 
 **When should an attribute be `required`?**