Skip to content

Latest commit

 

History

History
62 lines (43 loc) · 2.64 KB

CONTRIBUTING.md

File metadata and controls

62 lines (43 loc) · 2.64 KB
Raw

This guide is best-effort and will be improved as necessary.

Features, bugfixes, and other code

We use npm scripts for building, testing, and linting. Read the scripts to become familiar with our build process. The big ones are:

npm install
npm run build
npm run test
npm run lint-fix

npm prepare is maintained so that anyone can install ts-node from git, which is useful for testing experimental branches and unreleased features.

Source lives in src and is compiled to dist. Some shim files live outside of src so that they can be imported at certain paths. For example, to allow users to import ts-node/register, we have register/index.js which is a shim to compiled code in dist.

dist-raw is for larger chunks of code which are not compiled nor linted because they have been copy-pasted from node's source code.

Documentation

Documentation is written in markdown in website/docs and rendered into a website by Docusaurus.

To edit documentation, modify the markdown files in ./website/docs and the sidebar declaration in ./website/sidebars.js

Docs for the latest stable release live in a docs branch. The "Edit this page" links on the website link to the docs branch so that the website can be improved in parallel with new feature work.

Docs changes for unreleased features are merged to main in the same PR which implements the feature, adds tests, etc. When we release a new version, we merge main with docs, unifying the two.

cd ./website
yarn
yarn start
# Will host live website locally

This site was used to generate the favicon from a high-res PNG export of the SVG. https://realfavicongenerator.net/

Release checklist

We publish using np: https://npm.im/np

  1. Merge docs into main using a pull request, ensuring a consistent squash-merge
  2. Rebuild the README (see instructions above, necessary because npmjs.com renders the readme)
  3. Publish with np
  4. Add changelog to the Github Release; match formatting from previous releases
  5. Move docs branch to head of main
  • this rebuilds the website
  • git push --force origin main:docs
  • avoids merge messiness due to earlier squash-merge from docs to main
  1. If tsconfig schema has changed, send a pull request to schemastore. Example

APIExtractor

npm run api-extractor will update an API report generated by api-extractor which may be useful when generating release notes to detect (breaking) changes in our API surface.

I configured it for my own convenience; it is not a necessary part of our development process.