From c214c82daed4b30580550233ec146d932e5a1e6c Mon Sep 17 00:00:00 2001 From: Fredrik Ahlgren Date: Sat, 12 Sep 2026 12:54:48 +0200 Subject: [PATCH] docs: welcome issue-led contributions and Markdown proposals Signed-off-by: Fredrik Ahlgren --- CLAUDE.md | 6 ++++-- CONTRIBUTING.md | 33 ++++++++++++++++++++------------- README.md | 5 +++-- 3 files changed, 27 insertions(+), 17 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 8fd77d1..a941e9e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -7,8 +7,10 @@ this app is a cached projection of it. ## Shared product direction [FTW's vision](https://github.com/srcfl/ftw/blob/master/VISION.md) governs the native client. -Fredrik owns the direction and Sourceful develops it. External users submit -issues, not PRs; see [CONTRIBUTING.md](CONTRIBUTING.md). +Fredrik owns the direction and Sourceful develops it. External PRs are +welcome, preferably based on issues. Work is agentic first: state the problem, +scope and reproducible results. Code and short Markdown proposals follow +[CONTRIBUTING.md](CONTRIBUTING.md). The full product aims for clear live command/outcome feedback, simple charging and useful notifications. Those goals do not remove the current native release diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d284eba..dde0a18 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,15 +1,22 @@ # Contributing to the FTW native app -Sourceful develops this project. Fredrik owns FTW's product direction in -[the shared vision](https://github.com/srcfl/ftw/blob/master/VISION.md). External users submit -[issues](https://github.com/srcfl/ftw-app/issues) with bugs, needs and evidence. -We do not accept external pull requests, including documentation changes. -Acceptance of an issue does not invite an external implementation PR. - -Describe the expected result, what happened, the version and relevant -hardware. You do not need to write code. Keep credentials, keys and private -site data out of public reports. Sourceful selects and implements changes. - -Existing license rights and copyright attributions remain unchanged. -Sourceful implementation PRs should state the user need, coordinate overlap, -include relevant verification and follow the repository's development guide. +Sourceful maintains this repository. Fredrik owns FTW's direction in +[the shared vision](https://github.com/srcfl/ftw/blob/master/VISION.md). +External PRs are welcome, preferably based on an +[issue](https://github.com/srcfl/ftw-app/issues). Small fixes need no separate issue. + +Broad product or architecture ideas may start as short Markdown PRs in the +PR description or relevant maintained docs. Mark proposed behaviour as +proposed. Concrete fixes can include code and tests. Keep task breakdowns +and agent scratch notes out of the repository. + +Work is agentic first: give people and agents a clear problem, scope, +reproducible test steps and actual results. Check agent output before +submitting it. Test changed behaviour and review changed UI in a browser. +Hardware claims need relevant hardware evidence; distinguish simulation +from physical tests and state missing checks. Docs need no hardware tests. +Follow the repository guide and coordinate overlap with open PRs. + +Sourceful reviews and maintains changes. A contribution grants no merge, +release or deployment authority. Existing license rights and attribution +remain unchanged. See [FTW's contribution guide](https://github.com/srcfl/ftw/blob/master/CONTRIBUTING.md). diff --git a/README.md b/README.md index f6d93e0..b367e76 100644 --- a/README.md +++ b/README.md @@ -17,8 +17,9 @@ few routine choices, honest live feedback and reliable daily charging. The native status below is a dated record and its verification gates still apply; the vision does not declare new native features shipped. -Sourceful develops this app. External users submit -[issues](https://github.com/srcfl/ftw-app/issues), not pull requests. +Sourceful develops this app. PRs are welcome, preferably based on +[issues](https://github.com/srcfl/ftw-app/issues). Share a short Markdown +proposal or a focused fix with relevant test evidence. See [CONTRIBUTING.md](CONTRIBUTING.md). ## Shape