Files
suwayomi-material-you-webui/CONTRIBUTING.md

40 lines
2.1 KiB
Markdown
Raw Normal View History

2021-10-30 18:51:47 +03:30
# Contributing
## Where should I start?
Everything from https://github.com/Suwayomi/Suwayomi-Server/blob/master/CONTRIBUTING.md#where-should-i-start applies here.
2021-10-30 18:51:47 +03:30
2021-10-30 18:53:17 +03:30
## About this project
### Building the app
See [BUILDING.md](./BUILDING.md) for more information
2021-10-30 18:53:17 +03:30
## Release process
1. Update the changelog
2023-08-14 21:43:18 +02:00
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)
2023-08-14 21:43:18 +02:00
1. See [wWen to update](#when-to-update)
## WebUI to [Server](https://github.com/Suwayomi/Suwayomi-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/>
2023-08-14 21:43:18 +02:00
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`
2021-10-30 18:51:47 +03:30
## Coding Style Guide
2021-10-30 19:24:26 +03:30
**Note:** Some of the bellow are new, refactor the code to match the style guide where you see inconsistency.
2021-10-30 18:51:47 +03:30
- Don't use relative imports.
2021-11-10 22:53:20 +03:30
- 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`.
2023-03-27 21:23:48 +03:30
- Any new or changed string that might be shown to the user must be translated.