tahoe-lafs/docs
2021-11-10 14:42:56 -05:00
..
_static New image with stroking 2021-05-27 14:51:30 +02:00
_templates docs: add .empty to preserve empty _static and _templates 2016-03-30 01:26:47 -07:00
build Update title of OpenSSL and pyOpenSSL build instructions. 2015-05-01 22:07:27 +01:00
frontends Make --exclude-from behavior consistent, at the cost of a minor incompatibility. 2021-05-28 09:53:28 -04:00
historical Update references to the mailing list 2021-08-31 09:58:43 -04:00
Installation Update references to the mailing list 2021-08-31 09:58:43 -04:00
man/man1 Update references to the mailing list 2021-08-31 09:58:43 -04:00
proposed More consistent header system. 2021-11-10 14:42:22 -05:00
specifications link to the reference implementation 2021-09-07 13:37:12 -04:00
about-tahoe.rst Installation Guide Revamp 2021-07-16 12:14:45 +05:30
accepting-donations.rst encourage use of variables and copy/paste of command 2018-07-17 13:14:36 -04:00
anonymity-configuration.rst Use "tahoe run" 2020-12-09 10:50:03 -05:00
architecture.rst docs: Fix small typo (f -> of) in architecture.rst 2020-01-04 13:44:24 +01:00
aspiration-contract.txt docs: describe BTC/development agreement with Aspiration 2018-12-28 11:32:50 -06:00
backdoors.rst Sign backdoor statement 2020-02-10 16:53:35 -05:00
backupdb.rst magic first line tells emacs to use utf8+bom 2013-11-08 21:08:05 +00:00
cautions.rst format docs for Sphinx 2016-03-30 01:26:47 -07:00
CODE_OF_CONDUCT.md Add May-Lee 2021-03-25 17:56:59 +01:00
conf.py Use sphinx_rtd_theme when building docs locally 2021-03-09 15:42:48 -05:00
configuration.rst Rip out FTP. 2021-01-06 13:39:52 -05:00
contributing.rst Include contribution guidelines for real 2021-01-08 13:38:07 -05:00
convergence-secret.rst docs: add sphinx index.rst, improve headers 2016-03-29 21:46:11 -07:00
debian.rst revert whitespace 2019-06-22 23:39:21 -06:00
developer-guide.rst Update developer docs wrt pre-commit 2020-12-01 09:55:17 -05:00
developer-release-signatures actually sign statement 2021-01-19 12:58:35 -07:00
donations.rst docs: describe BTC/development agreement with Aspiration 2018-12-28 11:32:50 -06:00
expenses.rst docs: clean up .rst and references 2016-12-12 13:57:28 -08:00
filesystem-notes.rst update link to Maildir tips (thanks MK_FG) 2013-11-12 16:37:02 +00:00
garbage-collection.rst LAFS now stands for "Least-Authority File Store" rather than "Least-Authority File System". refs #2345 2017-06-06 11:20:49 +01:00
helper.rst Rip out FTP. 2021-01-06 13:39:52 -05:00
index.rst Installation Guide Revamp 2021-07-16 12:14:45 +05:30
key-value-store.rst docs: clean up .rst and references 2016-12-12 13:57:28 -08:00
known_issues.rst Rip out FTP. 2021-01-06 13:39:52 -05:00
lease-tradeoffs.svg Fixes the overlapping text in docs/lease-tradeoffs.svg 2013-08-07 13:12:59 -04:00
logging.rst "tahoe start" doesn't even work on these but "twistd -ny" does 2020-12-09 10:50:03 -05:00
magic-wormhole-invites.rst Remove the obvious documentation references 2020-02-13 10:23:27 -05:00
Makefile Add a make rule to invoke sphinx-autobuild when building docs 2021-04-02 17:27:32 -04:00
Makefile-old docs: run sphinx-quickstart, move old Makefile 2016-03-29 21:02:14 -07:00
network-and-reliance-topology.svg Update docs/network-and-reliance-topology.svg for RAIC, and to be more accurate about frontend protocols. 2012-11-03 00:15:32 +00:00
nodekeys.rst magic first line tells emacs to use utf8+bom 2013-11-08 21:08:05 +00:00
performance.rst magic first line tells emacs to use utf8+bom 2013-11-08 21:08:05 +00:00
README.txt Drop the note about running make html in docs 2021-03-23 10:52:51 -04:00
release-checklist.rst release two things: wheels, and a .tar.gz source dist 2021-10-20 16:10:23 -06:00
requirements.txt Tell RTD how to install Sphinx. 2021-10-28 11:12:17 -04:00
running.rst Update references to the mailing list 2021-08-31 09:58:43 -04:00
servers.rst implement --listen=none, use it for create-client 2016-09-14 16:12:32 -07:00
stats.rst load_monitor is also gone 2020-12-10 18:22:45 -05:00
subtree1.svg docs/subtree1.svg: make the page smaller 2007-11-13 13:54:51 -07:00
ticket-triage.rst Add newsfragment description and edit details 2021-04-13 16:01:50 +02:00
write_coordination.rst LAFS now stands for "Least-Authority File Store" rather than "Least-Authority File System". refs #2345 2017-06-06 11:20:49 +01:00

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.