Update our Slack landing page to match Slack's guidelines
About
We have our Slack app configured to direct people to a "landing page" to install the app, rather than to install the app directly through the Slack Marketplace listing. This is because we (currently) have a requirement that a Slack installation is linked to a project and have a GitLab Slack Application integration created for the project in order for it to work.
Problem
Currently, our landing page (https://gitlab.com/-/profile/slack/edit) is very simple and does not match the Slack's guidelines:
This is a problem as part of the review that Slack conducts when we submit our app for review before publishing it involves checking that the landing page matches the guidelines.
When we submitted our Slack application to be reviewed by Slack in order to publish it to the marketplace for the GBP upgrade #356001 (closed) we were told that the landing page does not match the Slack guidelines, and the next time we submit the app we should have this landing page improved.
Requirements from Slack
The Slack guidelines for the landing page are outlined here.
- Must include privacy policy link
- A clear overview of your Slack app, any associated services, and the problem your app solves.
- A detailed explanation of how your app works in Slack. Screenshots and GIFs are a good way to show people what they can expect in Slack after installing your app.
- A clear path to installing your Slack app, whether that is an Add to Slack button on your landing page or instructions for accessing your Add to Slack button.
- A clear path to using your app. Once people install your app to their workspace, they should be redirected to a page that confirms the installation was successful and provides clear next steps for getting started with your app.
- Needs to be publicly accessible i.e. not behind a login.
- Your landing page is, well, a landing page crafted by you, specifically for your Slack app - not a link to a PDF, document or code repository
First iteration
- Landing page will be built by DEX: gitlab-com/marketing/digital-experience/buyer-experience#1281 (closed)
- It would be nice to update the project selector page to include a filter: #371930
- It would be nice to update the copy of the project selector page to support both the "set up Slack for the first time" and "configure existing integration": #372396
Future vision
- All of our integrations will have a basic landing page
-
https://about.gitlab.com/integrations/
will become a "directory" page making a better way to explore and discover integrations, similar to #352347[Filtered_search.png] - We will update the integrations list view include a "Learn more" button that will link to a marketing landing page (#367614 (closed))
Workflow Diagram
Workflow diagram in Draw.io (public)
Questions
- Do we want to measure how many installs we are getting from this new landing page?
- Where should this page be created? What should the URL be?
- Do we need to loop anyone in from Marketing?
Availability & Testing
Suggestion: validate that the slack link in (instance | group | project) > settings > integrations directs to the new landing page. Currently the "Add to Slack" button in the Slack app directory redirects to gitlab.com/-/profile/slack/edit
. This should also redirect to the landing page.
The landing page should link to gitlab.com/-/profile/slack/edit
.