diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 4c3e52e01..f15dd2f00 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -1,23 +1,21 @@ - # Contributing -- [Contributing](#contributing) - - [Requirements](#requirements) - - [Creating pull requests](#creating-pull-requests) - - [Commits and commit history](#commits-and-commit-history) - - [Development workflow](#development-workflow) - - [Updates to VS Code](#updates-to-vs-code) - - [Build](#build) - - [Test](#test) - - [Unit tests](#unit-tests) - - [Script tests](#script-tests) - - [Integration tests](#integration-tests) - - [End-to-end tests](#end-to-end-tests) - - [Structure](#structure) - - [Modifications to VS Code](#modifications-to-vs-code) - - [Currently Known Issues](#currently-known-issues) +- [Requirements](#requirements) +- [Creating pull requests](#creating-pull-requests) + - [Commits and commit history](#commits-and-commit-history) +- [Development workflow](#development-workflow) + - [Updates to VS Code](#updates-to-vs-code) + - [Build](#build) +- [Test](#test) + - [Unit tests](#unit-tests) + - [Script tests](#script-tests) + - [Integration tests](#integration-tests) + - [End-to-end tests](#end-to-end-tests) +- [Structure](#structure) + - [Modifications to VS Code](#modifications-to-vs-code) + - [Currently Known Issues](#currently-known-issues) diff --git a/docs/MAINTAINING.md b/docs/MAINTAINING.md index a131c73a5..466e6121d 100644 --- a/docs/MAINTAINING.md +++ b/docs/MAINTAINING.md @@ -19,6 +19,7 @@ - [Docker](#docker) - [Homebrew](#homebrew) - [npm](#npm) +- [Testing](#testing) - [Documentation](#documentation) - [Troubleshooting](#troubleshooting) @@ -214,6 +215,20 @@ We publish code-server as a npm package [here](https://www.npmjs.com/package/cod This is currently automated with the release process. +## Testing + +Our testing structure is laid out under our [Contributing docs](https://coder.com/docs/code-server/latest/CONTRIBUTING#test). + +We hope to eventually hit 100% test converage with our unit tests, and maybe one day our scripts (coverage not tracked currently). + +If you're ever looking to add more tests, here are a few ways to get started: + +- run `yarn test:unit` and look at the coverage chart. You'll see all the uncovered lines. This is a good place to start. +- look at `test/scripts` to see which scripts are tested. We can always use more tests there. +- look at `test/e2e`. We can always use more end-to-end tests. + +Otherwise, talk to a current maintainer and ask which part of the codebase is lacking most when it comes to tests. + ## Documentation ### Troubleshooting