zulip/docs/documentation
Lauryn Menard c2bcfb52aa api-tests: Reduce error output for `/register` openapi validation.
For descriptive endpoints, such as `/register`, that might raise
Schema Validation errors via `validate_against_openapi_schema`,
omits the OpenAPI schema definition in the error output.

Also omits the error instance definition in the error output
when it is a jsonschema object with over 100 properties. This
means that the test instance for objects, like user settings,
will be printed in the error output, but the test instance for
the entire endpoint will not be printed to the console.

The omitted output can be thousands of lines long making it
difficult to find the initial console output that actually helps
the contributor with debugging.

Adds a section in "Documenting REST API endpoints" about
debugging and understanding these errors that is linked to
in the error console output.
2023-01-17 14:50:42 -08:00
..
api.md api-tests: Reduce error output for `/register` openapi validation. 2023-01-17 14:50:42 -08:00
helpcenter.md contributor docs: Add formatting instructions for streams and topics. 2022-12-02 18:00:12 -08:00
index.md docs: Rename `user.md` to `helpcenter.md`. 2022-01-25 18:42:04 -08:00
integrations.md integrations-docs: Move markdown macros include files. 2022-12-08 12:58:11 -08:00
openapi.md docs: Correct path to zulip.yaml. 2022-07-20 09:37:57 -07:00
overview.md docs: Convert .html#fragment links to .md#fragment. 2022-02-28 16:28:31 -08:00