Skip to content

Commit 4f3bf52

Browse files
authored
Update plan-sharing.md
1 parent 39a27b6 commit 4f3bf52

File tree

1 file changed

+26
-26
lines changed

1 file changed

+26
-26
lines changed

user/plan-sharing.md

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -4,35 +4,36 @@ layout: en
44

55
---
66

7-
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.
7+
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.
88

99
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.
1010

11+
> 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.
12+
1113
## Donor and Receiver
12-
Travis CI users with paid plans can enable the Plan Sharing feature and decide to share with the available Spaces.
14+
Travis CI users with paid plans can enable the `Share Plan` feature and decide to share their plan with the available Spaces.
1315

14-
A user who enables the Sharing Plan option is referenced as the *** Donor *** account.
16+
A Travis account (user or organization) that enables the `Share Plan` feature is referenced as the ***Donor*** account.
1517

16-
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.
18+
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.
1719

18-
A user who benefits from the Sharing Plan feature is referenced as the ***Receiver*** account.
20+
A Travis account (user or organization) that benefits from the `Share Plan` feature is referenced as the ***Receiver*** account.
1921

20-
A ***Receiver*** account is a Travis CI user or Organization that benefits from accessing a Travis CI Shared Plan by a Donor account.
22+
A ***Receiver*** account is a Travis CI user or organization that benefits from accessing a Travis CI Shared plan by a Donor account.
2123

2224
## How does a Shared Plan work?
23-
Only Travis CI paid plans are available for sharing with another Travis CI Organization linked with an Assembla Space.
25+
Only Travis CI paid plans are available for sharing with another Travis CI organization.
2426

25-
All recipients may trigger builds within the allowances of the original plan. It means that the system tracks all metrics under the original plan, but there are now multiple sources for these metrics.
27+
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.
2628

2729
### Concurrency-based Plans
28-
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 user account ***A*** decides to share a plan with 20 concurrent jobs with user accounts ***B*** and ***C***. This means that all three accounts have a total of 20 concurrent jobs.
30+
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.
2931

3032
Here is an example:
31-
User account ***A*** runs a build with 10 concurrent jobs. This consumes 10 of the 20 available slots. Then, Account ***B*** runs a build with 7 concurrent jobs, which consumes 17 out of the 20 available slots. Finally, if 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.
32-
33+
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.
3334

3435
### User limits
35-
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.
36+
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.
3637

3738
A unique user triggering builds is checked against all accounts, not just one.
3839

@@ -43,39 +44,38 @@ Users from ***Donor*** and ***Receiver*** accounts must consume a user license a
4344

4445
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.
4546

46-
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.
47+
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.
4748

4849
### Credits
49-
The ***Donor*** account is responsible for the plan’s credits.
50-
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.
50+
The ***Donor*** user account is responsible for the plan’s credits.
51+
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.
5152

52-
The user with the Donor account can see the credit consumption information for the shared plan. This way, the donor user can identify which accounts consumed the credits.
53+
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.
5354

5455
### Trial Plans
55-
Trial Plans are not available for sharing.
56+
Trial plans are not available for sharing.
5657

57-
A Travis CI Organization account (linked to an Assembla Space), 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).
58+
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).
5859

5960
## Sharing a Plan
60-
The plan sharing feature is only available to Travis CI users or Organizations linked to Assembla Spaces with a paid plan.
61-
Users with a paid plan can navigate to the Settings screen and select the Share Plan tab.
61+
Users with a paid plan can navigate to the Settings screen and select the `Share Plan` tab.
6262

63-
> Note: The Share Plan tab is only available to active Travis CI paid plan users.
63+
> Note: The `Share Plan` tab is only available to active Travis CI paid plan accounts.
6464
65-
As a plan ***Donor***, the Share Plan screen displays a list of available spaces with which the donor can select to share 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.
65+
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.
6666

6767
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.
6868

69-
The Receiver account can see the shared Plan much like it would see a 'regular' plan, with the following annotations:
69+
The Receiver account can see the shared plan much like it would see a 'regular' plan, with the following annotations:
7070

7171
![Example of Plan Sharing](/user/images/plan-sharing-sample.png)
7272

73-
The ***Receiver*** may still select and purchase their own Travis CI plan by clicking the ***“Buy New Plan”*** button available to each TravisCI Organization (Linked with Assemble Space), which can purchase its own Travis CI plan.
73+
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.
7474

7575
### Stop Plan Sharing
7676

77-
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.
77+
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.
7878

79-
The Travis CI user with the Donor account can navigate to the Sharing Plan tab and click the ***Stop Sharing*** button for any Space on the list.
79+
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.
8080

8181
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.

0 commit comments

Comments
 (0)