diff options
author | Phillip Wells <pwells@gitlab.com> | 2022-10-06 19:21:16 +0300 |
---|---|---|
committer | Phillip Wells <pwells@gitlab.com> | 2022-10-06 19:21:16 +0300 |
commit | 355a96e0e2231bee032b43e5df06d5209d80cf67 (patch) | |
tree | 30794f2c4a1275cf9e06ff1a482e5c51a09ac3a4 | |
parent | c8701815aca5f4a54d99b73e0f899c533b53f647 (diff) | |
parent | c4fd7ecdba33339e8d35355207642c268a17eb29 (diff) |
Merge branch 'add-preview-note' into 'main'
Add info on previewing the docs using navigation
See merge request https://gitlab.com/gitlab-org/gitlab-docs/-/merge_requests/3156
Merged-by: Phillip Wells <pwells@gitlab.com>
Approved-by: Phillip Wells <pwells@gitlab.com>
Co-authored-by: Jonathan Glassman <jglassman@gitlab.com>
-rw-r--r-- | doc/setup.md | 28 |
1 files changed, 23 insertions, 5 deletions
diff --git a/doc/setup.md b/doc/setup.md index 42e6bff6..0593864c 100644 --- a/doc/setup.md +++ b/doc/setup.md @@ -48,13 +48,31 @@ they can be previewed. ## Preview GitLab Docs -To preview GitLab Docs locally, run the following in the checkout of `gitlab-docs`: +To preview GitLab Docs locally: -```shell -make view -``` +1. Run the following in the checkout of `gitlab-docs`: + + ```shell + make view + ``` + + The preview loads in your terminal. When the preview has finished loading, + your terminal outputs the following or something similar: + + ```shell + INFO: Starting GitLab documentation site... + View the site at http://127.0.0.1:3000/ + ``` + +1. To open your preview, go to the URL from your terminal output in your browser. + For this example, go to `http://127.0.0.1:3000/`. + +1. From your preview homepage, use the docs site navigation to go to the page you + want to preview. + + Do not use the search box, as search results take you to the live docs site. -If you make changes to any of the documentation in any of the documentation projects, rerun `make view` to see an +1. If you make changes to any of the documentation in any of the documentation projects, rerun `make view` to see an updated preview. ### Preview on mobile |