debian-mirror-gitlab/doc/user/admin_area/settings/help_page.md

113 lines
4.6 KiB
Markdown
Raw Normal View History

2019-12-21 20:55:43 +05:30
---
2021-01-29 00:20:46 +05:30
stage: none
group: unassigned
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2019-12-21 20:55:43 +05:30
type: howto
---
2021-10-27 15:23:28 +05:30
# Customize the Help and sign-in page messages **(FREE SELF)**
2019-12-21 20:55:43 +05:30
In large organizations, it is useful to have information about who to contact or where
2021-10-27 15:23:28 +05:30
to go for help. You can customize and display this information on the GitLab `/help` page and on
2021-09-30 23:02:18 +05:30
the GitLab sign-in page.
2019-12-21 20:55:43 +05:30
2021-09-30 23:02:18 +05:30
## Add a help message to the Help page
2019-12-21 20:55:43 +05:30
2021-09-30 23:02:18 +05:30
You can add a help message, which is shown at the top of the GitLab `/help` page (for example,
<https://gitlab.com/help>):
2019-12-21 20:55:43 +05:30
2021-11-11 11:23:49 +05:30
1. On the top bar, select **Menu > Admin**.
2021-10-27 15:23:28 +05:30
1. On the left sidebar, select **Settings > Preferences**.
1. Expand **Sign-in and Help page**.
1. In **Additional text to show on the Help page**, enter the information you want to display on `/help`.
1. Select **Save changes**.
You can now see the message on `/help`.
2019-12-21 20:55:43 +05:30
2021-09-30 23:02:18 +05:30
NOTE:
By default, `/help` is visible to unauthenticated users. However, if the
2021-10-27 15:23:28 +05:30
[**Public** visibility level](visibility_and_access_controls.md#restrict-visibility-levels)
2021-09-30 23:02:18 +05:30
is restricted, `/help` is visible only to signed-in users.
2019-12-21 20:55:43 +05:30
2021-10-27 15:23:28 +05:30
## Add a help message to the sign-in page
2021-09-30 23:02:18 +05:30
You can add a help message, which is shown on the GitLab sign-in page. The message appears in a new
section titled **Need Help?**, located below the sign-in page message:
2019-12-21 20:55:43 +05:30
2021-11-11 11:23:49 +05:30
1. On the top bar, select **Menu > Admin**.
2021-10-27 15:23:28 +05:30
1. On the left sidebar, select **Settings > Preferences**.
1. Expand **Sign-in and Help page**.
1. In **Additional text to show on the sign-in page**, enter the information you want to
2021-09-30 23:02:18 +05:30
display on the sign-in page.
2021-10-27 15:23:28 +05:30
1. Select **Save changes**.
You can now see the message on the sign-in page.
2021-09-30 23:02:18 +05:30
## Hide marketing-related entries from the Help page
GitLab marketing-related entries are occasionally shown on the Help page. To hide these entries:
2019-12-21 20:55:43 +05:30
2021-11-11 11:23:49 +05:30
1. On the top bar, select **Menu > Admin**.
2021-10-27 15:23:28 +05:30
1. On the left sidebar, select **Settings > Preferences**.
1. Expand **Sign-in and Help page**.
2021-09-30 23:02:18 +05:30
1. Select the **Hide marketing-related entries from the Help page** checkbox.
1. Select **Save changes**.
2019-12-21 20:55:43 +05:30
2021-09-30 23:02:18 +05:30
## Set a custom Support page URL
2019-12-21 20:55:43 +05:30
2021-09-30 23:02:18 +05:30
You can specify a custom URL to which users are directed when they:
- Select **Support** from the Help dropdown.
- Select **See our website for help** on the Help page.
2021-11-11 11:23:49 +05:30
1. On the top bar, select **Menu > Admin**.
2021-10-27 15:23:28 +05:30
1. On the left sidebar, select **Settings > Preferences**.
1. Expand **Sign-in and Help page**.
1. In the **Support page URL** field, enter the URL.
2021-09-30 23:02:18 +05:30
1. Select **Save changes**.
2019-12-21 20:55:43 +05:30
2021-10-27 15:23:28 +05:30
## Redirect `/help` pages
2021-11-18 22:05:49 +05:30
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43157) in GitLab 13.5.
> - [Feature flag `help_page_documentation_redirect`](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/71737) removed in GitLab 14.4.
> - [Generally available](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/71737) in GitLab 14.4.
2021-10-27 15:23:28 +05:30
The `/help` URL of a GitLab instance displays a basic version of the documentation sourced from the
[`doc` directory](https://gitlab.com/gitlab-org/gitlab/-/tree/master/doc) of GitLab. `/help` links
are often used for contextual help.
You can redirect these `/help` links to either:
- The more navigable and searchable version published at [`docs.gitlab.com`](https://docs.gitlab.com).
- A destination that meets [necessary requirements](#destination-requirements).
2021-11-11 11:23:49 +05:30
1. On the top bar, select **Menu > Admin**.
1. On the left sidebar, select **Settings > Preferences**.
2021-10-27 15:23:28 +05:30
1. Expand **Sign-in and Help page**.
1. In the **Documentation pages URL** field, enter the URL.
1. Select **Save changes**.
### Destination requirements
When redirecting `/help`, GitLab:
- Redirects requests to the specified URL.
- Appends `ee` and the documentation path to the URL.
- Appends `.html` to the URL, and removes `.md` if necessary.
For example, if the URL is set to `https://docs.gitlab.com`, requests for
`/help/user/admin_area/settings/help_page.md` redirect to:
`https://docs.gitlab.com/ee/user/admin_area/settings/help_page.html`.
2019-12-21 20:55:43 +05:30
<!-- ## Troubleshooting
Include any troubleshooting steps that you can foresee. If you know beforehand what issues
one might have when setting this up, or when something is changed, or on upgrading, it's
important to describe those, too. Think of things that may go wrong and include them here.
This is important to minimize requests for support, and to avoid doc comments with
questions that you know someone might ask.
Each scenario can be a third-level heading, e.g. `### Getting error message X`.
If you have none to add when creating a doc, leave this section in place
but commented out to help encourage others to add to it in the future. -->