From 744a8b19c730cc66e41d9891b3340a479a3f34fc Mon Sep 17 00:00:00 2001 From: "russell@unturf.com" Date: Mon, 4 May 2026 08:38:24 -0400 Subject: [PATCH] docs: add license page + per-page Permacomputer Preamble footer MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docs/_source/license.rst — new RTD page that literalincludes the repo's LICENSE file (single source of truth, no duplication) - conf.py rst_epilog — appended to every RST source so every doc page carries the Permacomputer Preamble + AGPL-3.0-only notice + link to the full license - index.rst — adds 'Project / License' section to the toctree The LICENSE file already had the full Permacomputer Preamble + complete GNU Affero GPL v3 text (matches the whitepaper version). --- docs/_source/conf.py | 29 +++++++++++++++++++++++++++++ docs/_source/index.rst | 6 ++++++ docs/_source/license.rst | 10 ++++++++++ 3 files changed, 45 insertions(+) create mode 100644 docs/_source/license.rst diff --git a/docs/_source/conf.py b/docs/_source/conf.py index 56ba727..e89a178 100644 --- a/docs/_source/conf.py +++ b/docs/_source/conf.py @@ -42,6 +42,35 @@ html_title = "Aborist API Reference" # Suppress warnings for missing references suppress_warnings = ["ref.doc"] +# Per-page footer: appended to every RST source file before parsing. +# Carries the Permacomputer Preamble; full license at /license. +rst_epilog = """ + +---- + +.. rubric:: Permacomputer Preamble — License: AGPL-3.0-only + +This is free software for the public good of a permacomputer hosted at +`permacomputer.com `_, an always-on computer +by the people, for the people. Durable, easy to repair, & distributed like +tap water for machine learning intelligence. + +The permacomputer is community-owned infrastructure optimized around four +values: + +* **TRUTH** — First principles, math & science, open source code freely + distributed. +* **FREEDOM** — Voluntary partnerships, freedom from tyranny & corporate + control. +* **HARMONY** — Minimal waste, self-renewing systems with diverse thriving + connections. +* **LOVE** — Be yourself without hurting others, cooperation through natural + law. + +NO WARRANTY. Software is provided "AS IS" without warranty of any kind. +Full text: :doc:`/license`. +""" + # Intersphinx mapping (for external doc links) intersphinx_mapping = { "python": ("https://docs.python.org/3", None), diff --git a/docs/_source/index.rst b/docs/_source/index.rst index 4cd4b95..ec988bf 100644 --- a/docs/_source/index.rst +++ b/docs/_source/index.rst @@ -18,6 +18,12 @@ Contents: api/mesh api/cli +.. toctree:: + :maxdepth: 1 + :caption: Project + + license + Indices and tables ================== diff --git a/docs/_source/license.rst b/docs/_source/license.rst new file mode 100644 index 0000000..d6b727e --- /dev/null +++ b/docs/_source/license.rst @@ -0,0 +1,10 @@ +License +======= + +Aborist ships under the **GNU Affero General Public License v3.0 (only)** +with a Permacomputer Preamble. Full text below, sourced from the +``LICENSE`` file at the repository root (single source of truth — this +page just renders it). + +.. literalinclude:: ../../LICENSE + :language: text