Once these steps along with the product integration have been completed, the last step is to submit a Merge Request to get listed on our Partners page. To add your app, you will need:
Picture Requirements
- Crop your image to a perfect square or rectangle.
- Keep maximum dimensions under 800 by 800 pixels.
- Use the JPEG (
.jpg
) or PNG (.png
) format.- Name file
company_name_in_lowercase
and add the appropriate file extension.
Once you have the above items, follow these steps to add yourself to the Partners page:
applications.yml
file within the folder. Click on the file to open it within the WebIDE. Add the following fields to the correct category of the file and enter the following application information into each of the blank fields:- title: Company Name
content: Description
links:
- url: Company URL
title: Company Name
- url: Technical documentation URL
title: Company Name for GitLab
Choose the app's category accordingly. The code block is to be added to the end of the category list it belongs to.
Notes:
applications.yml
, use the file browser on the left side of the screen to navigate to source/images/applications/apps/
.⋁
icon next to the apps
directory, select upload file, and upload you company logo. Be sure to follow the picture requirements listed above and confirm that the file name matches your picture
entry in applications.yml
.
Note: The image name should match the application title exactly. For example, if your app is titled ‘GitLab Inc’ then the image name being uploaded would be ‘gitlab_inc.png’ and it will then map to your app listing when the site is generated.
Commit
button in the bottom left. It should say something like 2 unstaged and 0 staged changes
. This will bring up a sidebar with an Unstaged
and Staged
area.Create a new branch
. Name the branch in the format of CompanyName-partners-page
or similar. Tick the Start a new merge request
checkbox. Then click Commit
once more.Allow commits from members who can merge to target branch
as detailed on the Allow collaboration on merge requests across forks page in our docs.
Make sure when submitting the MR, the source is the branch that was just created from the MR and the destination/target is the
gitlab-com/www-gitlab-com/
.
Open an issue in the Alliance project requesting a joint private project in the Alliance group.
This gives our partners a home base for testing integrations, workflows and a place to create any public-facing demos. Initially, it will be set to private, but once there is content in the projects, we can always switch the project to public.
We will need a list of the email addresses that were used to create a GitLab.com account. Within your group you'll be able to create projects and repositories for any development/testing.
We are here to help. The Alliance team works from issues and issue boards. If you are needing our assistance with any project, please open an issue and we’ll get back to you as soon as we can! When creating an issue, please select new_partner issue template in the drop down. If it’s technical assistance you’re looking for, please see below for troubleshooting.
We're always here to help you through your efforts of integration. If there's a missing API call from our current API, or you ran into other difficulties in your development please feel free to create a new issue on the Community Edition issue tracker and apply the Ecosystem
label.