Skip to content
This repository has been archived by the owner on Jan 28, 2024. It is now read-only.

Latest commit

 

History

History
58 lines (36 loc) · 3.22 KB

CONTRIBUTING.md

File metadata and controls

58 lines (36 loc) · 3.22 KB
Raw

Contributing

Contributions are welcome and any help that can be offered is greatly appreciated. Please take a moment to read the entire contributing guide.

This repository uses the Feature Branch Workflow, meaning that development should take place in feat/ branches, with the main branch kept in a stable state. When you submit pull requests, please make sure to fork from and submit back to main.

Other processes and specifications that are in use in this repository are:

Getting started

Ensure you have all prerequisites installed (including any optional ones), as noted in the prerequisites section of the readme file.

If you have Docker installed, there are commands available in package.json (all beginning with test:db) that will help easily with building, starting, stopping, and removing test instances of SQL Server and PostgreSQL.

With those in place, you can fork the repository, clone it, and then run npm ci to install all dependencies. Make a copy of .env.template in the root directory and rename it to .env, configuring the environment variables in the file as required.

Development workflow

After cloning the repository and installing all the dependencies, there are several commands available for local development:

  • npm run build - Runs esbuild to compile code into dist directory
  • npm run lint - Lints everything in src directory
  • npm run jest - Runs Jest over all tests in src directory
  • npm run start:dev - Starts a development server with live reload
  • npm test - Runs npm run lint and npm run jest together

Production workflow

  • npm start - Runs a production version. No live reload.

Documentation style

Documentation (both in markdown files and inline comments) should be written in British English where possible.

Titles and headings should use sentence-style capitalisation, where only the first letter of a sentence and proper nouns are capitalised.

Pull request checklist

Before submitting a pull request back to the main repository, please make sure you have completed the following steps:

  1. Pull request base branch is set to main. All pull requests should be forked from and merged back to main
  2. Run npm test to check the code adheres to the defined ESLint style and that it passes the Jest tests
  3. Run npm run lint:prettier:fix to run the Prettier code formatter over the code
  4. Run npm run lint:licenses if adding or updating production dependencies to check they use permissive licenses

Steps 2. and 4. are automatically run by a pre-commit hook added by Husky.

Issues

Please file your issues here and try to provide as much information in the template as possible/relevant.