ESLint

We use ESLint across all our projects to enforce and encourage higher-quality code.

Enabling a new rule

Testing the rule and pre-applying fixes

Before you can enable the rule, you should test it on the current repo to determine how much code churn the rule will cause. You should also pre-apply fixes for the rule so that the final integration of the updated config is easier.

Configure a dev/test environment

One easy way to get started is to create a Codespace, but you can also use any existing repo clone.

1. Clone the repo.
2. Run npm i -g @fluidframework/build-tools@latest to install the Fluid build tools.
3. Run fluid-build --reinstall --symlink:full to install all deps across all projects, and most importantly, symlink your local copy of the shared ESLint config (in common/build/eslint-config-fluid) to all the projects.
4. Enable the new rule in the shared ESLint config (minimal.js as of 2022-05-17).
5. Run fluid-build -s build:compile -s lint to build and run lint on all projects.
6. Fix any errors and create a PR!

Example PRs:

• #10272

Upgrading ESLint or plugins

To be written.