-
Notifications
You must be signed in to change notification settings - Fork 3
docs: align with FTW product vision and ownership #113
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,7 +1,16 @@ | ||
| # Contributing device drivers | ||
|
|
||
| Thank you for helping add hardware support. Keep each pull request focused on | ||
| one driver or one contract change. | ||
| 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. | ||
|
Comment on lines
+3
to
+7
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
AGENTS.md reference: AGENTS.md:L10-L14 Useful? React with 👍 / 👎. |
||
|
|
||
| Users may adapt Lua drivers locally under the existing license. Local changes | ||
| do not grant release, signing or activation authority. The development steps | ||
| below apply to Sourceful-maintained PRs and local adaptation. Keep Sourceful | ||
| PRs focused on one driver or one contract change. FTW direction lives in | ||
| [the shared vision](https://github.com/srcfl/ftw/blob/master/VISION.md). | ||
|
|
||
| ## Legal sign-off | ||
|
|
||
|
|
@@ -146,7 +155,7 @@ State: | |
| Do not post credentials, full configuration, serial numbers, private addresses | ||
| or energy history from a real site. | ||
|
|
||
| New contributions use the `community` tier. That tier states the current test | ||
| New drivers use the `community` evidence tier. That tier states the current test | ||
| and support evidence; it does not mean the public repo is unofficial or | ||
| unmaintained. A maintainer may promote a driver only after the stated review | ||
| and hardware checks. Control support always uses a separate change and cannot | ||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
When an external user follows this instruction for a documentation correction, GitHub offers no appropriate submission path:
.github/ISSUE_TEMPLATE/config.ymldisables 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 👍 / 👎.