docs: align with FTW product vision and ownership - #113
Conversation
Signed-off-by: Fredrik Ahlgren <fredrik@sourceful-labs.com>
Bugbot couldn't run - usage limit reachedBugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit. A user or team admin can review and increase usage limits in the Cursor dashboard. (requestId: serverGenReqId_79697921-fccf-4a46-9711-9e8d1321df94) |
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 409a023518
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| <!-- Sourceful maintains implementation PRs. External users submit issues, | ||
| including driver and documentation requests; see CONTRIBUTING.md. --> |
There was a problem hiding this comment.
When an external user follows this instruction for a documentation correction, GitHub offers no appropriate submission path: .github/ISSUE_TEMPLATE/config.yml disables blank issues, while the only available forms are driver requests and driver bugs requiring device/protocol or reproduction details. The new policy therefore rejects documentation PRs while preventing the requested issue-based alternative; add a documentation/general issue form or enable blank issues.
AGENTS.md reference: AGENTS.md:L10-L14
Useful? React with 👍 / 👎.
| Sourceful maintains this repository. External users contribute through | ||
| [issues](https://github.com/srcfl/device-drivers/issues): device needs, bugs, | ||
| protocol sources and hardware evidence. We do not accept external pull | ||
| requests, including documentation. Acceptance of an issue does not invite an | ||
| external implementation PR. |
There was a problem hiding this comment.
drivers/INTEGRATION_OVERVIEW.md still tells readers in its “Adding a New Device” flow to open a PR (lines 198–204) and advertises community contributions as “PR a .lua file” (line 218). That directly contradicts this newly introduced external-issue-only policy and sends contributors toward submissions maintainers say they will reject; update that guide as part of the policy migration.
AGENTS.md reference: AGENTS.md:L10-L14
Useful? React with 👍 / 👎.
1 participant
Align driver guidance with FTW's shared product direction: mixed equipment, clear device identity, verified limits, distinct telemetry and control support, and hardware evidence. Heat-pump data supports planning before active comfort control.
Sourceful maintains implementation PRs; external users report needs, failures and evidence through issues. Local Lua adaptation remains available under the existing license. Update the guide, README, contribution instructions, driver-writing guide and intake templates consistently. Preserve signing, hardware evidence and release gates.
Validation: changed issue-form YAML and new local links checked;
git diff --checkpassed. No Lua source, manifest, catalog, host contract or signed artifact changes, so driver execution tests are unchanged.Coordinated product direction: srcfl/ftw#1213. Merge the canonical Core vision before this change.
Coordinated changes: srcfl/ftw#1213, srcfl/ftw-webapp#67, srcfl/ftw-app#2, srcfl/ftw-web#10.