Evan Read
5c8545edf1
Merge branch 'docs/unlinking-emails' into 'master'
...
Remove a section for a now fixed bug
See merge request gitlab-org/gitlab-ce!32319
2019-08-28 06:36:58 +00:00
Achilleas Pipinellis
295b1b4d02
Remove a section for a now fixed bug
...
Those guidelines where based on
https://gitlab.com/gitlab-org/gitlab-docs/issues/311 which seems
to be fixed.
2019-08-28 08:10:00 +02:00
Marcel Amirault
d7d218628f
Fix markdown in various docs
...
Clean up issues that may cause the docs-lint
test to fail, such as trailing whitespace, no
EOF newline, blockquotes, etc
2019-08-28 06:06:34 +00:00
Marcel Amirault
afe4d3e5bb
Update docs style for code blocks
...
Clarify rules for code blocks, including spaces
above and below, and to use tilde when code blocks
contain triple backticks
2019-08-16 12:06:00 +00:00
Achilleas Pipinellis
1ac21f7ae6
Add missing (FREE ONLY) docs tier badge
2019-08-13 10:49:06 +03:00
Marcel Amirault
15f9862bb9
Update list information in docs styleguide
...
Explain indentation more carefully, and expand examples
2019-08-13 00:57:36 +00:00
David Kartuzinski
49b598b631
Update styleguide.md - just a little typo.
2019-08-12 14:46:06 +00:00
Marcel Amirault
cc76259e8d
Fix whitespace in ci docs
...
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
will render as being in a code block too, even if not
meant to. This fixes all these issues for most docs in
/development, and cleans up other whitespace issues too
2019-07-31 08:28:51 +00:00
Marcel Amirault
0f7d8c0421
Update links to relative
...
Following the single docs codebase change, all internal links
should be relative. Also cleans up one table
2019-07-25 22:49:13 +00:00
Marcel Amirault
d0a60a7525
Add info about mdl to documentation
2019-07-22 06:03:12 +00:00
Marcel Amirault
7da80b2d36
Update numbered lists for docs standards
...
Ensure that all numbered lists use only 1. and no other numbers.
Also ensure that numbered lists use proper spacing.
2019-07-19 02:20:32 +00:00
Achilleas Pipinellis
99f2c986b5
Move the gitlab-docs project under gitlab-org
...
Search and replace gitlab-com/gitlab-docs with gitlab-org/gitlab-docs.
For https://gitlab.com/gitlab-com/gitlab-docs/issues/310
2019-07-11 15:24:33 +03:00
Markus Koller
385233981a
Centralize config for markdownlint
...
The configuration is currently only specified in CI, by moving it into
`.mdlrc` we get immediate feedback locally in supported editors.
To ensure `mdl` is available it's also added to the `Gemfile`, though
CI will still use the version installed in the `gitlab-docs-lint` image.
2019-07-09 03:01:04 +00:00
Marcel Amirault
73c6477b7e
Changing badges to use parentheses not brackets
...
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
2019-07-08 08:50:38 +00:00
Marcel Amirault
6feda1df3b
Change absolute links to relative
...
Change assorted absolute links to ce and ee docs
to relative links
2019-07-05 16:25:58 +00:00
Evan Read
d05eebe1dd
Fix most bare URLs in project
...
Linting rule not enabled for now
because tooling produces false
positives.
2019-07-02 08:50:00 +00:00
Mike Lewis
1af71196c0
Update styleguide.md to add Notes usage guidelines
2019-07-01 04:28:18 +00:00
Marcel Amirault
20654fb9bf
Enforce consistent prefix for bullet lists
...
Adjusts asterisks to hyphens in assorted docs to allow lint rule to pass
2019-07-01 03:36:23 +00:00
Marcia Ramos
bd9a1f0dd0
Address Mike's review
...
- explictly say not to upload videos
- link videos from any YT account
- embed videos from GL's YT account only
2019-06-27 16:48:02 +00:00
Marcia Ramos
a62d93f909
Docs: require release version in image filenames
2019-06-26 14:07:01 +00:00
Evan Read
e128239340
Add Markdown linting
...
Also adds and one linting rule
and makes project conform to it.
2019-06-25 04:34:55 +00:00
Evan Read
ef95359362
Https many links in docs
2019-06-18 12:23:07 +00:00
Evan Read
c15adde954
Final review feedback applied
2019-05-02 09:55:41 +10:00
Evan Read
f7be93a871
Adjust guidance based on feedback
2019-05-02 09:49:52 +10:00
Evan Read
5d4c926d22
Change the guidance for version text
2019-05-02 09:49:52 +10:00
Evan Read
f185e4bf9e
Adjust how we do version text in docs
2019-05-02 09:49:52 +10:00
Evan Read
c135061ff9
Avoid links requiring permissions
2019-04-29 09:33:08 +00:00
Evan Read
0ffb155994
Add whitespace for list so it renders
2019-04-23 12:06:56 +00:00
Achilleas Pipinellis
21600cc7ed
Document how to use GitLab.com only badges
...
Functionality added in
https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/449
2019-04-22 12:11:50 +00:00
Mike Lewis
4fb50b53ce
Fix anchor links
2019-04-17 21:55:50 +00:00
Mike Lewis
8b8fdad788
Fix capitalization of term
2019-04-17 21:37:54 +00:00
Mike Lewis
d6d823c900
Reduce duplicate language by linking to a SSOT
2019-04-17 21:28:39 +00:00
Mike Lewis
7d9476dc16
Initial content edits
2019-04-17 21:17:39 +00:00
Sid Sijbrandij
ab52ff2e92
ssot as principle
2019-04-16 19:25:48 +00:00
Mike Lewis
5051f5b3d6
Development docs: move some docs content from Handbook and improve content/headings
2019-04-16 05:17:36 +00:00
Mike Lewis
92f0163bc7
Edits to documentation dev doc index
2019-04-08 17:37:45 +00:00
Mike Lewis
64ad62bd91
Improvements to Documentation style and structure information
2019-04-08 17:01:49 +00:00
Evan Read
1cfe83ea5e
Change line length recommendation
2019-03-14 10:57:40 +00:00
Marcel Amirault
9c8dc7ddf6
Docs: Fix broken anchors in development docs
2019-03-05 13:06:32 +00:00
Evan Read
2ee23bb312
Add confidential issue linking guidance
2019-03-01 19:07:47 +00:00
k-nakayama-pg
70c6628076
Fix a typo
2019-02-12 11:36:04 +00:00
Marcia Ramos
7aa251308f
Fixes a typo
2019-01-24 14:19:22 +00:00
Marcia Ramos
0bfd119ee1
Document docs style exceptions
2019-01-24 13:46:51 +00:00
Evan Read
c9f2ccaea1
Promote sections and minor improvements
2019-01-16 11:56:07 +10:00
Evan Read
ca74ba9777
Document four backticks feature in markdown
2019-01-15 13:20:52 +00:00
Achilleas Pipinellis
a45c223606
Fix indentation and markup for Markdown codeblock
2019-01-11 12:48:37 +01:00
Achilleas Pipinellis
b7b7d014f5
Merge branch 'docs/fix-styleguide' into 'master'
...
Fix broken markdown and other lint problems
See merge request gitlab-org/gitlab-ce!24208
2019-01-09 09:55:25 +00:00
carla
50f5f3c721
docs: Fix 'Gilab' typo
2019-01-09 06:28:01 +00:00
Evan Read
868d8ec6e7
Fix broken markdown and other lint problems
2019-01-09 10:37:25 +10:00
Evan Read
4671cb7836
Add API topic template
2019-01-07 14:11:39 +10:00
Evan Read
2268ddc7de
Implement some review comments
...
Also:
- Slight restructure.
- Some Markdown improvements.
2019-01-07 14:11:39 +10:00
Evan Read
40aba81218
Add new styleguide sections for verbs
...
Also fixes spelling, and makes the Markdown style more consistent.
2019-01-07 14:06:55 +10:00
Achilleas Pipinellis
0e078d1a8a
Replace look-alike token with '<your_access_token>'
...
Replace all '9koXpg98eAheJpvBs5tK' occurrences with
'<your_access_token>' in API docs.
2019-01-04 13:19:27 +01:00
Mike Lewis
0197f8cf80
Added additional items formerly in the doc template
2018-12-31 18:07:11 +00:00
Mike Lewis
58e4281477
Another addition formerly in the template
2018-12-31 17:42:05 +00:00
Mike Lewis
bfc67c3ef4
Improvements to Style Guide, bringing it items from template
2018-12-31 17:34:57 +00:00
Mike Lewis
1ca583ed74
Update Content section
2018-12-31 15:02:34 +00:00
Mike Lewis
66b127a5f4
Renamed to Documentation Style Guide
2018-12-31 14:37:03 +00:00
Mike Lewis
10784261e7
Move language about what belongs in docs into Content, other minor improvements
2018-12-31 02:38:58 +00:00
Marcia Ramos
3cfdb0acb2
Docs: updates docs development guidelines
2018-11-12 13:30:41 +00:00
Marcel Amirault
6e2570d2d5
Docs: Update Variable naming
2018-11-11 23:43:25 +00:00
Evan Read
8c9da81cda
Add refined sample linting configuration
...
Also:
- Ensures documentation section adheres to linters.
- Makes other minor improvements.
2018-11-06 13:14:39 +10:00
Evan Read
5e583dc62f
Add linting section to documentation guidelines
2018-09-26 12:47:56 +10:00
Evan Read
d68ee3cea8
Add clarity to EE feature styles for features introduced before and after 9.2
2018-09-25 11:38:51 +00:00
Mike Lewis
15c87796ec
Merge branch 'use-colon-in-lists' into 'master'
...
Add guidance on using colons in bullet lists, and make styleguide adhere closer to styleguide.
Closes #51086
See merge request gitlab-org/gitlab-ce!21549
2018-09-07 21:05:20 +00:00
Brett Walker
b0be58a1b3
Resolve "CE documentation is not CommonMark compliant"
2018-09-06 16:52:18 +00:00
Evan Read
07554a1d4b
Add guidance on using colons in bullet lists, and make styleguide adhere closer to styleguide.
2018-09-06 10:54:02 +10:00
Marcia Ramos
819f6d9bce
Documentation process at GitLab
2018-08-16 09:30:04 +00:00
Achilleas Pipinellis
9982ff3f99
Prefer using direct links in docs styleguide
2018-07-25 09:26:47 +02:00
Marcia Ramos
c4b185fb5a
clarify what "methods" are
2018-06-20 14:13:03 +01:00
Marcia Ramos
25f90286f2
Update styleguide.md with rules for navigation items
2018-06-20 09:48:34 +00:00
Marcia Ramos
cc9928c256
Docs: add the documentation guidelines into its own dir
2018-06-06 11:32:38 +00:00