mattermost-plugin-gitlab icon indicating copy to clipboard operation
mattermost-plugin-gitlab copied to clipboard

[Documentation] Add a feature comparison chart to differentiate this plugin from GitLab built-in Mattermost integration

Open reimer-atb opened this issue 4 years ago • 2 comments

It could be helpful for new users if the plugin's documentation (README.md) contained a kind of feature comparison chart to clarify the differences between and different use cases for using this plugin vs. the Mattermost integrations that comes built-in with GitLab (Mattermost notifications and Mattermost slash commands).

@jasonblais provided some comparison in Mattermost Peer-to-peer Help channel

You can run all services in parallel, and each offers a separate set of features:

  1. Built-in Mattermost slash commands: allows you to create and view GitLab issues, and trigger new GitLab CI jobs from Mattermost
  2. GitLab webhooks for Mattermost: allows you to send webhook notifications to Mattermost, as you described
  3. Mattermost plugin for GitLab: offers similar type of notifications as 2, plus daily reminders and sidebar buttons for quick access to open issues, open merge requests and more (see attached).

All in all, I would recommend starting with 3., as this is actively being developed by the Mattermost community and also ships pre-packaged with the GitLab community edition. 1. (for slash commands) can be a good supplement to it.

reimer-atb avatar Jul 20 '20 09:07 reimer-atb

@aaronrothschild - We could use your help with this one. Are you open to drafting a content update?

cwarnermm avatar Jan 18 '22 14:01 cwarnermm

@cwarnermm yes, I could create this content sometime this month. I would simplify to documenting #1 and #3 and skip #2....

aaronrothschild avatar Jan 18 '22 14:01 aaronrothschild

Closing due to inactivity. The issue can be reopened with more interest from our community.

wiersgallak avatar Jun 14 '23 01:06 wiersgallak

Hi, @aaronrothschild @cwarnermm do you know if we have any docs around it, if not this differences-chart?

vish9812 avatar Jun 22 '23 12:06 vish9812

Hi @vish9812 - You can find detailed GitLab plugin documentation here in the README.

And thank you for reaching out via the GitLab plugin channel on our Mattermost Community Server. That's our recommended approach for questions as both staff and the community may be able to assist further.

cwarnermm avatar Jun 22 '23 13:06 cwarnermm

Thanks @cwarnermm but what I need is differences. Or at least features supported by the built-in one, so that I can create my own list.

vish9812 avatar Jun 22 '23 13:06 vish9812