We welcome contributions to True Myth! However, the library is fairly stable and mature, so please follow this basic approach:
For bugs or ideas, please start a conversation before opening a PR:
-
For bugs, start by opening an issue with a clear reproduction. For one, there may be a reason for the existing behavior. For another
-
Do you have an idea for a new feature? Open a discussion about your idea—and check to see if it has already been discussed there (or in the issues from before we had Discussions).
For typos or docs improvements, feel free to go ahead and open a pull request fixing it directly!
Once you have followed the steps above and are working on a new contribution, you can use this basic workflow:
-
Check out the repository:
$ git clone git@github.com:true-myth/true-myth.git
Or, using the GitHub CLI:
$ gh repo clone true-myth/true-myth
-
Install its dependencies:
$ pnpm install
Note that we use Volta to manage our JavaScript toolchain. If you are having problems getting the project, you should start by installing Volta, which will give you the same versions of Node and Yarn we use for development and testing.
-
Run the tests as you work, using
yarn test
oryarn test --watch
. -
Run
yarn type-check
oryarn type-check --watch
to proactively check for type errors. -
Once you have made the changes, commit the changes with a good commit message. Then open a pull request, linking it to the issue or discussion it relates to.