dev-norms
v2.0.4
Published
Create and maintain developer norms and PR template for your project in your repo.
Downloads
303
Readme
Quickstart
Add developer norms and a PR template to your project by executing:
npx dev-norms create
Manifesto
Sensible defaults are a great way to smoothly kick start a new project. They make life easier in the beginning, but you can always tweak things later on as your needs change. This is true for new packages/libraries/frameworks you download and this is also true for new teams you start or join. Code is written for human consumption, the fact that they can be compiled is a great side effect. Clean code leads to less bugs, less frustration and overall better developer happiness.
Why Do You Need This?
Developer norms are a necessary way to set some ground rules, so your code base can retain some consistency, remain maintainable over the next days, months and years and all developers are on the same page.
Why keep your norms elsewhere, when you can keep them as a living piece of documentation right in your repo.
Usage
There are two main commands create
and update
.
Create
Run npx dev-norms create
to create a starter list of norms in the root of your project, called dev-norms.md
. Keep it relevant and update it to suit your needs.
Update
Run npx dev-norms update --path=.
command to overwrite your norms with the latest norms.
Install to Project (Optional)
If you want team members to be aware of this tool, make it a part of your package.json
file by executing:
npm install --save-dev dev-norms
Contribute New Norms
Feel free to suggest new sensible defaults, by submitting a PR on https://github.com/duluca/dev-norms to update base dev-norms.md
.