Clarify visibility for projects
The current project documentation does not clarify access rights relative to "external" users.
My organization maintains a gitlab instance that is used for collaboration with our customers. Some customers have access restrictions, so the projects cannot be made publicly accessible, but there are cases where the same project can be made visible to multiple customers, so it is not necessarily the case that there is a 1:1 correspondence between group and customer. The customers are managed as "external" users by the local gitlab administrators.
However, all employees of the organization should have access to the projects. The current documentation for setting project visibility implies that "Internal" will give access to any logged-in user, which is too broad for restricting the customer views, so many projects are being created with "Private" visibility. The use of "Private" creates a significant administrative burden because each project/group must then iterate and maintain the list of all company employees as having access to the projects.
It is our understanding based on discussions and investigation with our local gitlab administrators that an "Internal" project will grant access to all logged-in users that are not marked as "external", and that "external" users must still be granted explicit access. However, the documentation (on the project settings page, and further in the help information at https://gitlab.url/help/public_access/public_access) does not make any mention of "external" users and this additional control perspective.
If our understanding is correct, then having this documented at the above URL as well as the mention in the Visibility settings radio-button area would be very helpful in allowing a better selection of the visibility and reducing per-project administrative overhead. If this understanding is not correct, then it would be nice to know this and have the documentation for the gitlab administrator's user setup describe this information.
Add information to the https://gitlab.url/help/public_access/public_access help information to describe "external" users.
Add information to the radio-button selection area for Visibility on the Project and Group settings page.