Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
zulip/docs/production/index.rst

28 lines
483 B
ReStructuredText
Raw Normal View History

docs: Reorganize developer docs to improve navigation. This commit helps reduce clutter on the navigation sidebar. Creates new directories and moves relevant files into them. Modifies index.rst, symlinks, and image paths accordingly. This commit also enables expandable/collapsible navigation items, renames files in docs/development and docs/production, modifies /tools/test-documentation so that it overrides a theme setting, Also updates links to other docs, file paths in the codebase that point to developer documents, and files that should be excluded from lint tests. Note that this commit does not update direct links to zulip.readthedocs.io in the codebase; those will be resolved in an upcoming follow-up commit (it'll be easier to verify all the links once this is merged and ReadTheDocs is updated). Fixes #5265.
2017-11-08 17:55:36 +01:00
###################
Zulip in Production
###################
.. toctree::
:maxdepth: 3
Production overview <overview>
requirements
Installing a production server <install>
troubleshooting
customize
mobile-push-notifications
maintain-secure-upgrade
security-model
authentication-methods
postgres
docs: Update TOC in production to include SSL and email. This adds a few missing entries to the TOC, which hadn't made sense back when Zulip's ReadTheDocs didn't have the new collapsing feature. Tweaked by tabbott to also give the SSL certificates doc an appropriate title for its new role.
2017-11-18 12:56:32 +01:00
ssl-certificates
email
docs: Exclude files from TOC warnings and navigation sidebar. Sphinx was displaying "WARNING: document isn't included in any toctree" for files we just don't want in the TOC. We can hide them from the index, but the rtd theme defaults to display hidden index entries in the nav bar. This commit excludes these files from such warnings, and patches layout.html so that hidden index entries stay hidden from the navigation sidebar. This commit also moves password-strength.md under docs/production and adds it as a hidden entry in production/index.rst. Fixes #7417.
2017-11-21 18:38:06 +01:00
.. toctree::
:hidden:
expensive-migrations
install-existing-server
multiple-organizations
password-strength