How to update integrations directory
This document outlines the internal process for updating https://integrations.mattermost.com/. New integrations get submitted in the Integrations and Apps channel via this form.
- 1.Go to https://mmapps.wpengine.com/wp-login.php and log in with your account. If you don’t have an account, ask Marketing for access.
- 2.Navigate to Posts on the left hand sidebar.
- 3.To add a new integration select Add New.
The following includes guidelines for specific elements of an integration.
Short title of the integration, effectively its name. Examples:
- Facebook
- Twitter
- BigBlueButton Plugin
Note: If the integration is a plugin, please include “Plugin” in the title.
To confirm whether an integration is a plugin, check its install instructions to see what it refers to. For example, if it says to configure it as a webhook in Mattermost and as a plugin in Jenkins, it's a plugin in Jenkins, not in Mattermost.
Note: If it's an Amazon-related integration, include both the official and short form in the title. For example "Amazon AWS SNS Plugin".
Include a short description of the integration, typically provided by the integration creator. You can also usually find a description of the integration on the GitHub project.
Note: Don’t end the description with a period.
This is the GitHub author of the integration. Depending on the details in their GitHub profile this should always be a full name or a company name. If neither a full name or a company name is public on their GitHub profile, using their GitHub username is also fine.
This is the programming language of the integration.
You can find this by clicking on the colored bar in the GitHub project, below the header containing Commits, Branches, Releases, Contributors, and choose the language(s) higher than 30%.
Tips:
- Don't add "Makefile" unless it's the only language on the repo.
- Use "Go" instead of "Golang".
- If there is no language, set to "N/A" instead of leaving it blank.
This is typically found in the GitHub project, on the file named “LICENSE”. The license file should specify the license type.
Note: License must be compatible with Apache 2.0 (e.g. not GPLv3, nor APGLv3). If it's not compatible with Apache 2.0, do not add the integration to the website.
For formatting, write "Apache 2.0", "BSD 2-Clause" or "BSD 3-Clause".
When the integration is not open source, mark the license as "N/A - not open source".
Link to the README file on the GitHub project which typically includes install instructions.
Link to their GitHub repo.
Typically found in the GitHub project by selecting the Releases tab in the header. Navigate to the oldest release, and use its date as the Date Published field. If there are no releases, go to the Contributors tab in the header, and select the start date as the Date Published field.
Choose the categories you feel best fit the integration. If you’re uncertain, compare what categories are used by Slack, Atlassian, and/or Salesforce (see list below). If you're still uncertain, ask the Integrations PM.
This is a logo of the integration, e.g. Facebook logo for Facebook integration.
Use Twitter to find official logos if none are provided by the integration creator. If there is no good icon/logo to use, go to https://mattermost.wayfx.com/0ddc9bpne/p/45193 and choose an icon that best fits the integration type.
Use an icon that's at least 80x80px in size.
Check the date of "Last Commit" on the repository.
- 1.License of the integration must be compatible with Apache 2.0 (e.g. not GPLv3 or APGLv3). The only exception is if the integration is not open source.
- 2.The integration must have been updated in the last 12 months.
- 3.Every integration link must be related to Mattermost. Especially if the integration is not open source, it should be obvious to users that it's related to Mattermost.
- Add integration/plugin creators to changelog’s list of contributors.
- For example: For March release, add any new ones from February.
- Post a tweet for all new integrations.
- 1.Once the integration entry has been added to the directory, please reply back in the Integrations channel with a screenshot of the entry that was added, a link to its install guide, and an at-mention for the Integrations PM. Example:
[@-username] Standup Raven Plugin added to https://integrations.mattermost.com
https://github.com/standup-raven/standup-raven/blob/master/README.md
[Attached image]
- 1.
- 1.Add integrations with more than 50 stars to the “New and Noteworthy” category.
- 2.Add 8 most recent integrations to the “New and Noteworthy” category. The oldest on this list should be removed when a new integration is added.
- 3.Update the Date Last Updated for all integrations.
- 4.Remove any integrations that haven’t been updated in the last 12 months.
- Note: Keep this relaxed. Some older ones are still important to keep.
- 5.Ask the Integrations PM if any integrations are good to add or remove from the "Staff Picks" section.
Note: These integrations should be kept in the "New and Noteworthy" category:
Last modified 2yr ago