Contributing

AWARE is Apache-2.0 and accepts contributions. The repository is github.com/GoodCISO/aware.

Getting set up

git clone https://github.com/GoodCISO/aware
cd aware
npm install
npm test

Conventions

  • Tests use the Node built-in test runner: node --test.
  • Standards suites are separated per compliance framework under test/standards/.
  • Browser behaviour is covered by Playwright.
  • Architecture decisions are recorded as ADRs under docs/adr/.

Claim discipline

The project’s rule A capability is only described as implemented when the code exists, is reachable from a runtime path, and is covered by tests. The capability register that governs the AWARE website is maintained from the same standard, and it records what is not implemented as carefully as what is.