Zack Williams | ad36613 | 2018-05-14 14:45:47 -0700 | [diff] [blame] | 1 | # Copyright 2017-present Open Networking Foundation |
| 2 | # |
| 3 | # Licensed under the Apache License, Version 2.0 (the "License"); |
| 4 | # you may not use this file except in compliance with the License. |
| 5 | # You may obtain a copy of the License at |
| 6 | # |
| 7 | # http://www.apache.org/licenses/LICENSE-2.0 |
| 8 | # |
| 9 | # Unless required by applicable law or agreed to in writing, software |
| 10 | # distributed under the License is distributed on an "AS IS" BASIS, |
| 11 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 12 | # See the License for the specific language governing permissions and |
| 13 | # limitations under the License. |
| 14 | |
Zack Williams | a719e4a | 2018-05-16 14:44:36 -0700 | [diff] [blame] | 15 | # markdownlint(mdl) relaxed rules file |
| 16 | # |
Matteo Scandolo | 9d96a7d | 2018-05-15 17:22:32 -0700 | [diff] [blame] | 17 | # Rule descriptions: |
| 18 | # https://github.com/markdownlint/markdownlint/blob/master/docs/RULES.md |
Zack Williams | a719e4a | 2018-05-16 14:44:36 -0700 | [diff] [blame] | 19 | # Instructions on modifying the rules file: |
| 20 | # https://github.com/markdownlint/markdownlint/blob/master/docs/creating_styles.md |
Matteo Scandolo | 9d96a7d | 2018-05-15 17:22:32 -0700 | [diff] [blame] | 21 | |
Zack Williams | ad36613 | 2018-05-14 14:45:47 -0700 | [diff] [blame] | 22 | # use all rules |
| 23 | all |
| 24 | |
Zack Williams | a719e4a | 2018-05-16 14:44:36 -0700 | [diff] [blame] | 25 | # Exclude rule: Header levels should only increment by one level at a time |
| 26 | exclude_rule 'MD001' |
| 27 | |
Zack Williams | ad36613 | 2018-05-14 14:45:47 -0700 | [diff] [blame] | 28 | # Indent lists with 4 spaces |
| 29 | rule 'MD007', :indent => 4 |
| 30 | |
Matteo Scandolo | 9d96a7d | 2018-05-15 17:22:32 -0700 | [diff] [blame] | 31 | # Exclude rule: Trailing spaces |
| 32 | exclude_rule 'MD009' |
| 33 | |
Zack Williams | a719e4a | 2018-05-16 14:44:36 -0700 | [diff] [blame] | 34 | # Don't enforce line length limitations |
| 35 | exclude_rule 'MD013' |
| 36 | |
| 37 | # Allow ! and ? as trailing punctuation in headers |
| 38 | rule 'MD026', :punctuation => '.,;:' |
Matteo Scandolo | 9d96a7d | 2018-05-15 17:22:32 -0700 | [diff] [blame] | 39 | |
| 40 | # Exclude rule: Multiple spaces after blockquote symbol |
| 41 | exclude_rule 'MD027' |
| 42 | |
Zack Williams | a719e4a | 2018-05-16 14:44:36 -0700 | [diff] [blame] | 43 | # Numbered lists should have the correct order |
| 44 | rule 'MD029', :style => "ordered" |
| 45 | |
| 46 | # Exclude rule: Fenced code blocks should be surrounded by blank lines |
| 47 | exclude_rule 'MD031' |
| 48 | |
Luca Prete | d34c69c | 2018-05-22 17:44:42 -0700 | [diff] [blame] | 49 | # Exclude rule: Emphasis used instead of a header |
| 50 | exclude_rule 'MD036' |
Matteo Scandolo | c6dbfe6 | 2018-06-26 12:13:40 -0700 | [diff] [blame] | 51 | |
| 52 | # Gitbook won't care about multiple blank lines |
| 53 | exclude_rule 'MD012' |