Docs: Relabel Organizations as Explanation (Diátaxis)

docs/user/commercial/organizations.rst

@@ -3,13 +3,19 @@ Organizations
 
 .. include:: /shared/admonition-rtd-business.rst
 
-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.
+In this article, we explain how the *organization* feature on Read the Docs allows you to manage access to your projects.
+On Read the Docs for Business, your account is linked to an *organization*, whereby you can define both individual and common read and write access to your projects or collections of projects.
+
+In this article, we use ACME Corporation as our example organization.
 
 ACME has a few people inside their organization,
 some who need full access and some who just need access to one project.
 
+.. seealso::
+
+   :doc:`/guides/manage-read-the-docs-teams`
+     A step-by-step guide to managing teams.
+
 Member Types
 ~~~~~~~~~~~~
 

docs/user/guides/manage-read-the-docs-teams.rst

@@ -1,6 +1,8 @@
 How to manage Read the Docs teams
 =================================
 
+.. include:: /shared/admonition-rtd-business.rst
+
 Read the Docs uses teams within an organization to group users and provide permissions to projects.
 This guide will cover how to do team management,
 including adding and removing people from teams.
@@ -38,4 +40,7 @@ Automating this process
 
 You can manage teams more easily using our :doc:`Single Sign-On </commercial/single-sign-on>` features.
 
-.. seealso:: Our infomation on :doc:`/commercial/organizations`.
+.. seealso::
+
+   :doc:`/commercial/organizations`
+     General information about the *organization* feature.

docs/user/index.rst

@@ -82,6 +82,7 @@ to help you create fantastic documentation for your project.
    /custom-domains
    /pull-requests
    /downloadable-documentation
+   /commercial/organizations
 
 .. toctree::
    :maxdepth: 2