[GitHub] [incubator-devlake-website] Startrekzky commented on a diff in pull request #383: docs: add gitlab auth docs

[GitBox <gi...@apache.org>]

Startrekzky commented on code in PR #383:
URL: https://github.com/apache/incubator-devlake-website/pull/383#discussion_r1065854628


##########
docs/UserManuals/ConfigUI/GitLab.md:
##########
@@ -26,9 +26,20 @@ This should be a valid REST API endpoint.
 
 GitLab personal access tokens are required to add a connection. Learn about [how to create a GitLab personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html).
 
+###### GitLab personal access tokens(Recommended)

Review Comment:
   Remove '(Recommended)' as there's only one access method for GitLab.



##########
docs/UserManuals/ConfigUI/GitLab.md:
##########
@@ -26,9 +26,20 @@ This should be a valid REST API endpoint.
 
 GitLab personal access tokens are required to add a connection. Learn about [how to create a GitLab personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html).
 
+###### GitLab personal access tokens(Recommended)
+
+The following permissions are required to collect data from repositories:
+
+- `api`
+- `read_api`
+- `read_user`
+- `read_repository`
+
+And GitLab users have five permissions in the group: Guest, Reporter, Developer, Master, Owner. You can check your user permission level at In `Max role` column of `Project information -> Menbers`. If you are a Guest role, you can only create issues and post comments, but you cannot read or write the repository.

Review Comment:
   "And GitLab users have five permissions in the group: Guest, Reporter, Developer, Master, Owner. You can check your user permission level at In `Max role` column of `Project information -> Menbers`. If you are a Guest role, you can only create issues and post comments, but you cannot read or write the repository."
   
   to
   
   You also have to double-check your GitLab user permission settings. 
   1. Go to the `Project information -> Members` page of the GitLab projects you wish to collect.
   2. Check your role in this project from the `Max role` column. Make sure you are not the `Guest` role, otherwise, you will not be able to collect data from this project.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@devlake.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org