zulip/docs
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
..
_static readthedocs: Add proper backlink to the Zulip homepage. 2021-07-06 10:59:59 -07:00
_templates docs: Follow Sphinx 4 rename of master_doc to root_doc. 2021-08-31 14:24:16 -07:00
contributing contributor docs: Link to GitHub's blog post on commit discipline. 2023-01-05 16:09:43 -08:00
development docs: Clarify opening of direct installation section. 2022-11-22 15:54:09 -08:00
documentation api-tests: Reduce error output for `/register` openapi validation. 2023-01-17 14:50:42 -08:00
git contributor docs: Rename "Version Control" to "Commit Discipline". 2022-12-07 10:19:07 -08:00
images contributor docs: Add section on machine translation in Transifex. 2023-01-04 11:01:48 -08:00
outreach docs: Add communication guidance to mentor guide. 2023-01-06 11:05:51 -08:00
overview changelog: Add entry for S3 nginx proxying. 2023-01-10 15:30:57 -08:00
production uploads: Serve S3 uploads directly from nginx. 2023-01-09 18:23:58 -05:00
subsystems Fix typos caught by typos. 2023-01-03 11:09:50 -08:00
testing Fix typos caught by typos. 2023-01-03 11:09:50 -08:00
translating contributor docs: Add section on machine translation in Transifex. 2023-01-04 11:01:48 -08:00
tutorials api-tests: Reduce error output for `/register` openapi validation. 2023-01-17 14:50:42 -08:00
.gitignore
Makefile Revert "docs: Temporarily disable parallel building." 2022-02-28 16:28:31 -08:00
README.md docs: Capitalize Markdown consistently. 2020-08-11 10:23:06 -07:00
THIRDPARTY icons: Change mute icon from bell to speaker. 2022-09-09 17:32:19 -07:00
code-of-conduct.md
conf.py docs: Convert .html#fragment links to .md#fragment. 2022-02-28 16:28:31 -08:00
index.md docs: Reorganize contribution documentation. 2022-09-21 21:55:36 -07:00
requirements.readthedocs.txt requirements: Rename requirements files. 2017-11-21 02:38:26 +05:30

README.md

Zulip Markdown documentation hosted elsewhere

The Markdown files in this directory ( /zulip/docs ) are not intended to be read on GitHub. Instead, visit our ReadTheDocs to read the Zulip documentation.