-
Notifications
You must be signed in to change notification settings - Fork 10.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore(docs): Add remark lint (#21919)
* WIP add remark-lint * WIP add remark-lint * no inline padding * add all the rules * prefer shell to bash * ignore blog for now * dont lint blog for now * try to fix caching again and remove eslint-plugin-mdx * fix things once and for all * update * run remark again * dont run prettier * $$$ * some errors * more rules * yarn.lock * switch back to prettier for formatting * fixes * update insecure sites * fix less than signs * revert back more stuff * disable bad lint rules * mdash * no-reference-like-urls rule * get rid of old stuff * remove stringify * no write options * re-enable no-inline-padding rule * lockfile * switch to js config * add more comments and group by reasoning * Apply suggestions from code review Co-Authored-By: Michael <184316+muescha@users.noreply.github.com> * fix new docs * Update docs/docs/migrating-from-v1-to-v2.md Co-Authored-By: Michael <184316+muescha@users.noreply.github.com> * code review suggestions * fix * fix escaped | * dont escape characters * format docs remove * fix lint errors * fix title-of-conf * add docs linting to circleci * re-add all the remark stuff to package.json * Update .prettierignore Co-authored-by: Michael <184316+muescha@users.noreply.github.com>
- Loading branch information
1 parent
d6a57db
commit 09054c1
Showing
173 changed files
with
1,607 additions
and
729 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
module.exports = { | ||
plugins: [ | ||
["remark-frontmatter", "yaml"], | ||
"remark-preset-lint-recommended", | ||
"remark-preset-lint-markdown-style-guide", | ||
|
||
// additional remark-lint rules | ||
["remark-lint-list-item-indent", "space"], | ||
"remark-lint-no-duplicate-headings-in-section", | ||
"remark-lint-no-reference-like-url", | ||
["remark-lint-ordered-list-marker-value", "ordered"], | ||
|
||
// We would like these rules to be enabled, but they require significant content changes | ||
// and need additional PRs to be implemented | ||
["remark-lint-emphasis-marker", false], | ||
["remark-lint-heading-increment", false], | ||
["remark-lint-no-heading-punctuation", false], | ||
["remark-lint-list-item-spacing", false], | ||
|
||
// The following rules are disabled because they are inconsistent to the | ||
// Gatsby Style Guide. | ||
|
||
// We use soft-wrapped paragraphs for ease of diffing/translation. | ||
["remark-lint-maximum-line-length", false], | ||
// We don't restrict the length of headings. | ||
["remark-lint-maximum-heading-length", false], | ||
// We use duplicate headings sometimes, e.g. multiple "Directions" in Recipes. | ||
// Use no-duplicate-headings-in-section instead. | ||
["remark-lint-no-duplicate-headings", false], | ||
// We use emphasis as notes or warnings in a couple places, which triggers this rule. | ||
["remark-lint-no-emphasis-as-heading", false], | ||
// YouTube and Giphy embeds in the docs use literal URLs. | ||
["remark-lint-no-literal-urls", false], | ||
// We use `[shortcuts]` for convenience. | ||
["remark-lint-no-shortcut-reference-link", false], | ||
// We use brackets in a lot of places as argument lists and do not want to escape them. | ||
["remark-lint-no-undefined-references", false], | ||
], | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.