tahoe-lafs/tahoe-lafs
tahoe-lafs
/
tahoe-lafs
2
0
Fork 0
Code Issues Pull Requests 23 Packages Projects Releases 1 Wiki Activity

doc: about.rst: use unicode emdash, use non-embedded URIs, add clarificaiton of when a file gets its mutable-or-immutable nature 

embedded URIs, although documented here:
http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#embedded-uris
generate messages like this from rst2html --verbose:

quickstart.rst:3: (INFO/1) Duplicate explicit target name: "the tahoe-dev mailing list".

Also this patch prepends a "utf-8 BOM" to the beginning of the file.
This commit is contained in:
Zooko O'Whielacronx 2011-12-06 17:19:08 +00:00
parent 37c0f2395d
commit 4a29642623
1 changed files with 31 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
docs/about.rst
View File

@ -1,9 +1,11 @@
====================== ======================
Welcome to Tahoe-LAFS! Welcome to Tahoe-LAFS!
====================== ======================
Welcome to `Tahoe-LAFS <https://tahoe-lafs.org>`_, the first decentralized Welcome to Tahoe-LAFS_, the first decentralized storage system with
storage system with *provider-independent security*. *provider-independent security*.
.. _Tahoe-LAFS: https://tahoe-lafs.org
What is "provider-independent security"? What is "provider-independent security"?
======================================== ========================================
@ -22,18 +24,18 @@ these service providers spend considerable effort and expense trying to
mitigate these risks. mitigate these risks.
What we mean by "security" is something different. *The service provider What we mean by "security" is something different. *The service provider
never has the ability to read or modify your data in the first place -- never has the ability to read or modify your data in the first place—never.*
never.* If you use Tahoe-LAFS, then all of the threats described above are If you use Tahoe-LAFS, then all of the threats described above are non-issues
non-issues to you. Not only is it easy and inexpensive for the service to you. Not only is it easy and inexpensive for the service provider to
provider to maintain the security of your data, but in fact they couldn't maintain the security of your data, but in fact they couldn't violate its
violate its security if they tried. This is what we call security if they tried. This is what we call *provider-independent
*provider-independent security*. security*.
This guarantee is integrated naturally into the Tahoe-LAFS storage system and This guarantee is integrated naturally into the Tahoe-LAFS storage system and
doesn't require you to perform a manual pre-encryption step or cumbersome key doesn't require you to perform a manual pre-encryption step or cumbersome key
management. (After all, having to do cumbersome manual operations when management. (After all, having to do cumbersome manual operations when
storing or accessing your data would nullify one of the primary benefits of storing or accessing your data would nullify one of the primary benefits of
using cloud storage in the first place -- convenience.) using cloud storage in the first place—convenience.)
Here's how it works: Here's how it works:
@ -70,11 +72,12 @@ software installed, such as an Internet kiosk or cell phone.
Access Control Access Control
============== ==============
There are two kinds of files: immutable and mutable. Immutable files have There are two kinds of files: immutable and mutable. When you upload a file
the property that once they have been uploaded to the storage grid they can't to the storage grid you can choose which kind of file it will be in the
be modified. Mutable ones can be modified. A user can have read-write grid. Immutable files can't be modified once they have been uploaded. A
access to a mutable file or read-only access to it (or no access to it at mutable file can be modified by someone with read-write access to it. A user
all). can have read-write access to a mutable file or read-only access to it, or no
access to it at all.
A user who has read-write access to a mutable file or directory can give A user who has read-write access to a mutable file or directory can give
another user read-write access to that file or directory, or they can give another user read-write access to that file or directory, or they can give
@ -89,29 +92,34 @@ directory can gain read-only access to the child. If you use a read-only
link, then anyone who has either read-write or read-only access to the parent link, then anyone who has either read-write or read-only access to the parent
directory can gain read-only access to the child. directory can gain read-only access to the child.
For more technical detail, please see the `the doc page For more technical detail, please see the `the doc page`_ on the Wiki.
<https://tahoe-lafs.org/trac/tahoe-lafs/wiki/Doc>`_ on the Wiki.
.. _the doc page: https://tahoe-lafs.org/trac/tahoe-lafs/wiki/Doc
Get Started Get Started
=========== ===========
To use Tahoe-LAFS, please see `quickstart.rst <quickstart.rst>`_. To use Tahoe-LAFS, please see quickstart.rst_.
.. _quickstart.rst: quickstart.rst
License License
======= =======
You may use this package under the GNU General Public License, version 2 or, You may use this package under the GNU General Public License, version 2 or,
at your option, any later version. See the file `COPYING.GPL at your option, any later version. See the file COPYING.GPL_ for the terms
<../COPYING.GPL>`_ for the terms of the GNU General Public License, version of the GNU General Public License, version 2.
2.
You may use this package under the Transitive Grace Period Public Licence, You may use this package under the Transitive Grace Period Public Licence,
version 1 or, at your option, any later version. The Transitive Grace Period version 1 or, at your option, any later version. The Transitive Grace Period
Public Licence has requirements similar to the GPL except that it allows you Public Licence has requirements similar to the GPL except that it allows you
to wait for up to twelve months after you redistribute a derived work before to wait for up to twelve months after you redistribute a derived work before
releasing the source code of your derived work. See the file `COPYING.TGGPL releasing the source code of your derived work. See the file
<../COPYING.TGPPL.rst>`_ for the terms of the Transitive Grace Period Public COPYING.TGPPL.rst_ for the terms of the Transitive Grace Period Public
Licence, version 1. Licence, version 1.
(You may choose to use this package under the terms of either licence, at (You may choose to use this package under the terms of either licence, at
your option.) your option.)
.. _COPYING.GPL: ../COPYING.GPL
.. _COPYING.TGPPL.rst: ../COPYING.TGPPL.rst