From 2eb0a3cae0b6f28addc161b90dbcb47d3918f6b1 Mon Sep 17 00:00:00 2001
From: Marco Allegretti <mightymarco4@gmail.com>
Date: Thu, 29 Jan 2026 01:37:18 +0100
Subject: [PATCH] docs: clarify modular governance wording and remove roadmap

---
 README.md                          | 22 ++++++----------------
 backend/src/api/delegation.rs      |  2 +-
 backend/src/voting/mod.rs          |  2 +-
 frontend/src/pages/manifesto.astro |  4 ++--
 4 files changed, 10 insertions(+), 20 deletions(-)

diff --git a/README.md b/README.md
index 7cd13c4..339ed45 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,22 @@
 # Likwid - Modular Governance Platform
 
-**Democracy Design in Practice**
+## Composable Governance Infrastructure
 
-Likwid is an open-source platform for participatory governance, designed to make collective decision-making accessible, transparent, and genuinely democratic. Built for communities, civic organizations, and any group that values structured deliberation over shouting matches.
+A modular toolkit for deliberation, voting, delegation, moderation, and plugins — configure what you need per community.
+
+Likwid is an open-source platform for participatory governance. Assemble decision-making workflows from modular building blocks: deliberation, voting methods, delegation, moderation, and plugins.
 
 > *"We are citizens of the 21st century, but we rely on institutions designed in the 19th century, through means designed in the 13th century. The problem is not democracy, it's the interface."*
 
 ## Philosophy
 
-Likwid implements the principles of **Democracy Design**:
+Likwid implements a set of principles for **modular governance infrastructure**:
 
 - **Information must be understandable**, not just available
 - **Listening matters more than speaking** — structured deliberation over flame wars
 - **Voting should express nuance** — from simple approval to Schulze and quadratic methods
 - **Delegation should be fluid** — trust networks that adapt in real-time
-- **Participation is designed**, not imposed
+- **Governance should be composable** — workflows assembled from modules, not imposed
 
 ## Features
 
@@ -134,18 +136,6 @@ likwid/
 4. **Be pragmatic** — Results over debates
 5. **Find a third way** — Seek solutions that satisfy everyone
 
-## Roadmap
-
-- [x] Core voting infrastructure
-- [x] Plugin system (WASM + builtins)
-- [x] Deliberation phases
-- [x] Comment quality scoring
-- [ ] Advanced voting methods (Schulze, STAR, Quadratic)
-- [ ] Liquid delegation engine
-- [ ] GitLab/GitHub integration - plugin
-- [ ] Mobile-responsive UI
-- [ ] Accessibility audit (WCAG 2.1)
-
 ## License
 
 EUPL-1.2
diff --git a/backend/src/api/delegation.rs b/backend/src/api/delegation.rs
index 32c889b..d2e6282 100644
--- a/backend/src/api/delegation.rs
+++ b/backend/src/api/delegation.rs
@@ -1,7 +1,7 @@
 //! Liquid Delegation API
 //!
 //! Implements fluid, reversible, topic-based vote delegation as described
-//! in the Democracy Design manifesto.
+//! in the project manifesto.
 
 use axum::{
     extract::{Path, Query, State},
diff --git a/backend/src/voting/mod.rs b/backend/src/voting/mod.rs
index 3c81be8..6d85c3a 100644
--- a/backend/src/voting/mod.rs
+++ b/backend/src/voting/mod.rs
@@ -1,6 +1,6 @@
 //! Advanced Voting Methods
 //!
-//! Implements various voting algorithms as described in the Democracy Design manifesto:
+//! Implements various voting algorithms as described in the project manifesto:
 //! - Schulze Method (Condorcet-consistent pairwise comparison)
 //! - STAR Voting (Score Then Automatic Runoff)
 //! - Quadratic Voting (intensity-weighted preferences)
diff --git a/frontend/src/pages/manifesto.astro b/frontend/src/pages/manifesto.astro
index 4ee0ddf..4b9452c 100644
--- a/frontend/src/pages/manifesto.astro
+++ b/frontend/src/pages/manifesto.astro
@@ -6,7 +6,7 @@ import PublicLayout from '../layouts/PublicLayout.astro';
   <article class="manifesto-page">
     <header class="page-header">
       <span class="page-label">Manifesto</span>
-      <h1>Democracy by Design</h1>
+      <h1>Governance by Design</h1>
       <p class="lead">
         A technical and political vision for governance infrastructure in the digital age.
       </p>
@@ -70,7 +70,7 @@ import PublicLayout from '../layouts/PublicLayout.astro';
     </section>
 
     <section class="manifesto-section">
-      <h2>The Principles of Democracy Design</h2>
+      <h2>Principles for Governance Infrastructure</h2>
       
       <div class="principle-block">
         <h3>1. Information Must Be Understandable, Not Just Available</h3>