3636 Rearrange Tahoe-LAFS manual main page

docs/index.rst

@@ -5,66 +5,85 @@ Tahoe-LAFS
 .. Please view a nicely formatted version of this documentation at
    http://tahoe-lafs.readthedocs.io/en/latest/
 
-Contents:
+Tahoe-LAFS is a Free and Open decentralized storage system.
+It distributes your data across multiple servers.
+Even if some of the servers fail or are taken over by an attacker,
+the entire file store continues to function correctly,
+preserving your privacy and security.
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
+   :caption: Preliminaries
 
    about
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Using Tahoe-LAFS
+
    INSTALL
    running
-   magic-wormhole-invites
    configuration
-   architecture
-
+   servers
    frontends/CLI
-   frontends/webapi
    frontends/FTP-and-SFTP
    frontends/download-status
-
+   magic-wormhole-invites
+   anonymity-configuration
    known_issues
-   contributing
-   CODE_OF_CONDUCT
-   release-checklist
 
-   servers
+.. toctree::
+   :maxdepth: 1
+   :caption: Technical Notes
+
+   architecture
    helper
    convergence-secret
    garbage-collection
-
-   backdoors
-   donations
-   accepting-donations
-   expenses
-   cautions
+   filesystem-notes
+   key-value-store
+   frontends/webapi
    write_coordination
+   cautions
    backupdb
-
-   developer-guide
-   ticket-triage
-
-   anonymity-configuration
-
    nodekeys
    performance
    logging
    stats
 
-   desert-island
-   debian
-   windows
-   OS-X
-   build/build-pyOpenSSL
+.. toctree::
+   :maxdepth: 1
+   :caption: Specifications
 
    specifications/index
    proposed/index
-   filesystem-notes
-   historical/configuration
-   key-value-store
 
-Indices and tables
-==================
+.. toctree::
+   :maxdepth: 1
+   :caption: Contributing to Tahoe-LAFS
+
+   contributing
+   CODE_OF_CONDUCT
+   developer-guide
+   ticket-triage
+   release-checklist
+   desert-island
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Notes of Community Interest
+
+   backdoors
+   donations
+   accepting-donations
+   expenses
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Notes of Historical Interest
 
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+   historical/configuration
+   debian
+   windows
+   OS-X
+   build/build-pyOpenSSL

newsfragments/3636.documentation

@@ -0,0 +1 @@
+Tahoe-LAFS manual's table of contents page has been reorganized.