40 lines
2.1 KiB
Markdown
40 lines
2.1 KiB
Markdown
# Contributing
|
|
## Where should I start?
|
|
Everything from https://github.com/Suwayomi/Tachidesk-Server/blob/master/CONTRIBUTING.md#where-should-i-start applies here.
|
|
|
|
## About this project
|
|
|
|
### Building the app
|
|
See [BUILDING.md](./BUILDING.md) for more information
|
|
|
|
## Release process
|
|
1. Update the changelog
|
|
1. Copy the content of the [template changelog](CHANGELOG-TEMPLATE.md) to the top of the actual changelog
|
|
2. Create the changelog for the new release with `npm run createChangelog -- --sha <latest commit hash of previous release>` (printed in console)
|
|
3. Copy the changelog to the corresponding position in the template
|
|
4. Create a TL;DR
|
|
2. Update the [version to server version mapping file](versionToServerVersionMapping.json)
|
|
1. See [wWen to update](#when-to-update)
|
|
|
|
## WebUI to [Server](https://github.com/Suwayomi/Tachidesk-Server) mapping
|
|
### Explanation
|
|
For the server to be able to automatically download the latest compatible WebUI version, the [version to server version mapping file](versionToServerVersionMapping.json) has to be provided.<br/>
|
|
|
|
The order of the version mapping is important and has to be sorted by latest WebUI version to the oldest version.<br/>
|
|
The latest version will always be `PREVIEW`.
|
|
|
|
### When to update
|
|
- changes get added that require a new minimum server version
|
|
- **update:** the mapped server version for the `PREVIEW` version
|
|
- releasing a new version
|
|
- **update:** in case the minimum server version has
|
|
- not changed: the latest WebUI version mapping that is not the `PREVIEW` version has to be updated
|
|
- changed: add a new entry below the `PREVIEW` version with the mapped server version from `PREVIEW`
|
|
|
|
## Coding Style Guide
|
|
**Note:** Some of the bellow are new, refactor the code to match the style guide where you see inconsistency.
|
|
- Don't use relative imports.
|
|
- We are using MUI v5, the all stylings must be applied with the new system.
|
|
- Never use the `style` prop, there's always a cleaner solution with `sx` or `styled`.
|
|
- Any new or changed string that might be shown to the user must be translated.
|