added settled style points to contributing.md

This commit is contained in:
Andrew Pardoe 2017-03-20 17:32:10 -07:00
parent 8caa0fe007
commit cc1912bf3a

View File

@ -80,7 +80,16 @@ Please use 4-space indentation to trigger code parsing, rather than [fenced code
std::cout << "This is code.\n";
}
#### Document style decisions
We've discussed and made decisions on a number of document style. Please do not open PRs that revisit these stylistic points:
- The CppCoreGuidelines.md file is a single GH-flavored Markdown file. It is not split into separate chapters.
- We do not use syntax highlighting in the Core Guidelines. See PRs #33, #96, #328, and #779. If you want syntax highlighting you
can either view the "pretty" version at http://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines or do your own post-processing.
- We're sticking with the ASCII character set (outside of the joke at the beginning of the document.) We do not use Unicode em-dashes,
Unicode spaces, or pretty quotes. Lots of people edit this file with their various text editors. ASCII is simple and universally understood.
### Miscellaneous
To avoid line-ending issues, please set `autocrlf = input` and `whitespace =
cr-at-eol` in your git configuration.
To avoid line-ending issues, please set `autocrlf = input` and `whitespace = cr-at-eol` in your git configuration.