Add organizations docs

add-build-signals
Eric Holscher 2014-11-05 12:48:49 -08:00
parent ba89d70f88
commit 85b2b05295
2 changed files with 39 additions and 7 deletions

View File

@ -1,16 +1,12 @@
Read the Docs, For Business
===========================
Read the Docs Business Features
-------------------------------
These features are for our new business offering, `readthedocs.com <https://readthedocs.com/>`_.
All of the other features outlined in these docs work on both sites.
Things inside this section are specific to our business offering.
Contents
--------
.. toctree:: Contents
sharing
organizations

View File

@ -0,0 +1,36 @@
Organizations
-------------
Organizations allow you to segment who has access to what projects in your company.
Your company will be represented as an Organization,
let's use ACME Corporation as our example.
ACME has a few people inside their organization,
some who need full access and some who just need access to one project.
Member Types
~~~~~~~~~~~~
* Owners -- Get full access to both view and edit the Organization and all Projects
* Members -- Get access to a subset of the Organization projects
* Teams -- Where you give members access to a set of projects.
The best way to think about this relationship is:
*Owners* will create *Teams* to assign permissions to all *Members*.
Example
~~~~~~~
ACME would set up *Owners* of their organization,
for example Frank Roadrunner would be an owner.
He has full access to the organization and all projects.
Wile E. Coyote is a contractor,
and will just have access to the new project Road Builder.
Roadrunner would set up a *Team* called *Contractors*.
That team would have *Read Only* access to the *Road Builder* project.
Then he would add *Wile E. Coyote* to the team.
This would give him access to just this one project inside the organization.