Merge branch 'trizzi-master-patch-36513' into 'master'

Add docs for package registry visibility

See merge request gitlab-org/gitlab!83347

app/assets/javascripts/pages/projects/shared/permissions/components/settings_panel.vue

@@ -590,7 +590,9 @@ export default {
           :help-path="packagesHelpPath"
           :label="$options.i18n.packagesLabel"
           :help-text="
-            s__('ProjectSettings|Every project can have its own space to store its packages.')
+            s__(
+              'ProjectSettings|Every project can have its own space to store its packages. Note: The Package Registry is always visible when a project is public.',
+            )
           "
         >
           <gl-toggle

doc/user/packages/package_registry/index.md

@@ -114,6 +114,26 @@ You can also remove the Package Registry for your project specifically:
 
 The **Packages & Registries > Package Registry** entry is removed from the sidebar.
 
+## Package Registry visibility permissions
+
+[Project-level permissions](../../permissions.md)
+determine actions such as downloading, pushing, or deleting packages.
+
+The visibility of the Package Registry is independent of the repository and can't be controlled from
+your project's settings. For example, if you have a public project and set the repository visibility
+to **Only Project Members**, the Package Registry is then public. However, disabling the Package
+Registry disables all Package Registry operations.
+
+[GitLab-#329253](https://gitlab.com/gitlab-org/gitlab/-/issues/329253)
+proposes adding the ability to control Package Registry visibility from the UI.  
+
+|                      |                       | Anonymous<br/>(everyone on internet) | Guest | Reporter, Developer, Maintainer, Owner |
+| -------------------- | --------------------- | --------- | ----- | ------------------------------------------ |
+| Public project with Package Registry enabled | View Package Registry <br/> and pull packages | Yes       | Yes   | Yes      |
+| Internal project with Package Registry enabled | View Package Registry <br/> and pull packages | No       | Yes   | Yes      |
+| Private project with Package Registry enabled | View Package Registry <br/> and pull packages | No        | No    | Yes      |
+| Any project with Package Registry disabled | All operations on Package Registry | No | No | No |
+
 ## Supported package managers
 
 WARNING:

locale/gitlab.pot

@@ -29203,7 +29203,7 @@ msgstr ""
 msgid "ProjectSettings|Every project can have its own space to store its Docker images"
 msgstr ""
 
-msgid "ProjectSettings|Every project can have its own space to store its packages."
+msgid "ProjectSettings|Every project can have its own space to store its packages. Note: The Package Registry is always visible when a project is public."
 msgstr ""
 
 msgid "ProjectSettings|Everyone"