From 3a190a53368f3cf01843e239189659f916aa4930 Mon Sep 17 00:00:00 2001 From: Fredrik Ahlgren Date: Sat, 12 Sep 2026 10:48:59 +0200 Subject: [PATCH] docs: align FTW product vision and ownership Signed-off-by: Fredrik Ahlgren --- CONTRIBUTING.md | 15 +++++++++++++++ README.md | 13 +++++++++++++ index.html | 30 +++++++++++++++--------------- 3 files changed, 43 insertions(+), 15 deletions(-) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..f05d67c --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,15 @@ +# Contributing to the FTW website + +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-web/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. diff --git a/README.md b/README.md index 38ec90a..c41d15f 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,19 @@ The legacy `home.fortytwowatts.com` host is not part of the website redirect. It remains a WebAuthn security identity until the separate passkey migration is complete. +## Product direction and contribution policy + +Use [FTW's vision](https://github.com/srcfl/ftw/blob/master/VISION.md) and +[roadmap](https://github.com/srcfl/ftw/blob/master/docs/roadmap.md) when writing product copy. +Explain mixed-equipment coordination, simple defaults, local control and +visible outcomes. Clearly distinguish implemented capabilities from goals +such as cloud MCP. Do not publish predicted savings as measured results. + +Sourceful maintains the product; Fredrik owns its direction. External users +submit [issues](https://github.com/srcfl/ftw-web/issues), not PRs, including +copy corrections. See [CONTRIBUTING.md](CONTRIBUTING.md). Keep existing license +and historical attribution intact. Inspect rendered copy before publishing. + ## Local dev ```bash diff --git a/index.html b/index.html index eec5aca..4f18cbb 100644 --- a/index.html +++ b/index.html @@ -4,10 +4,10 @@ FTW | Open-source home energy management - + - + @@ -71,7 +71,7 @@
-

Apache-2.0 · Self-hosted · Community maintained

+

Apache-2.0 · Self-hosted · Sourceful maintained

Your home energy, coordinated in the open.

FTW is a local-first home energy management system for solar, batteries, grid and EV charging. Run it on your own hardware, inspect every decision and teach it new devices in Lua.

@@ -129,7 +129,7 @@

Start with the software, not a sales call.

01Raspberry Pi image Recommended 02Docker installer Debian / Ubuntu 03Home Assistant Add-on - 04Build from source Contributors + 04Build from source Developers
@@ -204,8 +204,8 @@

Failure-aware by design

05 / STORE

Keep the history

-

SQLite telemetry and compressed Parquet rolloff keep detailed energy data under operator control.

- SQLite · Parquet +

Detailed energy history stays on the box, with storage and recovery managed by FTW Core.

+ Local history · Core
06 / CONNECT @@ -225,7 +225,7 @@

New hardware should be a driver, not a fork.

  • Start from an existing inverter, meter or charger driver
  • Test with simulators and the same public host API
    • -
  • Contribute the integration back through a pull request
    • +
  • Share device needs and test evidence through an issue
Write a driver @@ -247,7 +247,7 @@

New hardware should be a driver, not a fork.

}) return 1000 end -
hot-editableno build stepPRs welcome
+
hot-editableno build stepIssues welcome
@@ -256,9 +256,9 @@

New hardware should be a driver, not a fork.

The community edition

-

Free software, shared stewardship.

-

Run FTW at home, study it, modify it and use it commercially under Apache-2.0. Development happens in public and Sourceful Energy maintains the core together with project contributors.

-
Apache-2.0Public roadmapCommunity PRs
+

Open source, maintained by Sourceful.

+

Run FTW at home, study it, modify it and use it commercially under Apache-2.0. Sourceful Energy develops and maintains FTW. External users help through issues with bugs, needs and evidence. We do not accept external pull requests.

+
Apache-2.0Public roadmapCommunity issues
@@ -274,10 +274,10 @@

You operate what you run.

Contribute

Make the shared system better.

-

Add a device, reproduce a hardware edge case, improve the planner or sharpen the docs. Open an issue before a large change, then build in public.

+

Report a device need, reproduce a hardware problem or suggest a clearer flow. Open an issue with what you want to achieve; Sourceful handles implementation, including documentation and drivers.

Contribution guide - Pull requests + Report an issue
@@ -308,7 +308,7 @@

Open code. Commercial accountability.

Energy infrastructure you can own.

-

Install it. Read it. Break it safely. Send the fix upstream.

+

Run it. Explore it. Tell us what would make it better.

Get started Star on GitHub @@ -322,7 +322,7 @@

Energy infrastructure you can own.

-
FTWAn open-source project maintained by Sourceful Energy and contributors.
+
FTWAn open-source project maintained by Sourceful Energy.