GitHub import: improve documentation
General
Here is the topic that needs to be improved:
https://docs.gitlab.com/ee/user/project/import/github.html#use-the-github-integration
What makes reader confused?
- Assertion doesn't look valid:
If you are importing to GitLab.com, you can alternatively import GitHub repositories using a personal access token. We do not recommend this method, as it does not associate all user activity (such as issues and pull requests) with matching GitLab users.
It doesn't matter if integration works through the PAT or OAuth. The only requirement is to ensure that users have publicly visible emails on GitHub side that matches emails on GitLab side. Also this particular subject is about "GitHub integration" and next one is "Use a GitHub token" what leads me to thoughts that event if there is any difference - notes about PAT approach should lay down in "Use a GitHub token".
- Start of the sentence looks weird:
User-matching attempts occur in that order, and if a user is not identified either way, the activity is associated with the user account that is performing the import.
In which order? either way?
Probably is referencing items 20b04cc0 that were removed from the documentation at some point.
Most likely that it should be something like:
If GitHub user public email doesn't match any GitLab user email, the activity is associated with the user account that is performing the import.