From b05936cbfa6c72e158f976e3aa88c83a038f0cfa Mon Sep 17 00:00:00 2001
From: Marcel Amirault <ravlen@gmail.com>
Date: Sun, 5 May 2019 15:59:22 +0000
Subject: [PATCH] Docs: Merge Various EE /doc dirs to CE
---
.../how_to_configure_ldap_gitlab_ee/index.md | 5 +
doc/getting-started/subscription.md | 3 +
doc/git_hooks/git_hooks.md | 5 +
doc/gitlab-basics/create-project.md | 3 +-
doc/install/ldap.md | 7 ++
doc/install/pivotal/index.md | 45 ++++++++
doc/install/requirements.md | 16 ++-
...corporate_contributor_license_agreement.md | 32 +++++-
...ndividual_contributor_license_agreement.md | 28 ++++-
doc/license/README.md | 5 +
doc/raketasks/cleanup.md | 10 ++
doc/subscriptions/billing_table.png | Bin 0 -> 28321 bytes
doc/subscriptions/index.md | 103 ++++++++++++++++++
doc/tools/email.md | 38 +++++++
doc/tools/email1.png | Bin 0 -> 9590 bytes
doc/tools/email2.png | Bin 0 -> 14902 bytes
doc/topics/authentication/index.md | 2 +
doc/topics/autodevops/index.md | 22 ++--
scripts/lint-doc.sh | 2 +-
19 files changed, 305 insertions(+), 21 deletions(-)
create mode 100644 doc/articles/how_to_configure_ldap_gitlab_ee/index.md
create mode 100644 doc/getting-started/subscription.md
create mode 100644 doc/git_hooks/git_hooks.md
create mode 100644 doc/install/ldap.md
create mode 100644 doc/install/pivotal/index.md
create mode 100644 doc/license/README.md
create mode 100644 doc/subscriptions/billing_table.png
create mode 100644 doc/subscriptions/index.md
create mode 100644 doc/tools/email.md
create mode 100644 doc/tools/email1.png
create mode 100644 doc/tools/email2.png
diff --git a/doc/articles/how_to_configure_ldap_gitlab_ee/index.md b/doc/articles/how_to_configure_ldap_gitlab_ee/index.md
new file mode 100644
index 0000000000000..4ce96fcb230c0
--- /dev/null
+++ b/doc/articles/how_to_configure_ldap_gitlab_ee/index.md
@@ -0,0 +1,5 @@
+---
+redirect_to: 'https://docs.gitlab.com/ee/administration/auth/how_to_configure_ldap_gitlab_ee/index.html'
+---
+
+This document was moved to [another location](https://docs.gitlab.com/ee/administration/auth/how_to_configure_ldap_gitlab_ee/index.html).
diff --git a/doc/getting-started/subscription.md b/doc/getting-started/subscription.md
new file mode 100644
index 0000000000000..65999183d4ae4
--- /dev/null
+++ b/doc/getting-started/subscription.md
@@ -0,0 +1,3 @@
+---
+redirect_to: '../subscriptions/index.md'
+---
\ No newline at end of file
diff --git a/doc/git_hooks/git_hooks.md b/doc/git_hooks/git_hooks.md
new file mode 100644
index 0000000000000..9b8ad1578a08a
--- /dev/null
+++ b/doc/git_hooks/git_hooks.md
@@ -0,0 +1,5 @@
+---
+redirect_to: 'https://docs.gitlab.com/ee/push_rules/push_rules.html'
+---
+
+This document was moved to [another location](https://docs.gitlab.com/ee/push_rules/push_rules.html)
diff --git a/doc/gitlab-basics/create-project.md b/doc/gitlab-basics/create-project.md
index 3e99496d53104..785e2ffb6505b 100644
--- a/doc/gitlab-basics/create-project.md
+++ b/doc/gitlab-basics/create-project.md
@@ -16,6 +16,7 @@ To create a project in GitLab:
- [Import a project](../user/project/import/index.md) from a different repository,
if enabled on your GitLab instance. Contact your GitLab admin if this
is unavailable.
+ - Run [CI/CD pipelines for external repositories](https://docs.gitlab.com/ee/ci/ci_cd_for_external_repos/index.html). **[PREMIUM]**
## Blank projects
@@ -57,7 +58,7 @@ Built-in templates are project templates that are:
To use a built-in template on the **New project** page:
-1. On the **Create from template** tab.
+1. On the **Create from template** tab, select the **Built-in** tab.
1. From the list of available built-in templates, click the:
- **Preview** button to look at the template source itself.
- **Use template** button to start creating the project.
diff --git a/doc/install/ldap.md b/doc/install/ldap.md
new file mode 100644
index 0000000000000..a19f0342b6537
--- /dev/null
+++ b/doc/install/ldap.md
@@ -0,0 +1,7 @@
+---
+redirect_to: '../administration/auth/ldap.md'
+---
+
+# GitLab LDAP integration
+
+This document was moved under [`administration/auth/ldap`](../administration/auth/ldap.md).
diff --git a/doc/install/pivotal/index.md b/doc/install/pivotal/index.md
new file mode 100644
index 0000000000000..896e01ad97556
--- /dev/null
+++ b/doc/install/pivotal/index.md
@@ -0,0 +1,45 @@
+# GitLab Pivotal Tile **[PREMIUM ONLY]**
+
+> Introduced in [GitLab Premium][eep] 8.2.
+
+Easily deploy GitLab as a pre-configured appliance using Ops Manager (BOSH) for
+[Pivotal Cloud Foundry][pcf].
+
+## Overview
+
+Enterprise admins want their development toolkit to be more customizable, more
+integrated, and more secure. With Pivotal Cloud Foundry, GitLab is installed and
+scales easily in a highly available environment.
+
+The upgrades are pain-free and well tested. All it takes is upload the new tile
+and click a button to begin the upgrade process.
+
+## Use cases
+
+- You want a highly available deployment with minimal effort. Scale horizontally
+ as your user base grows.
+
+## Features
+
+The GitLab Pivotal Tile is based on [GitLab Premium][eep] and includes nearly all of its features. The features in Premium but _not_ supported on the Tile are:
+
+* PostgreSQL
+* Pages
+* Geo
+* Registry
+* Mattermost
+* Subgroups
+* Elasticsearch
+* Service Desk
+* OAuth & Kerberos Authentication
+
+## Installing GitLab with Pivotal
+
+The product information and installation documentation is hosted on Pivotal's
+website:
+
+- [Product page](https://network.pivotal.io/products/p-gitlab/)
+- [Documentation](https://docs.pivotal.io/partners/gitlab/index.html)
+
+[eep]: https://about.gitlab.com/pricing/
+[pcf]: https://pivotal.io/platform
diff --git a/doc/install/requirements.md b/doc/install/requirements.md
index 9a6c2ce19768c..17099c1d051b8 100644
--- a/doc/install/requirements.md
+++ b/doc/install/requirements.md
@@ -105,8 +105,10 @@ features of GitLab work with MySQL/MariaDB:
1. MySQL support for subgroups was [dropped with GitLab 9.3][post].
See [issue #30472][30472] for more information.
-1. Geo does [not support MySQL](https://docs.gitlab.com/ee/administration/geo/replication/database.html#mysql-replication). This means no supported Disaster Recovery solution if using MySQL. **[PREMIUM ONLY]**
+1. Geo does [not support MySQL](https://docs.gitlab.com/ee/administration/geo/replication/database.html). This means no supported Disaster Recovery solution if using MySQL. **[PREMIUM ONLY]**
1. [Zero downtime migrations](../update/README.md#upgrading-without-downtime) do not work with MySQL.
+1. [Database load balancing](https://docs.gitlab.com/ee/administration/database_load_balancing.html) is
+ supported only for PostgreSQL. **[PREMIUM ONLY]**
1. GitLab [optimizes the loading of dashboard events](https://gitlab.com/gitlab-org/gitlab-ce/issues/31806) using [PostgreSQL LATERAL JOINs](https://blog.heapanalytics.com/postgresqls-powerful-new-join-type-lateral/).
1. In general, SQL optimized for PostgreSQL may run much slower in MySQL due to
differences in query planners. For example, subqueries that work well in PostgreSQL
@@ -141,7 +143,17 @@ On some systems you may need to install an additional package (e.g.
#### Additional requirements for GitLab Geo
-If you are using [GitLab Geo](https://docs.gitlab.com/ee/development/geo.html), the [tracking database](https://docs.gitlab.com/ee/development/geo.html#geo-tracking-database) also requires the `postgres_fdw` extension.
+If you are using [GitLab Geo](https://docs.gitlab.com/ee/development/geo.html):
+
+- We strongly recommend running Omnibus-managed instances as they are actively
+ developed and tested. We aim to be compatible with most external (not managed
+ by Omnibus) databases (for example, AWS RDS) but we do not guarantee
+ compatibility.
+- The
+ [tracking database](https://docs.gitlab.com/ee/development/geo.html#geo-tracking-database)
+ requires the
+ [postgres_fdw](https://www.postgresql.org/docs/9.6/static/postgres-fdw.html)
+ extension.
```
CREATE EXTENSION postgres_fdw;
diff --git a/doc/legal/corporate_contributor_license_agreement.md b/doc/legal/corporate_contributor_license_agreement.md
index e5fc7a3c85fe6..7f08188bd652e 100644
--- a/doc/legal/corporate_contributor_license_agreement.md
+++ b/doc/legal/corporate_contributor_license_agreement.md
@@ -1,3 +1,29 @@
----
-redirect_to: 'README.md'
----
+# Corporate contributor license agreement
+
+You accept and agree to the following terms and conditions for Your present and future Contributions submitted to GitLab B.V.. Except for the license granted herein to GitLab B.V. and recipients of software distributed by GitLab B.V., You reserve all right, title, and interest in and to Your Contributions.
+
+1. Definitions.
+
+ "You" (or "Your") shall mean the copyright owner or legal entity authorized by the copyright owner that is making this Agreement with GitLab B.V.. For legal entities, the entity making a Contribution and all other entities that control, are controlled by, or are under common control with that entity are considered to be a single Contributor. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "Contribution" shall mean the code, documentation or other original works of authorship, including any modifications or additions to an existing work, that is submitted by You to GitLab B.V. for inclusion in, or documentation of, any of the products owned or managed by GitLab B.V. (the "Work"). For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to GitLab B.V. or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, GitLab B.V. for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by You as "Not a Contribution."
+
+2. Grant of Copyright License.
+
+Subject to the terms and conditions of this Agreement, You hereby grant to GitLab B.V. and to recipients of software distributed by GitLab B.V. a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, sublicense, and distribute Your Contributions and such derivative works.
+
+3. Grant of Patent License.
+
+Subject to the terms and conditions of this Agreement, You hereby grant to GitLab B.V. and to recipients of software distributed by GitLab B.V. a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by You that are necessarily infringed by Your Contribution(s) alone or by combination of Your Contribution(s) with the Work to which such Contribution(s) was submitted. If any entity institutes patent litigation against You or any other entity (including a cross-claim or counterclaim in a lawsuit) alleging that your Contribution, or the Work to which you have contributed, constitutes direct or contributory patent infringement, then any patent licenses granted to that entity under this Agreement for that Contribution or Work shall terminate as of the date such litigation is filed.
+
+4. You represent that You are legally entitled to grant the above license. You represent further that each of Your employees is authorized to submit Contributions on Your behalf, but excluding employees that are designated in writing by You as "Not authorized to submit Contributions on behalf of [name of Your corporation here]." Such designations of exclusion for unauthorized employees are to be submitted via email to legal@gitlab.com.
+
+5. You represent that each of Your Contributions is Your original creation (see section 7 for submissions on behalf of others).
+
+6. You are not expected to provide support for Your Contributions, except to the extent You desire to provide support. You may provide support for free, for a fee, or not at all. Unless required by applicable law or agreed to in writing, You provide Your Contributions on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE.
+
+7. Should You wish to submit work that is not Your original creation, You may submit it to GitLab B.V. separately from any Contribution, identifying the complete details of its source and of any license or other restriction (including, but not limited to, related patents, trademarks, and license agreements) of which you are personally aware, and conspicuously marking the work as "Submitted on behalf of a third-party: [named here]".
+
+8. It is Your responsibility to notify GitLab.com when any change is required to the list of designated employees excluded from submitting Contributions on Your behalf per Section 4. Such notification should be sent via email to legal@gitlab.com.
+
+This text is licensed under the [Creative Commons Attribution 3.0 License](https://creativecommons.org/licenses/by/3.0/) and the original source is the Google Open Source Programs Office.
diff --git a/doc/legal/individual_contributor_license_agreement.md b/doc/legal/individual_contributor_license_agreement.md
index e5fc7a3c85fe6..59803aea08006 100644
--- a/doc/legal/individual_contributor_license_agreement.md
+++ b/doc/legal/individual_contributor_license_agreement.md
@@ -1,3 +1,25 @@
----
-redirect_to: 'README.md'
----
+# Individual contributor license agreement
+
+You accept and agree to the following terms and conditions for Your present and future Contributions submitted to GitLab B.V.. Except for the license granted herein to GitLab B.V. and recipients of software distributed by GitLab B.V., You reserve all right, title, and interest in and to Your Contributions.
+
+1. Definitions.
+
+ "You" (or "Your") shall mean the copyright owner or legal entity authorized by the copyright owner that is making this Agreement with GitLab B.V.. For legal entities, the entity making a Contribution and all other entities that control, are controlled by, or are under common control with that entity are considered to be a single Contributor. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "Contribution" shall mean any original work of authorship, including any modifications or additions to an existing work, that is intentionally submitted by You to GitLab B.V. for inclusion in, or documentation of, any of the products owned or managed by GitLab B.V. (the "Work"). For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to GitLab B.V. or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, GitLab B.V. for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by You as "Not a Contribution."
+
+2. Grant of Copyright License. Subject to the terms and conditions of this Agreement, You hereby grant to GitLab B.V. and to recipients of software distributed by GitLab B.V. a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, sublicense, and distribute Your Contributions and such derivative works.
+
+3. Grant of Patent License. Subject to the terms and conditions of this Agreement, You hereby grant to GitLab B.V. and to recipients of software distributed by GitLab B.V. a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by You that are necessarily infringed by Your Contribution(s) alone or by combination of Your Contribution(s) with the Work to which such Contribution(s) was submitted. If any entity institutes patent litigation against You or any other entity (including a cross-claim or counterclaim in a lawsuit) alleging that your Contribution, or the Work to which you have contributed, constitutes direct or contributory patent infringement, then any patent licenses granted to that entity under this Agreement for that Contribution or Work shall terminate as of the date such litigation is filed.
+
+4. You represent that you are legally entitled to grant the above license. If your employer(s) has rights to intellectual property that you create that includes your Contributions, you represent that you have received permission to make Contributions on behalf of that employer, that your employer has waived such rights for your Contributions to GitLab B.V., or that your employer has executed a separate Corporate CLA with GitLab B.V..
+
+5. You represent that each of Your Contributions is Your original creation (see section 7 for submissions on behalf of others). You represent that Your Contribution submissions include complete details of any third-party license or other restriction (including, but not limited to, related patents and trademarks) of which you are personally aware and which are associated with any part of Your Contributions.
+
+6. You are not expected to provide support for Your Contributions, except to the extent You desire to provide support. You may provide support for free, for a fee, or not at all. Unless required by applicable law or agreed to in writing, You provide Your Contributions on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON- INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE.
+
+7. Should You wish to submit work that is not Your original creation, You may submit it to GitLab B.V. separately from any Contribution, identifying the complete details of its source and of any license or other restriction (including, but not limited to, related patents, trademarks, and license agreements) of which you are personally aware, and conspicuously marking the work as "Submitted on behalf of a third-party: [insert_name_here]".
+
+8. You agree to notify GitLab B.V. of any facts or circumstances of which you become aware that would make these representations inaccurate in any respect.
+
+This text is licensed under the [Creative Commons Attribution 3.0 License](https://creativecommons.org/licenses/by/3.0/) and the original source is the Google Open Source Programs Office.
diff --git a/doc/license/README.md b/doc/license/README.md
new file mode 100644
index 0000000000000..4cc387ba95f86
--- /dev/null
+++ b/doc/license/README.md
@@ -0,0 +1,5 @@
+---
+redirect_to: 'https://docs.gitlab.com/ee/user/admin_area/license.html'
+---
+
+This document was moved to [user/admin_area/license](https://docs.gitlab.com/ee/user/admin_area/license.html).
diff --git a/doc/raketasks/cleanup.md b/doc/raketasks/cleanup.md
index e70a009323e71..f5c788af578af 100644
--- a/doc/raketasks/cleanup.md
+++ b/doc/raketasks/cleanup.md
@@ -23,6 +23,16 @@ sudo gitlab-rake gitlab:cleanup:repos
bundle exec rake gitlab:cleanup:repos RAILS_ENV=production
```
+Remove old repository copies from repositories moved to another storage.
+
+```
+# omnibus-gitlab
+sudo gitlab-rake gitlab:cleanup:moved
+
+# installation from source
+bundle exec rake gitlab:cleanup:moved RAILS_ENV=production
+```
+
Clean up local project upload files if they don't exist in GitLab database. The
task attempts to fix the file if it can find its project, otherwise it moves the
file to a lost and found directory.
diff --git a/doc/subscriptions/billing_table.png b/doc/subscriptions/billing_table.png
new file mode 100644
index 0000000000000000000000000000000000000000..acd1b6193eca8da4f6e91f5056717128dbd71c0e
GIT binary patch
literal 28321
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
RZ~JV)$xEw9RY{lz|1T>Yi%|do
literal 0
HcmV?d00001
diff --git a/doc/subscriptions/index.md b/doc/subscriptions/index.md
new file mode 100644
index 0000000000000..b6d16536feef5
--- /dev/null
+++ b/doc/subscriptions/index.md
@@ -0,0 +1,103 @@
+# Subscription setup and management
+
+This page will help get you started with your new subscription or manage an existing one, whether you have subscribed to GitLab.com or self-managed GitLab.
+
+To subscribe, upgrade, or read more about the types of subscriptions, please see [Subscribe to GitLab](../README.md#subscribe-to-gitlab) on the GitLab Documentation landing page.
+
+## Set up GitLab
+
+Learn how GitLab helps you in the stages of the DevOps lifecycle by learning more [about the GitLab product](https://about.gitlab.com/product/), [GitLab features](https://about.gitlab.com/features/), and [GitLab Documentation](../README.md).
+
+### Self-managed: Install GitLab
+
+Take a look at [installing GitLab](https://about.gitlab.com/install/) and our [administrator documentation](../administration/index.md). Then, follow the instructions below under [Your subscription](#your-subscription) to apply your license file.
+
+### GitLab.com: Create a user and group
+
+Start with creating a user account for yourself using our [sign up page](https://gitlab.com/users/sign_in#register-pane).
+
+[GitLab groups](../user/group/index.md) help assemble related projects together allowing you to grant members access to several projects at once. A group is not required if you plan on having [projects](../user/project/) inside a personal namespace.
+
+## Your subscription
+
+You can view and manage subscriptions through our [Customers portal](https://customers.gitlab.com/). Information on applying your subscription is below.
+
+Please also see our [subscription FAQ](https://about.gitlab.com/pricing/licensing-faq/)
+
+### View subscription and seats
+
+To view and manage the subscriptions you have purchased and the number of seats associated with the subscription, please visit and log into the [Customers’ Portal](https://customers.gitlab.com/subscriptions). For more information, please see our [subscription FAQ](https://about.gitlab.com/pricing/licensing-faq/) and [pricing page](https://about.gitlab.com/pricing/), which includes information on our [true-up pricing policy](https://about.gitlab.com/handbook/product/pricing/#true-up-pricing) when adding more users than at the time of purchase.
+
+Please note that this account may have the same email, but is a _separate_ login from your GitLab.com account. If the two accounts are linked together, then you can use the "sign in with GitLab.com account" link underneath the `Sign In` button.
+
+### Change billing information
+
+In the customers portal, go to the `My Account` page, then revise the `Account Details` information and click on the `Update Account` button.
+
+Future purchases will use the information in this section. The email listed in this section is used for the Customers Portal login and for license related email communication.
+
+### Self-managed: Apply your license file
+
+After purchase, the license file is sent to the email address tied to the Customers portal account, which needs to be [uploaded to the GitLab instance](https://docs.gitlab.com/ee/user/admin_area/license.html#uploading-your-license).
+
+### Link your GitLab.com account with your Customers Portal account
+
+NOTE: **Note:** This is *required* for GitLab.com subscriptions.
+
+Once signed into the customers portal, if your account is not already linked, you should be prompted to link your account with a "Link my GitLab Account" button.
+
+You can also go to the [My Account](https://customers.gitlab.com/customers/edit) page to add or change the GitLab.com account link.
+
+### Change the linked GitLab.com account for your Customers Portal account
+
+To change which GitLab.com account is associated with a Customers Portal account, please follow these steps:
+
+1. Log into the [Customers Portal](https://customers.gitlab.com/customers/sign_in).
+1. In a separate browser tab, visit [GitLab.com](https://gitlab.com) to ensure you are not logged in, or if you are, log out.
+1. Back on the Customers Portal page, click [My Account](https://customers.gitlab.com/customers/edit) in the top menu.
+1. Under `Your GitLab.com account`, click the `Change linked account` button.
+1. Have the user you want associated log in to their [GitLab.com](https://gitlab.com) account.
+
+### GitLab.com: Associate your namespace with your subscription
+
+Once your GitLab.com account is linked, you can go to your [Subscriptions](https://customers.gitlab.com/subscriptions) page to choose or change the namespace your subscription applies to.
+
+Please note that you need to be a group owner to associate a group to your subscription.
+
+### Confirm or upgrade your GitLab.com subscription details within GitLab
+
+To see the status of your GitLab.com subscription, you can click on the Billings
+section of the relevant namespace:
+
+* For individuals, this is located at https://gitlab.com/profile/billings under
+in your Settings,
+* For groups, this is located under the group's Settings dropdown, under Billing.
+
+For groups, you can see details of your subscription - including your current
+plan - in the included table:
+
+
+
+| Field | Description |
+| ------ | ------ |
+| Seats in subscription | If this is a paid plan, this represents the number of seats you've paid to support in your group. |
+| Seats currently in use | The number of active seats currently in use. |
+| Max seats used | The highest number of seats you've used. If this exceeds the seats in subscription, you may owe an additional fee for the additional users. |
+| Seats owed | If your max seats used exceeds the seats in your subscription, you'll owe an additional fee for the users you've added. |
+| Subscription start date | The date your subscription started. If this is for a Free plan, this is the date you transitioned off your group's paid plan. |
+| Subscription end date | The date your current subscription will end. This does not apply to Free plans. |
+
+## Need help?
+
+[GitLab's Documentation](https://docs.gitlab.com/) offers a wide range of topics covering the use and administration of GitLab.
+
+We also encourage all users to search our project trackers for known issues and existing feature requests in:
+
+- [GitLab CE](https://gitlab.com/gitlab-org/gitlab-ce/issues/) for features included in all tiers, and
+- [GitLab EE](https://gitlab.com/gitlab-org/gitlab-ee/issues/) for paid-tier features.
+
+These issues are the best avenue for getting updates on specific product plans and for communicating directly with the relevant GitLab team members.
+
+### Contacting Support
+
+Learn more about the tiers of [GitLab Support](https://about.gitlab.com/support/) or [submit a request via the Support Portal](https://support.gitlab.com/hc/en-us/requests/new).
diff --git a/doc/tools/email.md b/doc/tools/email.md
new file mode 100644
index 0000000000000..ab39206ffa401
--- /dev/null
+++ b/doc/tools/email.md
@@ -0,0 +1,38 @@
+# Email from GitLab **[STARTER ONLY]**
+
+As a GitLab administrator you can email GitLab users from within GitLab.
+
+## Overview
+
+GitLab provides a simple tool to email all users or users of a chosen group or
+project right from the admin area. Users will receive the email to their primary
+email address.
+
+## Use-cases
+
+- Notify your users about a new project, a new feature, or a new product launch.
+- Notify your users about a new deployment, or that will be downtime expected
+ for a particular reason.
+
+## Sending emails to users from within GitLab
+
+1. Go to the admin area using the wrench icon in the top right corner and
+ navigate to **Overview > Users > Send email to users**.
+
+ 
+
+1. Compose an email and choose where it will be sent (all users or users of a
+ chosen group or project):
+
+ 
+
+## Unsubscribing from emails
+
+User can choose to unsubscribe from receiving emails from GitLab by following
+the unsubscribe link from the email. Unsubscribing is unauthenticated in order
+to keep the simplicity of this feature.
+
+On unsubscribe, user will receive an email notifying that unsubscribe happened.
+The endpoint that provides the unsubscribe option is rate-limited.
+
+[ee]: https://about.gitlab.com/pricing/
diff --git a/doc/tools/email1.png b/doc/tools/email1.png
new file mode 100644
index 0000000000000000000000000000000000000000..e79ccc3e9a9d815cfcd6b29b449abda6a7d6d33e
GIT binary patch
literal 9590
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
Q{jXI*MD}at7k$6~0K0r&2LJ#7
literal 0
HcmV?d00001
diff --git a/doc/tools/email2.png b/doc/tools/email2.png
new file mode 100644
index 0000000000000000000000000000000000000000..d073c0e42dadbd4adfe92d5883407927315d95ed
GIT binary patch
literal 14902
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
literal 0
HcmV?d00001
diff --git a/doc/topics/authentication/index.md b/doc/topics/authentication/index.md
index 0fc7f57feab63..0531627b7b3f3 100644
--- a/doc/topics/authentication/index.md
+++ b/doc/topics/authentication/index.md
@@ -30,6 +30,8 @@ This page gathers all the resources for the topic **Authentication** within GitL
- [Atlassian Crowd OmniAuth Provider](../../administration/auth/crowd.md)
- [CAS OmniAuth Provider](../../integration/cas.md)
- [SAML OmniAuth Provider](../../integration/saml.md)
+ - [SAML for GitLab.com Groups](https://docs.gitlab.com/ee/user/group/saml_sso/index.html)
+ - [SCIM user provisioning for GitLab.com Groups](https://docs.gitlab.com/ee/user/group/saml_sso/scim_setup.html)
- [Okta SSO provider](../../administration/auth/okta.md)
- [Kerberos integration (GitLab EE)](https://docs.gitlab.com/ee/integration/kerberos.html)
diff --git a/doc/topics/autodevops/index.md b/doc/topics/autodevops/index.md
index 69834f7ae4704..2884458a44c9a 100644
--- a/doc/topics/autodevops/index.md
+++ b/doc/topics/autodevops/index.md
@@ -179,7 +179,7 @@ Those environments are tied to jobs that use [Auto Deploy](#auto-deploy), so
except for the environment scope, they would also need to have a different
domain they would be deployed to. This is why you need to define a separate
`KUBE_INGRESS_BASE_DOMAIN` variable for all the above
-[based on the environment](https://docs.gitlab.com/ee/ci/variables/index.html#limiting-environment-scopes-of-variables-premium).
+[based on the environment](https://docs.gitlab.com/ee/ci/variables/#limiting-environment-scopes-of-environment-variables-premium).
The following table is an example of how the three different clusters would
be configured.
@@ -377,8 +377,8 @@ analysis on the current code and checks for potential security issues. Once the
report is created, it's uploaded as an artifact which you can later download and
check out.
-Any security warnings are also
-[shown in the merge request widget](https://docs.gitlab.com/ee//user/project/merge_requests/sast.html).
+Any security warnings are also shown in the merge request widget. Read more how
+[SAST works](https://docs.gitlab.com/ee/user/application_security/sast/index.html).
NOTE: **Note:**
The Auto SAST stage will be skipped on licenses other than Ultimate.
@@ -396,8 +396,8 @@ to run analysis on the project dependencies and checks for potential security is
report is created, it's uploaded as an artifact which you can later download and
check out.
-Any security warnings are also
-[shown in the merge request widget](https://docs.gitlab.com/ee//user/project/merge_requests/dependency_scanning.html).
+Any security warnings are also shown in the merge request widget. Read more about
+[Dependency Scanning](https://docs.gitlab.com/ee/user/application_security/dependency_scanning/index.html).
NOTE: **Note:**
The Auto Dependency Scanning stage will be skipped on licenses other than Ultimate.
@@ -415,8 +415,8 @@ to search the project dependencies for their license. Once the
report is created, it's uploaded as an artifact which you can later download and
check out.
-Any licenses are also
-[shown in the merge request widget](https://docs.gitlab.com/ee//user/project/merge_requests/license_management.html).
+Any licenses are also shown in the merge request widget. Read more how
+[License Management works](https://docs.gitlab.com/ee/user/application_security/license_management/index.html).
NOTE: **Note:**
The Auto License Management stage will be skipped on licenses other than Ultimate.
@@ -431,8 +431,8 @@ Docker image and checks for potential security issues. Once the report is
created, it's uploaded as an artifact which you can later download and
check out.
-Any security warnings are also
-[shown in the merge request widget](https://docs.gitlab.com/ee//user/project/merge_requests/container_scanning.html).
+Any security warnings are also shown in the merge request widget. Read more how
+[Container Scanning works](https://docs.gitlab.com/ee/user/application_security/container_scanning/index.html).
NOTE: **Note:**
The Auto Container Scanning stage will be skipped on licenses other than Ultimate.
@@ -487,8 +487,8 @@ to perform an analysis on the current code and checks for potential security
issues. Once the report is created, it's uploaded as an artifact which you can
later download and check out.
-Any security warnings are also
-[shown in the merge request widget](https://docs.gitlab.com/ee//user/project/merge_requests/dast.html).
+Any security warnings are also shown in the merge request widget. Read how
+[DAST works](https://docs.gitlab.com/ee/user/application_security/dast/index.html).
NOTE: **Note:**
The Auto DAST stage will be skipped on licenses other than Ultimate.
diff --git a/scripts/lint-doc.sh b/scripts/lint-doc.sh
index f39c64339fe91..5dc27b0a2b255 100755
--- a/scripts/lint-doc.sh
+++ b/scripts/lint-doc.sh
@@ -35,7 +35,7 @@ fi
# Do not use 'README.md', instead use 'index.md'
# Number of 'README.md's as of 2018-03-26
-NUMBER_READMES_CE=44
+NUMBER_READMES_CE=45
NUMBER_READMES_EE=46
FIND_READMES=$(find doc/ -name "README.md" | wc -l)
echo '=> Checking for new README.md files...'
--
GitLab