Marcel Amirault authored 5 years ago and Achilleas Pipinellis committed 5 years ago

Fix capitalization in docs for works like GitLab, Git
Omnibus, etc

This fixes a regression that does not permit spaces in subgraph titles.

Full details: https://github.com/knsv/mermaid/releases

Marcel Amirault authored 5 years ago and Achilleas Pipinellis committed 5 years ago

Deletes extra spaces and line, makes lists consistent, and
fixes links.

Mermaid v8.2.3 added support for styling in subgraphs, but if there are
multiple words in a title, quotes are required.

* https://github.com/knsv/mermaid/pull/845
* https://github.com/knsv/mermaid/issues/391#issuecomment-495602059

Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/65338

Marcel Amirault authored 5 years ago and Evan Read committed 5 years ago

Ensure that all numbered lists use only 1. and no other numbers.
Also ensure that numbered lists use proper spacing.

Marcel Amirault authored 5 years ago and Evan Read committed 5 years ago

Many code blocks are 4spaced, and they render in GitLab
without coloring as a result, even though they are
fenced with a language label. If in a list, other items
woll render as being in a code block too, even if not
meant to. This fixes all these issues, and cleans up
minor whitespace issues in /user, /security, /ssh
and /migrate_ci_to_ce docs.

Search and replace gitlab-com/gitlab-docs with gitlab-org/gitlab-docs.
For https://gitlab.com/gitlab-com/gitlab-docs/issues/310

Marcel Amirault authored 5 years ago and Achilleas Pipinellis committed 5 years ago

Previously, we used brackets to denote the tier badges,
but this made Kramdown, the docs site Markdown renderer,
show many warnings when building the site. This is now
fixed by using parentheses instead of square brackets.

This was caused by [PREMIUM] looking like a link to
Kramdown, which couldn't find a URL there.

See:
- https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/484
- https://gitlab.com/gitlab-org/gitlab-ce/issues/63800

Marcel Amirault authored 5 years ago and Evan Read committed 5 years ago

Add backticks around square brackets, or fix links, as necessary.

Evan Read authored 5 years ago and Achilleas Pipinellis committed 5 years ago

Linting rule not enabled for now
because tooling produces false
positives.

Marcel Amirault authored 5 years ago and Evan Read committed 5 years ago

Adjusts asterisks to hyphens in assorted docs to allow lint rule to pass