Tobias Killer
b6cb04c297
Refactor links in order to obey the new convention rule
2021-04-11 00:09:05 +02:00
Andrew David Wong
b546de3b8d
Merge branch 'md-convention-fullreflinks' of https://github.com/tokideveloper/qubes-doc into tokideveloper-md-convention-fullreflinks
2021-04-09 15:26:52 -07:00
Tobias Killer
7250daea53
Rewrite Markdown convention rule: Do not allow reference links
2021-04-09 09:30:39 +02:00
Andrew David Wong
248673e25e
Update instructions for adding doc index links
...
Discussed in QubesOS/qubes-issues#6426
2021-04-08 06:37:48 -07:00
Tobias Killer
ada42d7023
Add Markdown convention rule about full reference links
2021-04-08 11:25:36 +02:00
Maya
820af56761
Add lang + ref tags to frontmatter
...
Those are fields used by the language switcher to correlate pages across
different languages, even if they have different names/paths/titles.
They are generated with the prepare_for_translation.py script.
2021-03-14 16:18:11 +01:00
Maya
8f8a8e50ea
Normalize frontmatter
...
- sort keys
- remove permalink from redirects
2021-03-14 16:18:10 +01:00
Maya
67a92614aa
Markdown formatting fixes
...
- mark all code blocks with ```
- unify empty lines between sections
- adjust list syntax (no space before dash)
- adjust headers to use Atx-style syntax
- remove trailing spaces
2021-03-14 16:18:10 +01:00
Andrew David Wong
6e9d015c50
Add info on adding and updating community links in ToC
...
QubesOS/qubes-issues#4693
2020-12-25 08:21:46 -08:00
Andrew David Wong
7610a66873
Update doc guidelines to reflect completed migration
...
https://github.com/QubesOS/qubes-issues/issues/4693
2020-12-07 22:57:40 -08:00
Andrew David Wong
c02686c6df
Update guidance regarding relative vs. absolute links
2020-12-07 17:09:34 -08:00
Andrew David Wong
c1f1ee902c
Update image linking syntax; use syntax on same page
2020-12-01 21:37:45 -08:00
Andrew David Wong
d33cd36170
Update examples; fix typo
2020-12-01 21:29:22 -08:00
Andrew David Wong
2c3293ddd1
Add missing link
2020-11-29 12:47:10 -08:00
Andrew David Wong
fa826f6066
Add guidelines on duplication and core vs. external docs
...
- Add new "Organizationl guidelines" section
- Add some relevant links in other sections
- Update heading syntax to account for new h3s
- Normalize heading case
2020-11-29 12:43:48 -08:00
Andrew David Wong
63379e80c6
Remove reference-style link guideline
...
Closes #1096
2020-11-23 10:17:10 -08:00
Andrew David Wong
3df2ffa6f6
Add guideline on syntactically distinguishing variables in commands
2020-11-23 07:08:35 -08:00
Andrew David Wong
17021f6cb7
Update doc guidelines regarding HTML, CSS, and images
2020-11-18 22:26:22 -08:00
Andrew David Wong
0e5a97785c
Add information about doc review security
2020-10-27 19:23:57 -07:00
Andrew David Wong
9b9d291256
Recommend universal Atx-style headings
2020-08-29 15:42:03 -05:00
Andrew David Wong
35e7f92bc7
Do not strictly require Atx-style headings on both sides
...
Having the headings on both the left and right sides is more difficult
to edit and maintain, and not much is gained from having them on both
sides. It's still fine to have them on both sides, but this is a
stylistic choice left to the author.
2019-08-09 22:01:50 -05:00
Andrew David Wong
d31c786942
Reorganize files to account for new "External" section
...
QubesOS/qubes-issues#4693
2019-05-26 19:32:45 -05:00
