Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add docs for ESLint plugin settings and rule options #28059

Merged
merged 9 commits into from
Aug 19, 2021

Conversation

mrmckeb
Copy link
Contributor

@mrmckeb mrmckeb commented Aug 13, 2021

This PR adds documentation for the new rootDir setting (#27918), and for next/no-html-link-for-pages.

Documentation / Examples

  • Make sure the linting passes

Copy link
Collaborator

@housseindjirdeh housseindjirdeh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is great, thank you :)

docs/basic-features/eslint.md Outdated Show resolved Hide resolved
docs/basic-features/eslint.md Outdated Show resolved Hide resolved

This rule can normally locate your `pages` directory automatically.

If you're working in a monorepo, we recommend configuring the [`rootDir`](https://nextjs.org/docs/basic-features/eslint.md#rootDir) setting in `eslint-plugin-next`, which this rule will use to locate your `pages` directory.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you're working in a monorepo, we recommend configuring the [`rootDir`](https://nextjs.org/docs/basic-features/eslint.md#rootDir) setting in `eslint-plugin-next`, which this rule will use to locate your `pages` directory.
If you're working in a monorepo, we recommend configuring the [`rootDir`](/docs/basic-features/eslint.md#rootDir) setting in `eslint-plugin-next`, which `pagesDir` will use to locate your `pages` directory.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this first section need an example, if the second one does?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could add it here, but I worry that users would miss the details and configuration options - WDYT?

errors/no-html-link-for-pages.md Outdated Show resolved Hide resolved
@leerob
Copy link
Member

leerob commented Aug 13, 2021

Looks really good 😄

Co-authored-by: Lee Robinson <me@leerob.io>
@mrmckeb mrmckeb requested a review from leerob August 18, 2021 08:29
@kodiakhq kodiakhq bot merged commit 0d3fb75 into canary Aug 19, 2021
@kodiakhq kodiakhq bot deleted the eslint-plugin-settings-docs branch August 19, 2021 09:07
@vercel vercel locked as resolved and limited conversation to collaborators Jan 28, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants