Skip to content

Latest commit

 

History

History
36 lines (20 loc) · 1.39 KB

CONTRIBUTING.md

File metadata and controls

36 lines (20 loc) · 1.39 KB

Contributing

You can contribute to the project in various ways:

  • Submissions (Software, sites, useful content)
  • Translations

Generation

For site generation, we use Vitepress, so you'll need a working Node.js environment installed. Refer to its documentation for making changes to Vitepress itself.

You will also need some hands on experience with TypeScript, if you're going to contribute for improving internals.

The root directory is docs/.

Content

All content resides in the docs/wiki/ folder of the repository. Edit them as you would with normal markdown files.

Translations

:::warning This is still a work in progress. :::

See https://vitepress.dev/guide/i18n.

There are two things to translate: content and strings used in Vitepress (Sidebar, nav, etc).

Start by creating a folder in docs/<locale> and write your content in the exact same format.

Then, edit Vitepress strings. This may seem daunting, especially if you haven't used TypeScript or dealt with configurations like these before, but it shouldn't be overly difficult, and you don't have to do it now.

Create your locale file in docs/.vitepress/locales/<locale>.ts, copying over the format from the root English file, and start editing.

Once you're done, add it to Vitepress' config in docs/.vitepress/config.ts. If you've come this far, adding the language shouldn't be too challenging.