Merge pull request #3478 from travis-ci/DU-40/Shared_Plans

Du 40/shared plans

Author: nrios14

_includes/sidebar.html

@@ -129,6 +129,7 @@ <h3>Hosted Billing</h3>
       <ul>
         <li class="is-overview"><a href="/user/billing-overview/">Overview</a></li>
         <li><a href="/user/billing-autorefill/">Auto-refill</a></li>
+        <li><a href="/user/plan-sharing/">Plan Sharing</a></li>
         <li><a href="/user/billing-faq/">FAQ</a></li>
       </ul>
 

user/images/plan-sharing-sample.png

@@ -0,0 +1,81 @@
+---
+title: Plan Sharing Guide
+layout: en
+
+---
+
+Assembla’s billing model allows customers to pay once for an entire portfolio of projects and allocate the allowance across the projects. Travis CI modified the billing model to map Assembla’s spaces to Travis CI organizations and fulfill customer needs.  
+
+Travis CI introduces a flexible new feature that allows users to share paid plans across Assembla’s spaces. This innovation introduces two new roles to Travis CI plans: the Donor and the Receiver, providing users with more control over their resources. 
+
+> Note: The `Share Plan` feature is only available to Travis CI accounts (user or organization) with a current valid paid plan and linked to Assembla Spaces. 
+
+## Donor and Receiver 
+Travis CI users with paid plans can enable the `Share Plan` feature and decide to share their plan with the available Spaces.
+
+A Travis account (user or organization) that enables the `Share Plan` feature is referenced as the ***Donor*** account. 
+
+A ***Donor*** account consists of a Travis CI user or organization willingly sharing a Travis CI plan allowance with other Travis CI users or organizations. 
+
+A Travis account (user or organization) that benefits from the `Share Plan` feature is referenced as the ***Receiver*** account. 
+
+A ***Receiver*** account is a Travis CI user or organization that benefits from accessing a Travis CI Shared plan by a Donor account. 
+ 
+## How does a Shared Plan work?
+Only Travis CI paid plans are available for sharing with another Travis CI organization.
+
+All Receiver accounts may trigger builds within the allowances of the original plan (the Donor's account plan). This means that the system tracks all metrics under the original plan, but there are now multiple sources for these metrics.
+
+### Concurrency-based Plans
+Concurrency-based plans are available to all Travis CI accounts that use the Shared Plan, including Donor and Receiver accounts. When sharing a concurrency-based plan, the number of jobs is shared between all accounts. For example, if Donor account ***A*** decides to share a plan with 20 concurrent jobs with Receiver accounts ***B*** and ***C***. This means that all three accounts have a total of 20 concurrent jobs. 
+
+Here is an example:
+Donor account ***A*** runs a build with 10 concurrent jobs. This consumes 10 of the 20 available slots. Then, Receiver account ***B*** runs a build with 7 concurrent jobs, which consumes 17 out of the 20 available slots. Finally, if the Receiver account ***C*** runs a build with 5 or more concurrent jobs, only 3 jobs are available to start, while the remaining jobs must wait in the queue for free slots.  
+
+### User limits
+If the Donor’s plan has user license limits, only one pool of user licenses is consumed for both Donors and Receivers within the month. 
+
+A unique user triggering builds is checked against all accounts, not just one. 
+
+The user with the Donor account can see the number of unique users and which accounts consumed user licenses in a given month. The allowance gets deducted from the Donor’s allowance, and only the Donor account controls the user license allowance. 
+
+### License charges
+Users from ***Donor*** and ***Receiver*** accounts must consume a user license and incur the respective charges if applicable. 
+
+There is no double charge for the license for the same user, given that this user triggers a build and is a member of both the ***Donor*** and ***Receiver*** accounts simultaneously. 
+
+In other words, the user license consumption, which is a unique user triggering a build within a billing cycle, is tracked in the context of the plan. Regardless of whether the source build is triggered from the ***Donor*** or ***Receiver*** accounts.
+
+### Credits
+The ***Donor*** user account is responsible for the plan’s credits. 
+When the Donor plan has credits, both the Donor and the Receiver can use the credits from the account. Once the credits run out, the user with the Donor account is responsible for refilling the credits. 
+
+The user with the Donor account can see the credit consumption information for the shared plan. This way, the Donor account user can identify which accounts consumed the credits. 
+
+### Trial Plans
+Trial plans are not available for sharing. 
+
+A Travis CI organization account, which has been a Receiver of a shared plan at least once, if such user selects a Travis CI plan on its own, the user must not be able to see or enable a trial period or select a trial plan (unless there’s a higher than one trial period limit configured for a selected plan).
+
+## Sharing a Plan
+Users with a paid plan can navigate to the Settings screen and select the `Share Plan` tab. 
+
+> Note: The `Share Plan` tab is only available to active Travis CI paid plan accounts. 
+
+As a plan ***Donor***, the Share Plan screen displays a list of available spaces for the Donor to select when sharing the Travis CI plan. To share the plan, click the ***Share Plan*** button for each desired space. Any selected spaces for sharing the plan will immediately display the start date for sharing the plan. 
+
+As a ***Receiver***, navigate to the Account screen, select the **Plan** tab, and check the available Spaces on the left-hand side. In the list, you will find the Space where a plan is being shared with your account. 
+
+The Receiver account can see the shared plan much like it would see a 'regular' plan, with the following annotations:
+
+![Example of Plan Sharing](/user/images/plan-sharing-sample.png)
+
+The ***Receiver*** may still select and purchase their own Travis CI plan by clicking the ***“Buy New Plan”*** button, which is available to each Travis CI organization (Linked with an Assembla Space) that can purchase its own Travis CI plan. 
+
+### Stop Plan Sharing
+
+A Travis CI plan sharing can be ceased at any moment. The Donor account may stop sharing with a specific Receiver account or all Receivers in bulk. 
+
+The Travis CI user with the Donor account can navigate to the `Share Plan` tab and click the ***Stop Sharing*** button for any Space on the list. 
+
+Additionally, if the Donor account plan expires, the Receiver account will no longer be able to utilize the allowance. Whenever the Donor’s sharing plan stops, the Receiver does not have an active plan unless a new plan is assigned to the Receiver's account.