maverick/docbrown
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Link to @jessitron's blog post in our documentation guides (#8985)

Browse source
This commit is contained in:
Vaidehi Joshi 2020-06-29 10:03:17 -07:00 • committed by GitHub
parent 09e70896fa
commit 33222e430c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 6 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
docs/contributing.md
View file

@ -59,7 +59,12 @@ The docs are a collection of [Markdown files][markdown] that also utilize
For more information on how to use GitDocs read the [GitDocs
guide][gitdocs_guide].
# Regarding style
# Regarding language & style
We ask that you avoid trivializing terms when contributing to documentation.
This includes words like "just", "simply", "easy", "obvious", and
"straightforward". You can learn more about why we want to avoid this kind of
language in [this blog post](https://jessitron.com/2020/06/26/just-dont).
Generally speaking, the documentation hosted on this site is informal. There is
no need to make things more complicated by writing these articles like a