SONAR-10950 Add doc about org visibility

diff --git a/server/sonar-docs/src/pages/organizations/index.md b/server/sonar-docs/src/pages/organizations/index.md
index 5a6fc29930997e88f2faa59f2a829b4ab4426f8f..7ddec3f8abe106b11097f378442739cd635be8a6 100644 (file)
--- a/server/sonar-docs/src/pages/organizations/index.md
+++ b/server/sonar-docs/src/pages/organizations/index.md
@@ -19,3 +19,5 @@ There are 2 kind of organizations:
 Organizations can be on:
 * **Free plan**. This is the default plan. Every project in an organization on the free plan is public.
 * **Paid plan**. This plan unlocks the ability to have private projects. Go to the "Billing" page of your organization to upgrade it to the paid plan.
+
+Depending on which plan the organization is in, its [visibility](/organizations/organization-visibility) will change.

diff --git a/server/sonar-docs/src/pages/organizations/organization-and-project-privacy.md b/server/sonar-docs/src/pages/organizations/organization-and-project-privacy.md
deleted file mode 100644 (file)
index 639f9ce..0000000
--- a/server/sonar-docs/src/pages/organizations/organization-and-project-privacy.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-title: Organization and Project Privacy
-scope: sonarcloud
----
-
-## TODO

diff --git a/server/sonar-docs/src/pages/organizations/organization-visibility.md b/server/sonar-docs/src/pages/organizations/organization-visibility.md
new file mode 100644 (file)
index 0000000..c9e746d
--- /dev/null
+++ b/server/sonar-docs/src/pages/organizations/organization-visibility.md
@@ -0,0 +1,44 @@
+---
+title: Organization Visibility
+scope: sonarcloud
+---
+
+## Free plan organization
+
+Free plan organizations are public. This means that almost everything is visible to any user - even anonymous ones:
+
+* Projects
+* Issues
+* Quality Profiles
+* Quality Gates
+* Rules
+
+The following pages are restricted:
+
+* Members: to members of the organization
+* Administration pages: to administrators of the organization
+
+## Paid plan organization
+
+Paid plan organizations are private. This means that nothing is visible to non-members of the organization. In other words, you need to be a member of the organization to see:
+
+* Projects - which are private by default
+* Issues
+* Quality Profiles
+* Quality Gates
+* Rules
+* Members
+
+The administration pages are obviously also restricted to administrators of the organization.
+
+### Want to make one project public?
+
+If you are on a paid plan organization but want to make a project public (for instance because you are developing an open-source library), this is possible. You will have to manually make the project public in its "Administration > Permissions" page. Once done, you will notice the "Public" badge on the project.
+
+As soon as you have one public project, the following pages will become visible to any user:
+
+* Projects
+* Issues
+* Rules
+
+"Quality Profiles" and "Quality Gates" pages will remain restricted to members only - since you might not want to unveil some information used by your private projects.

diff --git a/server/sonar-docs/src/tooltips/organizations/subscription-paid-plan.md b/server/sonar-docs/src/tooltips/organizations/subscription-paid-plan.md
index 757d33d3da2184a30fd8e382f8b73aab08a81dee..c3ff2ffc3c9635d7c5576181eec4d8f69eb1d200 100644 (file)
--- a/server/sonar-docs/src/tooltips/organizations/subscription-paid-plan.md
+++ b/server/sonar-docs/src/tooltips/organizations/subscription-paid-plan.md
@@ -2,4 +2,4 @@ This organization is subscribed to a paid plan, allowing private projects. Its p
 
 ---
 
-See also: [Organization and Project Privacy](/organizations/organization-and-project-privacy)
+See also: [Organization Visibility](/organizations/organization-visibility)

diff --git a/server/sonar-docs/src/tooltips/project/visibility-private.md b/server/sonar-docs/src/tooltips/project/visibility-private.md
index 99d9647adae5256e6ce319cb60960ff96e1e8cf4..a12c27388088076ef6be711824e46fa17b8f7b3a 100644 (file)
--- a/server/sonar-docs/src/tooltips/project/visibility-private.md
+++ b/server/sonar-docs/src/tooltips/project/visibility-private.md
@@ -2,4 +2,4 @@ This project is private. Only the members of this organization are able to brows
 
 ---
 
-See also: [Organization and Project Privacy](/organizations/organization-and-project-privacy)
+See also: [Organization Visibility](/organizations/organization-visibility)

diff --git a/server/sonar-docs/src/tooltips/project/visibility-public-paid-org-admin.md b/server/sonar-docs/src/tooltips/project/visibility-public-paid-org-admin.md
index 54b8a3d76d818747d6472d93e12945242f4a106a..fa765b10a90a806f9b4304f34eade17468611647 100644 (file)
--- a/server/sonar-docs/src/tooltips/project/visibility-public-paid-org-admin.md
+++ b/server/sonar-docs/src/tooltips/project/visibility-public-paid-org-admin.md
@@ -2,4 +2,4 @@ This project is public, which means anyone is able to browse its source code. Go
 
 ---
 
-See also: [Organization and Project Privacy](/organizations/organization-and-project-privacy)
+See also: [Organization Visibility](/organizations/organization-visibility)

diff --git a/server/sonar-docs/src/tooltips/project/visibility-public-paid-org.md b/server/sonar-docs/src/tooltips/project/visibility-public-paid-org.md
index 3be0178c80944f76cf4ad5f8c1105f7e9996128b..62e3ee29fb93b8bf91124f64777d1b9d31a977d5 100644 (file)
--- a/server/sonar-docs/src/tooltips/project/visibility-public-paid-org.md
+++ b/server/sonar-docs/src/tooltips/project/visibility-public-paid-org.md
@@ -2,4 +2,4 @@ This project is public, which means anyone is able to browse its source code. Co
 
 ---
 
-See also: [Organization and Project Privacy](/organizations/organization-and-project-privacy)
+See also: [Organization Visibility](/organizations/organization-visibility)