mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2025-08-05 06:17:36 +02: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:
@@ -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.
|
||||||
|
Reference in New Issue
Block a user