mirror of
https://github.com/zulip/zulip.git
synced 2025-11-02 13:03:29 +00:00
Improve docs/README.md
(imported from commit 78193958bdb5f92ae5d8706340a739dae0da5367)
This commit is contained in:
@@ -1,3 +1,13 @@
|
||||
These docs are written in rST, and are included on the zulip.org website
|
||||
as well as on each development installation. Many of these docs
|
||||
have been ported from the internal docs of Zulip Inc.,
|
||||
and may need to be updated for use in the open source project.
|
||||
|
||||
To generate HTML docs locally from rST:
|
||||
|
||||
* `pip install sphinx`
|
||||
* In this directory, `make html`. Output appears in a `_build/html` subdirectory.
|
||||
|
||||
To create rST from MediaWiki input:
|
||||
|
||||
* Use `pandoc -r mediawiki -w rst` on MediaWiki source.
|
||||
@@ -11,7 +21,3 @@ We can use pandoc to translate mediawiki into reStructuredText, but some things
|
||||
* Fix wiki links?
|
||||
* Add pages to the table of contents (`index.rst`).
|
||||
|
||||
To generate HTML docs locally from RST:
|
||||
|
||||
* `pip install sphinx`
|
||||
* In this directory, `make html`. Output appears in a `_build/html` subdirectory.
|
||||
|
||||
Reference in New Issue
Block a user