Skip to content

Commit b863c7d

Browse files
Khymejamessewell
andauthored
docs: add docs about project ownership transfer (timescale#2889)
* docs: add docs about project ownership transfer * Update project-ownership.md Appeasing Vale Signed-off-by: James Sewell <[email protected]> * Update project-ownership.md Appease Vale Signed-off-by: James Sewell <[email protected]> * Update members-list.md Appease Vale Signed-off-by: James Sewell <[email protected]> * Update project-ownership.md Vale again :-( Signed-off-by: James Sewell <[email protected]> * Update images --------- Signed-off-by: James Sewell <[email protected]> Co-authored-by: James Sewell <[email protected]>
1 parent 8fb6943 commit b863c7d

File tree

4 files changed

+70
-2
lines changed

4 files changed

+70
-2
lines changed

use-timescale/members/index.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,8 @@ cloud_ui:
1313

1414
When you log in to your [Timescale account][cloud-login], navigate to the
1515
`Members` page to manage users of your project. From here, you can see the
16-
current members of your Timescale project, and add and remove members.
16+
current members of your Timescale project, transfer project ownership, add
17+
and remove members.
1718

1819
<img class="main-content__illustration"
1920
width={1375} height={944}
@@ -27,9 +28,12 @@ When you have created your project, you can add other users so that they can see
2728
your project in their Timescale console. You can add, manage, and delete
2829
users from the `Members` section of the Cloud console.
2930

30-
You are assigned an `Administrator` role for projects that you create,
31+
You are assigned an `Owner` role for projects that you create,
3132
and have the ability to add and delete other users, as well as change the
3233
project name. If you have been added to a project, you are assigned a `Member`
3334
role.
3435

36+
If you're the `Owner` and have a two-factor authentication method enabled, you can
37+
transfer project ownership to another `Member` of the project.
38+
3539
[cloud-login]: https://console.cloud.timescale.com/

use-timescale/members/members-list.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,20 @@ alt="Adding a new member to a project in Timescale"/>
4747

4848
</Procedure>
4949

50+
<Procedure>
51+
52+
### Resend a project invitation
53+
54+
The invitations to join a project that are sent are valid for 7 days.
55+
In case an user you invited did not click in time or did not receive the email,
56+
you can send them a project invitation again.
57+
1. [Log in to your Timescale account][cloud-login] and navigate to
58+
the `Members` section.
59+
2. Click the `Resend invitation` next to the desired members' name.
60+
61+
</Procedure>
62+
63+
5064
<Procedure>
5165

5266
### Removing members from a project group
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: Manage project ownership
3+
excerpt: Add or remove members from a project, or leave a project
4+
products: [cloud]
5+
keywords: [members, projects, admin, roles]
6+
tags: [users]
7+
cloud_ui:
8+
path:
9+
- [members]
10+
---
11+
12+
# Project ownership
13+
14+
There must be one `owner` in a project at any given time. Project ownership grants you the ability to remove any member from the project.
15+
<Procedure>
16+
17+
### Project ownership transfer
18+
19+
If you are the `owner` of a project, and have a [two-factor authentication][2fa] method enabled, you can
20+
transfer project ownership to another `member` of the project (losing your own ownership rights).
21+
22+
1. [Log in to your Timescale account][cloud-login] and navigate to
23+
the `Members` section.
24+
2. Click the ⋮ menu next to the person you want to transfer project ownership to.
25+
If you are unable to transfer ownership at this time then hovering over the greyed out button should provide details.
26+
3. Enter your password, and click `Verify`.
27+
4. Complete the proposed two-factor authentication challenge and click `Confirm`.
28+
29+
<img class="main-content__illustration"
30+
width={1375} height={944}
31+
src="https://assets.timescale.com/docs/images/transfer-ownership/members-table-contextual-menu.png"
32+
alt="Transfer ownership of a project in Timescale"/>
33+
34+
</Procedure>
35+
36+
<Highlight type="note">
37+
38+
If you don't have two-factor authentication or log in to Timescale using an [SAML authentication][saml] this option is unavailable.
39+
Instead you can [reach out](https://www.timescale.com/contact) to have this action done.
40+
41+
</Highlight>
42+
43+
[cloud-login]: https://console.cloud.timescale.com/
44+
[saml]: /use-timescale/:currentVersion:/security/saml/
45+
[2fa]: /use-timescale/:currentVersion:/security/multi-factor-authentication/

use-timescale/page-index/page-index.js

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,11 @@ module.exports = [
7171
href: "members-list",
7272
excerpt: "Timescale members list",
7373
},
74+
{
75+
title: "Project Ownership",
76+
href: "project-ownership",
77+
excerpt: "Timescale project ownership",
78+
},
7479
],
7580
},
7681
{

0 commit comments

Comments
 (0)