GitLab + Review Lens
Review Lens natively integrates with GitLab allowing you to post annotated feedback directly to merge requests and issues within projects. Review Lens supports integrations with personal and group owned projects. Find more information below on getting started and guidelines on using Review Lens with GitLab.
Installing the browser extension
Review Lens captures screenshots using a browser extension or add-on, to get started you'll firstly need to install the extension or add-on for your web browser. After installation launch Review Lens and select GitLab from the post menu.
Getting started
Accessing and posting to personal and group projects is as easy as authenticating with GitLab in Review Lens.
After selecting GitLab from the post menu in Review Lens a browser window to gitlab.com will appear for secure authentication, simply enter your GitLab credentials and sign in. If it’s your first time authenticating with GitLab in Review Lens, GitLab will prompt you to authorize Review Lens before continuing.
Please note
In order to post to personal or group projects, you must either
- Be a project member with minimum role level: reporter for private projects
- Be a project member with minimum role level: guest for public projects
GitLab guidelines
- When posting to GitLab merge requests, posts are made as either standard comments or discussions, which will be visible under the merge request's overview tab. Discussions are similar to comments however need to be resolved before a merge request can be merged.
- When posting to GitLab issues, posts are made as either standard comments or discussions, which will be visible under the issue's activity section or in the issue's description if a new issue was created.
- Screenshots are uploaded using the GitLab projects API and stored on GitLab’s asset servers, in the same location they would be stored if an image was attached to a merge request or issue comment.
- Screenshots, annotations, and comments are never stored or retained on Review Lens' servers. They are uploaded under the selected project and therefore inherit the permissions defined by the project itself.
Supported project types
Review Lens officially supports the following GitLab cloud hosted (gitlab.com) project types.
- GitLab SaaS Free
- GitLab SaaS Premium
- GitLab SaaS Ultimate
Integrations with GitLab Community Edition and Enterprise Edition (self managed/hosted) and SAML authentication with external Identity Providers (IdPs) is currently not officially supported. If you’d like this or any other GitLab integration functionality, please express your interest by reaching out to [email protected]