From f86d8cc70d73556fec03ca530b8c05d6cb12e7cf Mon Sep 17 00:00:00 2001 From: kalarina Date: Sun, 11 Oct 2026 14:01:06 +0000 Subject: [PATCH] Add contributing guide and issue/PR templates --- .github/ISSUE_TEMPLATE/bug_report.md | 27 +++++++++ .github/ISSUE_TEMPLATE/feature_request.md | 18 ++++++ .github/ISSUE_TEMPLATE/station_request.md | 15 +++++ .github/ISSUE_TEMPLATE/translation_fix.md | 12 ++++ .github/PULL_REQUEST_TEMPLATE.md | 16 ++++++ CONTRIBUTING.md | 70 +++++++++++++++++++++++ README.md | 4 ++ 7 files changed, 162 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md create mode 100644 .github/ISSUE_TEMPLATE/station_request.md create mode 100644 .github/ISSUE_TEMPLATE/translation_fix.md create mode 100644 .github/PULL_REQUEST_TEMPLATE.md create mode 100644 CONTRIBUTING.md diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000..25f19d5 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,27 @@ +--- +name: Bug report +about: Something doesn't work as expected +title: "[Bug] " +--- + +**What happened** + + +**Steps to reproduce** + +1. +2. +3. + +**What you expected** + + +**Environment** + +- App version: +- Installed from: Gitea / GitHub / F-Droid / Google Play +- Device and Android version: +- Station (if related): + +**Screenshots or logs** (optional) + diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000..925c384 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,18 @@ +--- +name: Feature request +about: Suggest an idea that fits the app +title: "[Feature] " +--- + + + +**What problem does this solve** + + +**Proposed solution** + + +**Alternatives you considered** + + +- [ ] I'd like to implement this myself diff --git a/.github/ISSUE_TEMPLATE/station_request.md b/.github/ISSUE_TEMPLATE/station_request.md new file mode 100644 index 0000000..4995715 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/station_request.md @@ -0,0 +1,15 @@ +--- +name: Station request +about: Suggest a Lithuanian radio station +title: "[Station] " +--- + + + +- Station name: +- Official website: +- Stream URL: +- Genre: + +- [ ] The station is Lithuanian +- [ ] The stream is official and public diff --git a/.github/ISSUE_TEMPLATE/translation_fix.md b/.github/ISSUE_TEMPLATE/translation_fix.md new file mode 100644 index 0000000..5b7babf --- /dev/null +++ b/.github/ISSUE_TEMPLATE/translation_fix.md @@ -0,0 +1,12 @@ +--- +name: Translation fix +about: Report a wrong or awkward translation +title: "[Translation] " +--- + + + +- Language: +- Screen or place in the app: +- Current text: +- Suggested text: diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..9ede7c9 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,16 @@ +## What does this change + + +## Related issue + +Closes # + +## Checklist + +- [ ] Discussed in an issue first (not needed for small fixes) +- [ ] `./gradlew assembleDebug` builds +- [ ] Tested on a device or emulator (Android version: ) +- [ ] No ads, analytics, trackers or Google Play Services / Firebase dependencies +- [ ] New strings added to `values/strings.xml` (missing translations noted below) +- [ ] Screenshots added for UI changes +- [ ] I agree that my contribution is licensed under GPL-3.0-only diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..f0b5927 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,70 @@ +# Contributing to Fogwave + +Thanks for wanting to help! This guide explains where to contribute, what fits the project and how to send changes. + +## Where to contribute + +| Where | What you can do | +|---|---| +| [Gitea](https://git.skysparkle.cc/kalarina/Fogwave) — main repository | Issues and pull requests (needs an account on git.skysparkle.cc) | +| [GitHub](https://github.com/kalarina-bit/Fogwave) — copy | Issues and pull requests, if you prefer GitHub | + +Pull requests opened on GitHub are reviewed there and then merged into the main repository by the maintainer. + +## Ways to help + +- **Report a bug** — use the *Bug report* template. +- **Suggest a station** — use the *Station request* template. +- **Suggest a feature** — use the *Feature request* template; check [Out of scope](#out-of-scope) first. +- **Fix a translation** — use the *Translation fix* template or send a pull request. +- **Write code** — see [Pull requests](#pull-requests). + +## Before you start + +- **Small changes** (typos, obvious bugs, translation fixes): send a pull request directly. +- **Anything bigger** (new features, UI changes, new dependencies): open an issue first and wait for a go-ahead, so your work isn't wasted. + +## Ground rules + +- No ads, analytics, trackers, crash reporters or accounts. +- No Google Play Services, Firebase or other proprietary libraries — the app must stay buildable for F-Droid. +- New dependencies must be open source and justified in the pull request. +- Be respectful in issues and reviews. + +## Out of scope + +These will not be accepted: + +- Stations from outside Lithuania. +- A light theme or automatic light/dark switching — Fogwave is dark only. +- New UI languages (see [Translations](#translations)). + +## Stations + +A new station must be Lithuanian, have an official public stream (HTTP or HTTPS) and allow playback in third-party players. Include the official website and stream URL in the request. + +## Translations + +Fogwave is available in exactly six languages: English, Russian, German, Japanese, Lithuanian and Chinese. Fixes to these are welcome; new languages are not accepted. + +- App strings: `app/src/main/res/values-/strings.xml` (English is `values/`). +- Store listing: `fastlane/metadata/android//`. + +If your code adds new strings, add them to `values/strings.xml`. Translations for the other languages are welcome but not required — mention missing ones in the pull request. + +## Pull requests + +1. Fork the repository and create a branch from `main`. +2. Keep one topic per pull request. +3. Follow the existing Kotlin and Jetpack Compose style; keep comments short and in English; don't reformat unrelated code. +4. Make sure `./gradlew assembleDebug` builds, and test on a device or emulator. +5. Write short, plain commit messages in English (for example `Fix crash when stream URL is empty`). +6. Add screenshots for UI changes. + +## Security + +Please don't report security issues in public issues. Use [private vulnerability reporting on GitHub](https://github.com/kalarina-bit/Fogwave/security/advisories/new). + +## License + +By contributing, you agree that your contribution is licensed under the [GNU General Public License v3.0 only](LICENSE), the same as the rest of the project. diff --git a/README.md b/README.md index 1e8c56e..1c0abc0 100644 --- a/README.md +++ b/README.md @@ -85,6 +85,10 @@ Release builds are signed only when a keystore is supplied through the `KEYSTORE 2. Add `fastlane/metadata/android//changelogs/.txt`. 3. Tag the commit as `v` (for example `v1.0.11`). +## Contributing + +Bug reports, station suggestions, translation fixes and pull requests are welcome on [Gitea](https://git.skysparkle.cc/kalarina/Fogwave/issues) and [GitHub](https://github.com/kalarina-bit/Fogwave/issues). Please read [CONTRIBUTING.md](CONTRIBUTING.md) first — it explains what fits the project and how to send changes. + ## License [GNU General Public License v3.0 only](LICENSE) (GPL-3.0-only).