Merge pull-request #189

Author: andrewkmin

docs/documentation/concepts/organizations.md

@@ -14,7 +14,7 @@ All organizations are controlled by a [Root Quorum](/concepts/users/root-quorum)
 
 ## Features
 
-Organizations can opt-in or opt-out of the following features:
+Organization features are Turnkey product offerings that organizations can opt-in to or opt-out of. Note that these features can be set and updated using the activities `ACTIVITY_TYPE_SET_ORGANIZATION_FEATURE` and `ACTIVITY_TYPE_REMOVE_ORGANIZATION_FEATURE`. The following is a list of such features:
 
 | Name                          | Description                                   | Default  | Notes                                                                                                                                                                                                                                                                              |
 | ----------------------------- | --------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

docs/documentation/concepts/policy-management/Policy-language.md

@@ -113,7 +113,7 @@ The language is strongly typed which makes policies easy to author and maintain.
 
 | Resource Type    | Action | Activity Type                             |
 | ---------------- | ------ | :---------------------------------------- |
-| **ORGANIZATION** | CREATE | ACTIVITY_TYPE_CREATE_SUB_ORGANIZATION_V5  |
+| **ORGANIZATION** | CREATE | ACTIVITY_TYPE_CREATE_SUB_ORGANIZATION_V7  |
 |                  | UPDATE | ACTIVITY_TYPE_UPDATE_ROOT_QUORUM          |
 |                  | UPDATE | ACTIVITY_TYPE_SET_ORGANIZATION_FEATURE    |
 |                  | REMOVE | ACTIVITY_TYPE_REMOVE_ORGANIZATION_FEATURE |
@@ -164,6 +164,10 @@ The language is strongly typed which makes policies easy to author and maintain.
 
 ## Appendix
 
+### Root quorum activities
+
+There are a select few activities that are not governed by policies, but rather by an organization's [root quorum](../../concepts/user-management/Root-quorum.md). These activities are: `ACTIVITY_TYPE_UPDATE_ROOT_QUORUM`, `ACTIVITY_TYPE_SET_ORGANIZATION_FEATURE`, `ACTIVITY_TYPE_REMOVE_ORGANIZATION_FEATURE`. For example, if a policy is added that allows a specific non-root user to perform `ACTIVITY_TYPE_SET_ORGANIZATION_FEATURE` activities, these requests will still fail as they are subject specifically to root quorum.
+
 ### Ethereum
 
 Our Ethereum policy language (accessible via `eth.tx`) allows for the granular governance of signing Ethereum (EVM-compatible) transactions. Our policy engine exposes a [fairly standard set of properties](https://ethereum.org/en/developers/docs/transactions/#typed-transaction-envelope) belonging to a transaction.