Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
mickmister committed May 20, 2024
1 parent 55a68c7 commit a282fbe
Showing 1 changed file with 9 additions and 8 deletions.
17 changes: 9 additions & 8 deletions source/integrate/github-interoperability.rst
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,8 @@ A Mattermost system admin must perform the following steps in GitHub.
- **Authorization callback URL**: ``https://YOUR-MATTERMOST-URL.COM/plugins/github/oauth/complete``, replacing ``https://YOUR-MATTERMOST-URL.COM`` with your Mattermost URL. This value must match the Mattermost server URL you use to log in.

3. Save your changes.
4. Select **Generate a new client secret**, and enter your GitHub password to continue.
5. Copy the **Client ID** and **Client Secret** in the resulting screen.
4. Select **Generate a new client secret**, and enter your GitHub password to continue.
5. Copy the **Client ID** and **Client Secret** in the resulting screen.
6. Generate a **Webhook Secret** and **At Rest Encryption Key** by selecting **Generate**.

Create a webhook in GitHub
Expand All @@ -49,10 +49,11 @@ A Mattermost system admin must perform the following steps in GitHub. Create a w
- **Secret**: The **Webhook Secret** value you copied earlier.

4. Under **Which events would you like to trigger this webhook?**, select **Let me select individual events**.
5. Select the following events:
5. Select the following events:

- Branch or Tag creation
- Branch or Tag deletion
- Releases
- Issue comments
- Issues
- Pull requests
Expand Down Expand Up @@ -108,10 +109,10 @@ We recommend updating this integration as new versions are released. Generally,
Usage
-----

Users who want to use GitHub interconnectivity must register an OAuth app in GitHub for Mattermost, and then connect a GitHub account to Mattermost.
Users who want to use GitHub interconnectivity must register an OAuth app in GitHub for Mattermost, and then connect a GitHub account to Mattermost.

Once connected, you'll receive direct messages from the GitHub bot in Mattermost when someone mentions you, requests a review, comments on, or modifies one of your pull requests/issues, or assigns you to an issue on GitHub.

Register an OAuth app in GitHub for Mattermost
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand All @@ -131,7 +132,7 @@ Connect a GitHub account to Mattermost

2. Once connected, run the ``/github help`` slash command to see what you can do.

Get started
Get started
~~~~~~~~~~~

Here are some common slash commands you can get started with:
Expand All @@ -140,7 +141,7 @@ Run the ``/github subscriptions add`` slash command to subscribe a Mattermost ch

For example, to post notifications for issues, issue comments, and pull requests matching the label **Help Wanted** from the ``mattermost/mattermost-server`` GitHub repository, use: ``/github subscriptions add mattermost/mattermost-server --features issues,pulls,issue_comments,label:"Help Wanted"``. The following flags are supported:

- ``--features``: A comma-delimited list of one or more of: issues, pulls, pulls_merged, pulls_created, pushes, creates, deletes, issue_creations, issue_comments, pull_reviews, label:"labelname". Defaults to ``pulls,issues,creates,deletes``.
- ``--features``: A comma-delimited list of one or more of: issues, pulls, pulls_merged, pulls_created, pushes, creates, deletes, issue_creations, issue_comments, pull_reviews, releases, label:"labelname". Defaults to ``pulls,issues,creates,deletes``.
- ``--exclude-org-member``: The events triggered by organization members that won't be delivered. It will be locked to the organization configured and only works for users whose membership is public. Organization members and collaborators are not the same.
- ``--render-style``: Notifications are delivered in the specified style (for example, the body of a pull request will not be displayed). Supported values are ``collapsed``, ``skip-body``, or ``default`` (which is the same as omitting the flag).
- ``--exclude``: A comma-separated list of the repositories to exclude from getting the subscription notifications like ``mattermost/mattermost-server``. Only supported for subscriptions to an organization.
Expand Down Expand Up @@ -185,4 +186,4 @@ Customize

This integration contains both a server and web app portion. Visit the `Mattermost Developer Workflow <https://developers.mattermost.com/extend/plugins/developer-workflow/>`__ and `Mattermost Developer environment setup <https://developers.mattermost.com/extend/plugins/developer-setup/>`_ for information about developing, customizing, and extending Mattermost functionality.

In order to get your environment set up to run Playwright tests, please see the setup guide at `e2e/playwright <https://github.com/mattermost/mattermost-plugin-github/blob/master/e2e/playwright#readme>`_.
In order to get your environment set up to run Playwright tests, please see the setup guide at `e2e/playwright <https://github.com/mattermost/mattermost-plugin-github/blob/master/e2e/playwright#readme>`_.

0 comments on commit a282fbe

Please sign in to comment.