6 Commits

Author	SHA1	Message	Date
David Rosa	0d52d24d64	docs: pip upgrade recommonmark and CommonMark ... Summary: - recommonmark: 0.4.0 -> 0.5.0 - CommonMark: 0.5.4 -> 0.9.0 - Fixed links getting their .md file extension cut off - Supressed 262 new warnings Details: Appended #anchors to markdown github links as a workaround to recommonmark 0.5.0 cutting off the ".md" part from them. Sphinx build would fail as follows [documentation_crawler] ERROR: Please check link: <404 https://github.com/zulip/zulipbot/blob/master/.github/CONTRIBUTING> <404 https://github.com/zulip/zulip/blob/master/requirements/README> <404 https://github.com/zulip/python-zulip-api/blob/master/zulip_bots/README> sphinx build would also log a "WARNING: None:any reference target not found" for every link ending in .html So a good temporary solution is to suppress all warnings with the method suggested here: https://stackoverflow.com/questions/37359407/suppress-warnings-for-unfound-references-with-default-role-any-in-sphinx A better solution would be to edit all links ending .html and use .md instead; which would also solve PR #11719. Fixes #11395.	2019-08-15 22:41:40 -07:00
Anders Kaseorg	c6da0d13cd	docs: Update links to skip help.github.com redirects. ... help.github.com seems to have a bug where HEAD on a redirected page returns 404. This causes tools/test-documentation to fail. Fix it by skipping the redirects. Signed-off-by: Anders Kaseorg <andersk@mit.edu>	2019-02-26 11:03:08 -08:00
Jack Zhang	58e28fbd21	developer docs: Refer to 'zulipbot add' instead of 'zulipbot label'. ... These changes are consistent with naming in zulip/zulipbot. See: - https://github.com/zulip/zulipbot/commit/e29e7eb - https://github.com/zulip/zulipbot/wiki/Commands#username-add-label-name	2018-09-21 12:16:39 -07:00
Shivam Gera	baffcf0948	Fix: broken link zulip/zulipbot	2018-03-05 10:51:56 -08:00
Tim Abbott	46ba76e245	Fix broken link to GitHub CONTRIBUTING guide.	2017-11-19 20:31:27 -08:00
David Rosa Tamsen	7072fa5b37	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-16 09:45:08 -08:00