Skip to content

Latest commit

 

History

History
99 lines (68 loc) · 4.26 KB

CONTRIBUTING.md

File metadata and controls

99 lines (68 loc) · 4.26 KB
Raw

Contributing to Fontsource

Thanks for supporting Fontsource!

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Questions

For general support or questions, please make a Discussion instead. Issues should be used for bug reports or feature and font requests.

Issues and Pull Requests

Submitting an Issue

Before you submit an issue, please search the issue tracker to prevent duplicates as existing discussion might inform you of workarounds readily available.

For fixing bugs, we need to have the necessary information to reproduce and confirm it. At minimum we would expect device, browser and 3rd-party library usage information, however, it may be necessary to provide a minimal reproducible build for us to reproduce the error. Lack of information may lead to the issue being closed.

You can file issues by filling out an issue form.

Submitting a Pull Request (PR)

  1. Before you submit a PR, please search the repository for an open or closed PR that relates to your submission.

  2. Fork the fontsource/fontsource repository (click the Fork button at the top right of this page).

  3. Clone the repository locally before creating your own branch.

    git clone https://github.com/fontsource/fontsource.git
git checkout -b my-pr-branch main

  4. Create your patch or feature addition, including appropriate test cases in the tests directory.

  5. Ensure all tests and lints pass.

  6. Create a Changeset using pnpm exec changeset and follow the prompts.

  7. On GitHub, send a pull request to fontsource:main.

    • If we suggest changes then:

      • Make the required updates.
      • Re-run the test suites to ensure tests are still passing.
      • Rebase your branch and force push to your GitHub repository (this will update your PR):
      git rebase main -i
git push -f

  8. After your pull request is merged, you can safely delete your branch and pull changes from the main repository.

Development

Fontsource is built completely with Typescript which extends to both the API and website.

After cloning the repo, run:

Ensure you have Corepack enabled:

// Node <16
npm i corepack -g
corepack enable

// Node >16 (comes installed already)
corepack enable

Install packages:

pnpm i

The project uses PNPM Workspaces, thus the packager, API and website should install in one command.

Useful Scripts

  • pnpm run test - Runs tests.

Website Development

More details can be found in the README.md of the website directory.

Submit Documentation

Submitting new or updating documentation for the Fontsource website is painless and doesn't necessarily require much setup. Navigating to website/docs should contain a directory of markdown files. Editing those markdown files will reflect onto the website.

Please note when submitting brand new pages, it would be required to update website/src/configs/docsList.json appropriately for it to reflect on the website sidebar.