mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-23 17:41:41 +00:00
add hint to markdownlint
In the longer term, the use of a linter (similar to pylint for Python) may contribute to easier maintenance of the markdown files and consistent display of the content on the web page.
This commit is contained in:
parent
eddf5accb8
commit
23a2d02f7f
@ -19,6 +19,9 @@ review them more effectively and/or individually.
|
|||||||
* **Keep lines under 80 chars**
|
* **Keep lines under 80 chars**
|
||||||
* Try to keep **line length in code blocks to 80 characters or fewer**.
|
* Try to keep **line length in code blocks to 80 characters or fewer**.
|
||||||
* Otherwise, the text will overflow and look odd.
|
* Otherwise, the text will overflow and look odd.
|
||||||
|
* This and other potential pitfalls to format the content consistently are
|
||||||
|
identified by the freely available
|
||||||
|
[markdownlint](https://github.com/markdownlint/markdownlint).
|
||||||
* **Prefer example to exposition**
|
* **Prefer example to exposition**
|
||||||
* Try to use as few words as possible.
|
* Try to use as few words as possible.
|
||||||
* Code examples are preferred over exposition in all cases.
|
* Code examples are preferred over exposition in all cases.
|
||||||
|
Loading…
Reference in New Issue
Block a user