Update People management UI (Cloud and CE) (#350)

* Update People management UI (Cloud and CE)

* Autopromotion should use main

Author: TomFern

.semaphore/semaphore.yml

@@ -51,4 +51,4 @@ promotions:
     pipeline_file: prod.yml
     deployment_target: Production
     auto_promote:
-      when: "result = 'passed' and branch = 'master'"
+      when: "result = 'passed' and branch = 'main'"

docs/docs/using-semaphore/img/add-people.jpg

@@ -75,31 +75,24 @@ To manage users in your organization, open the organization menu and select **Pe
 
 ### How to invite users {#add-people}
 
-To invite a user to your organization, press the **Add people** button. You have two options:
+To invite a user to your organization, press the **Add people** button:
 
-- **By their [GitHub username](https://docs.github.com/en/get-started/learning-about-github/github-glossary#username)**, e.g. `TomFern`
+![People tab](./img/people-tab.jpg)
 
-  - Type their GitHub handle
-  - Press **Invite**
-
-  ![Adding users by their GitHub handle](./img/github-handle.jpg)
-
-  This option **does not allow email addresses** and doesn't send email notifications to users. To notify users via email, use the option below.
-
-- **By existing projects**
-  
-  The list shows GitHub and BitBucket users that already have access to repositories but have not yet been added to the Semaphore project
+<Steps>
 
-  - Select the users and optionally type an email
-  - Press **Add selected** to add them to the organization and project
+1. Select one of the table: **Email**, **GitHub**, **BitBucket**, or **GitLab**
+    - For email: type their email and optionally their username. A temporary password is shown. The user must change it on first login.
+    - For other options: type their handle, e.g. `TomFern`
+    - You may alternatively select users from the list. The list shows not-yet-invited users with access to at least one of the repositories
 
-  ![Adding users to the organization](./img/add-people.jpg)
+    ![Invite users](./img/invite-user.jpg)
 
-:::note In case of delays
+2. Press **invite**
+3. Optionally, set their [role](#roles-people)
 
-In case of delays, click on the **Refresh** button in the top right corner of the page after sending an invite. This will trigger a sync between GitHub and Semaphore, which can typically last up to 2 to 5 minutes.
 
-:::
+</Steps>
 
 ### How to remove users {#remove-users}
 

docs/docs/using-semaphore/img/invite-user.jpg

@@ -19,92 +19,74 @@ Legends: ? (unknown), p (pending/planned), x (deleted pages/content), c (confirm
 
 | Feature | Semaphore Cloud | Semaphore CE |
 |--|--|--|
-| cVisual editor | Yes | Yes |
-| cArtifacts | Yes | Yes |
-| cTasks | Yes | Yes |
-| ?SSH Debug | Yes | Yes (but SSH debugging is not available for self-hosted jobs)|
-| cCache | Yes | Yes |
-| pMonorepo support | Yes | Yes (depends on initialization jobs) |
-| pInitialization jobs | Yes | Yes |
-| cSelf-hosted agents | Yes | Yes |
-| cGitHub support | Yes | Yes |
-| cBitBucket support | Yes | Yes |
-| cxPromotions | Yes | No |
-| cxParameterized promotions | Yes | No |
-| cxDeployment targets | Yes | No |
-| cxPre-flight checks | Yes | No |
-| cxsem-service & sem-versin | Yes | No |
+| Visual editor | Yes | Yes |
+| Artifacts | Yes | Yes |
+| Tasks | Yes | Yes |
+| SSH Debug | Yes | Yes |
+| Cache | Yes | Yes |
+| Monorepo support | Yes | Yes |
+| Initialization jobs | Yes | Yes |
+| Self-hosted agents | Yes | Yes |
+| GitHub support | Yes | Yes |
+| BitBucket support | Yes | Yes |
+| Promotions | Yes | No |
+| Parameterized promotions | Yes | No |
+| Deployment targets | Yes | No |
+| Pre-flight checks | Yes | No |
+| sem-service & sem-version | Yes | No |
 
 
 ## Dashboards
 
 | Feature | Semaphore Cloud | Semaphore CE |
 |--|--|--|
-| pTest reports | Yes | Yes |
-| cActivity monitor | Yes | Yes |
-| cxCustomeDashboards | Yes | No |
-| cxFlaky tests | Yes | No |
-| cxProject insights | Yes | No |
-| cxOrganization health | Yes | No |
+| Test reports | Yes | Yes |
+| Activity monitor | Yes | Yes |
+| CustomeDashboards | Yes | No |
+| Flaky tests | Yes | No |
+| Project insights | Yes | No |
+| Organization health | Yes | No |
 
 
 ## Security and compliance
 
 | Feature | Semaphore Cloud | Semaphore CE |
 |--|--|--|
-| cProject-level secrets | Yes | Yes |
-| cOrganization secrets | Yes | Yes |
-| cxPolicies for accessing secrets | Yes | No |
-| cxAudit logs | Yes | No |
+| Project-level secrets | Yes | Yes |
+| Organization secrets | Yes | Yes |
+| Policies for accessing secrets | Yes | No |
+| Audit logs | Yes | No |
 
 
 ## User and permissions management 
 
-NOTE: see actual implementation to determine what needs to be deleted from organizations.md
-
 | Feature | Semaphore Cloud | Semaphore CE |
 |--|--|--|
-| cMultiple organizations | Yes | No | 
-| cInvite users to your organization | Yes | Yes |
-| cOrganization roles | Yes | Yes |
-| ?Project roles | Yes | Yes (*) |
-| cxUser groups | Yes | No |
-| cxCustom Roles | Yes | No |
+| Multiple organizations | Yes | No | 
+| Invite users to your organization | Yes | Yes |
+| Organization roles | Yes | Yes |
+| Project roles | Yes | Yes (*) |
+| User groups | Yes | No |
+| xCustom Roles | Yes | No |
 
 (*) Project roles exist but cannot be manually assigned to individual users. The role is assigned based on project-membership and org-wide user roles.
 
 ## Integrations 
 
-NOTE: what about Github SSO? affects Connect GitHub and Single Sign on GitHub pages
-
 | Feature | Semaphore Cloud | Semaphore CE |
 |--|--|--|
-| cRepository status checks | Yes | Yes |
-| cRepository badges | Yes | Yes |
-| ?Slack notifications | Yes | Yes |
-| ?Webhook notifications | Yes | Yes |
-| cxSAML/SCIM integrations | Yes | No |
-| cxOkta integration | Yes | No |
-| cxOpenID Connect | Yes | No |
-| ?GitHub SSO | Yes | ? |
-
-## Questions
-
-Change/forgot password?
-Maintenance/upgrade Semaphore
-Take backups? Restore an installation?
-Renew/install certificates
-
-Do project roles exist? or we just have to use org roles? They exist, but you cannot assign them, just view them. You can add/remove people from projects and that's it.
-TODO: is oauth still supported? I can't make it work
-
-How do project permissions work? Do I need to invite user to my org with email and then manually add them to the project? Does it check for collaborators on the repo?
-How do I grant permissions to a user to a project? Do I need to give him admin on the org?
-Confirm with alek: Are there any plans to sem-service or sem-version to self-hosted agent jobs? NO
-
-Are there any plans to add SSH debugging to self-hosted jobs?
-Will GitHub SSO be included in CE?
-
-Should pull request trigger workflows?
-Do status badged work?
-How do I make the cache work on k8s? The docs only talk about VMs
+| Repository status checks | Yes | Yes |
+| Repository badges | Yes | Yes |
+| Slack notifications | Yes | Yes |
+| Webhook notifications | Yes | Yes |
+| SAML/SCIM integrations | Yes | No |
+| Okta integration | Yes | No |
+| OpenID Connect | Yes | No |
+| GitHub SSO | Yes | No |
+
+## See also
+
+- [Guided tour](./guided-tour)
+- [Migration guides](./migration/overview)
+- [Install Semaphore CE](./install)
+

docs/docs/using-semaphore/organizations.md

@@ -37,19 +37,18 @@ To manage users in your Semaphore instance, open the server menu and select **Pe
 
 To invite a user to your instance, press the **Add people** button.
 
+
 <Steps>
 
 1. Type the email of the person you wish to invite
 2. Optionally, set a username. If not provided, the username is inferred from the email
-3. Press **Add member**
-4. Press **Reveal** to show the temporary password assigned to the new member
+3. Press **Create Accounts**
+4. Take note of the temporary passwords. On first login, users are prompted to change their passwords
 
 ![Add user screen](./img/add-user.jpg)
 
 </Steps>
 
-TODO: will the user get an email? Does he need to change the password?
-
 ### How to remove users {#remove-users}
 
 Users can only be removed from the instance when they don't own any projects. You must [transfer the ownership](./projects#owner-change) of all the user's projects before they can be removed from Semaphore.