docs/communities.md

   1 # Communities
   2
   3 A community holds many rooms.
   4
   5 Communities are also referred to as "groups" internally in the codebase.
   6
   7
   8 ## Community creation
   9
  10 Use the **+** -> **Create community** option in the bottom-left of the menu bar to start the community creation process.
  11
  12 ### Associate your community with GitLab
  13
  14 If you sign in with GitLab, communities can be associated with a [GitLab group](https://docs.gitlab.com/ee/user/group/) or [project](https://docs.gitlab.com/ee/user/project/). Just click the link in the "do you want to start a community for one of your GitLab groups/projects?" phrase below the name and URI inputs.
  15
  16 Gitter communities based on your personal GitLab user namespace are not supported yet but we plan to follow up soon after -> https://gitlab.com/gitterHQ/webapp/-/issues/2397
  17
  18
  19 ### Associate your community with GitHub
  20
  21 If you sign in with GitHub, communities can be associated with a GitHub organisation or repo. Just click the link in the "do you want to start a community for one of your GitHub orgs/repos?" phrase below the name and URI inputs.
  22
  23 If you don't see the GitHub org/repo listed that you want to associate, see [*Why isn't my GitHub organisation or repos appearing?* FAQ](./faq.md#why-isnt-my-github-organisation-or-repos-appearing).
  24
  25 ![](https://i.imgur.com/2eZyyEQ.png)
  26
  27
  28 ## Community admins
  29
  30 You can add new admins for a room by visiting a room in the community -> **Room settings dropdown** -> **Permissions** modal -> **Edit community permissions**
  31
  32
  33 ## Rename a community
  34
  35 If you want to rename a community because a GitHub org/repo was renamed/transferred, see this [FAQ section instead](./faq.md#what-happens-if-i-rename-something-on-GitHub-org-repo) instead.
  36
  37 Currently, there isn't a way to rename a community in the UI. But you can send a message to support@gitter.im with the following info. Make sure to email with the primary email address associated with the GitLab/GitHub/Twitter account tied to your Gitter account.
  38
  39  - Link to the current Gitter community
  40  - Desired community name
  41
  42
  43 ## Delete a community
  44
  45 Currently, there isn't a way to delete a community in the UI.
  46 Even if you delete all the rooms, it is still accessible via your community home, most likely `https://gitter.im/YOUR-COMMUNITY/home`
  47
  48 If you want to delete a community, send an email to support@gitter.im with a link
  49 and any confirmation needed to verify your identity. Please use the primary email
  50 associated with your account so I can verify easier.