mirror of
https://github.com/tahoe-lafs/tahoe-lafs.git
synced 2024-12-22 22:32:23 +00:00
| .. | ||
| _static | ||
| _templates | ||
| build | ||
| frontends | ||
| historical | ||
| Installation | ||
| man/man1 | ||
| proposed | ||
| specifications | ||
| about-tahoe.rst | ||
| accepting-donations.rst | ||
| anonymity-configuration.rst | ||
| architecture.rst | ||
| aspiration-contract.txt | ||
| backdoors.rst | ||
| backupdb.rst | ||
| cautions.rst | ||
| check_running.py | ||
| CODE_OF_CONDUCT.md | ||
| conf.py | ||
| configuration.rst | ||
| contributing.rst | ||
| convergence-secret.rst | ||
| debian.rst | ||
| developer-guide.rst | ||
| developer-release-signatures | ||
| donations.rst | ||
| expenses.rst | ||
| filesystem-notes.rst | ||
| garbage-collection.rst | ||
| gpg-setup.rst | ||
| helper.rst | ||
| index.rst | ||
| key-value-store.rst | ||
| known_issues.rst | ||
| lease-tradeoffs.svg | ||
| logging.rst | ||
| magic-wormhole-invites.rst | ||
| Makefile | ||
| Makefile-old | ||
| network-and-reliance-topology.svg | ||
| nodekeys.rst | ||
| performance.rst | ||
| README.txt | ||
| release-checklist.rst | ||
| requirements.txt | ||
| running.rst | ||
| servers.rst | ||
| stats.rst | ||
| subtree1.svg | ||
| ticket-triage.rst | ||
| write_coordination.rst | ||
If you are reading Tahoe-LAFS documentation ------------------------------------------- If you are reading Tahoe-LAFS documentation at a code hosting site or from a checked-out source tree, the preferred place to view the docs is http://tahoe-lafs.readthedocs.io/en/latest/. Code-hosting sites do not render cross-document links or images correctly. If you are writing Tahoe-LAFS documentation ------------------------------------------- To edit Tahoe-LAFS docs, you will need a checked-out source tree. You can edit the `.rst` files in this directory using a text editor, and then generate HTML output using Sphinx, a program that can produce its output in HTML and other formats. Files with `.rst` extension use reStructuredText markup format, which is the format Sphinx natively handles. To learn more about Sphinx, and for a friendly primer on reStructuredText, please see Sphinx project's documentation, available at: https://www.sphinx-doc.org/ If you have `tox` installed, you can run `tox -e docs` and then open the resulting docs/_build/html/index.html in your web browser. Note that Sphinx can also process Python docstrings to generate API documentation. Tahoe-LAFS currently does not use Sphinx for this purpose.