docs/faq.md

   1 # FAQ
   2
   3 Frequently asked questions.
   4
   5 ## How much does it cost?
   6
   7 Gitter is entirely free for all public and private conversations.
   8
   9 ## I have a suggestion, where can I suggest/discuss it?
  10
  11 Feel free to come discuss your idea in the [`gitter/gitter`](https://gitter.im/gitter/gitter) room and create an issue, https://gitlab.com/gitterHQ/webapp/issues
  12
  13
  14 ## Help! Do you have any Support?
  15
  16 If your support inquiry doesn't need to be private, drop by the [`gitter/gitter`](https://gitter.im/gitter/gitter) room.
  17
  18 Otherwise, send a message to support@gitter.im
  19
  20
  21 ## Do you have an API?
  22
  23 We are so glad you asked, **yes** we do!
  24
  25 You can build apps on top of Gitter by using our REST API. You can find more information about it at [developer.gitter.im](https://developer.gitter.im/) or use our [Node.js module](https://www.npmjs.org/package/node-gitter).
  26
  27 If you have any questions about our API, please don't hesitate to contact us or join us in our [`gitter/api`](https://gitter.im/gitter/api) chat room.
  28
  29
  30 ## Can I merge/connect my accounts?
  31
  32 See [Accounts](./accounts.md#can-i-mergeconnect-my-accounts)
  33
  34
  35 ## Can I change my username?
  36
  37 See [Accounts](./accounts.md#can-i-change-my-username)
  38
  39
  40 ### How do I remove the  `_twitter`/`_gitlab` suffix from my username
  41
  42 See [Accounts](./accounts.md#how-do-i-remove-the-twitter-suffix-from-my-username)
  43
  44
  45 ## How do I update my avatar?
  46
  47 See [Accounts](./accounts.md#how-do-i-update-my-avatar)
  48
  49
  50 ## You want write access on my private repos? Are you insane?
  51
  52 See the [GitHub **Private Repositories** section on the **OAuth scopes page**](./oauth-scopes.md#private-repositories)
  53
  54
  55 ## You want access to all of my GitLab groups/projects? Are you crazy?
  56
  57 See the [**GitLab** section on the **OAuth scopes page**](./oauth-scopes.md#gitlab)
  58
  59
  60 ## How do I change my room from public to private?
  61
  62 See [Rooms](./rooms.md#change-room-security-after-creation)
  63
  64
  65 ## Why isn't my GitHub organisation or repos appearing?
  66
  67 The first thing to check is [adding private repo access OAuth scope](./oauth-scopes.md#grant-private-repo-access) in order to see a private GitHub repo.
  68
  69 If it isn't a private repo, the key is to make sure your personal GitHub OAuth scopes and GitHub organisation scopes match (both public and private granted or just public). Check the following pages to see if they match(**Gitter Public Repo Access** and **Gitter Private Repo Access**):
  70
  71  - [Personal OAuth application settings](https://github.com/settings/applications)
  72  - Organisation OAuth application settings, `https://github.com/organizations/YOURORG/settings/applications`(replace `YOURORG` in the link)
  73
  74 If one of them is missing you can sign out and back in to get **Gitter Public Repo Access** granted personally. And then use the [**Allow private repo access** option from the profile dropdown](./oauth-scopes.md#grant-private-repo-access) in the top-right for **Gitter Private Repo Access**
  75
  76 Once you see the public/private OAuth scopes [listed](https://github.com/settings/applications), you can click on those OAuth apps and **Request** access under the Organization access section:
  77
  78  - **Gitter Public Repo Access**: https://github.com/settings/connections/applications/e865e74c1d0a3e66003c
  79  - **Gitter Private Repo Access**: https://github.com/settings/connections/applications/a06939fa3ecb59c27f88
  80
  81 ---
  82
  83 You can also try making your organisation membership public, `https://github.com/orgs/YOURORG/people`(replace `YOURORG` in the link)
  84
  85 For more information see [OAuth Scopes](./oauth-scopes.md).
  86
  87
  88 ## What happens if I rename something on GitHub (org, repo)
  89
  90 #### Org rename
  91
  92 Org renames do not happen automatically and require a script to be run manually on our side.
  93
  94 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.
  95
  96  - Make sure your org membership is public on both the old and new org, `https://github.com/orgs/your-org/people`
  97  - Link to the old org on GitHub
  98  - Link to the new org on GitHub
  99  - Link to the community on Gitter, `https://gitter.im/orgs/your-community/rooms`
 100
 101 #### Repo rename
 102
 103 Repo renames do not happen automatically. Create a new room tied to the repo and we can move the messages over manually. Please note, this will not move room members over.
 104
 105 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.
 106
 107  - Create a new room tied to the repo
 108  - Link to where the repo used to exist on GitHub
 109  - Link to where the repo now exists on GitHub
 110  - Link to the old room on Gitter
 111  - Link to the new room on Gitter
 112
 113 #### Transfer repo to a new org
 114
 115 Repo transfers do not happen automatically. Create a new room tied to the repo and we can move the messages over manually. Please note, this will not move room members over.
 116
 117 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.
 118
 119  - Create a new room tied to the repo
 120  - Make sure your org membership is public on both the old and new org, `https://github.com/orgs/your-org/people`
 121  - Link to where the repo used to exist on GitHub
 122  - Link to where the repo now exists on GitHub
 123  - Link to the old room on Gitter
 124  - Link to the new room on Gitter
 125
 126
 127 ## What is Gitter Next/staging?
 128
 129 Gitter Next/staging is where we put our up-coming release branch up for preview. Most of the time it's small changes or even under-the-hood changes you don't see. Sometimes we put pretty large changes up there too and love to hear your feedback.
 130 Sometimes it blows up, but not very often.
 131
 132 You can enable Gitter next in a variety of ways:
 133
 134 #### Desktop Browser
 135
 136 In your desktop browser, visit http://next.gitter.im and move the giant switchy thing over to next. Then refresh. You will notice a little green pill at the top of your screen that says "NEXT". You are now on Next.
 137
 138 There's also a bookmarklet at the bottom of the Next page and you can add this to your browser things to toggle this pretty easily.
 139
 140 #### Linux and Windows app
 141
 142 There's a convenient little toggle on the Gitter menu of your application to turn Next on or off.
 143
 144 ![](https://i.imgur.com/QZJm2MM.png)
 145
 146 #### Mac app
 147
 148 **Gitter** menu bar dropdown in the top-left -> **Use Gitter Next**
 149
 150 ![](https://i.imgur.com/YXtPn4N.png)
 151
 152
 153 ## No notifications on mobile (Android, iOS)
 154
 155 See [Notifications](./notifications.md#no-notifications-on-mobile-android-ios)