From d809f22e0d6e725862fa76388e5b1b669759554b Mon Sep 17 00:00:00 2001
From: Arun Isaac
Date: Sat, 19 Mar 2022 23:53:00 +0530
Subject: doc: Mention minimum configurability to philosophy.

* README.org (Philosophy), doc/forge.skb (Introduction)[Philosophy]:
Mention minimum configurability.
---
 README.org    | 2 ++
 doc/forge.skb | 7 ++++++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/README.org b/README.org
index 855ebdd..3f9a55f 100644
--- a/README.org
+++ b/README.org
@@ -36,3 +36,5 @@ In order to empower ordinary users, software should not just be free (as in free
 While some state is inevitable, server software should strive to be as stateless as an old analog television set. You switch it on, and it works all the time. There are no pesky software updates, and complex hidden state. /guix-forge/ tries to be as stateless as possible. Almost all of /guix-forge's/ state can be version controlled, and the rest are simple files that can be backed up easily.
 
 [[https://drewdevault.com/2018/07/23/Git-is-already-distributed.html][Git is already federated and decentralized]] with email. /guix-forge/ acknowledges this and prefers to support git's [[https://drewdevault.com/2018/07/02/Email-driven-git.html][email driven workflow]] with project discussion, bug reports and patches all happening over email.
+
+/guix-forge/ is opinionated and will not expose all features provided by the software components underlying it. Keeping configuration options to a minimum is necessary to help casual users deploy their own forge, and to reduce the likelihood of configuration bugs.
diff --git a/doc/forge.skb b/doc/forge.skb
index 3bfbcf2..f20e304 100644
--- a/doc/forge.skb
+++ b/doc/forge.skb
@@ -66,7 +66,12 @@ and the rest are simple files that can be backed up easily.])
 email. guix-forge acknowledges this and prefers to support git's ,(ref
 :url "https://drewdevault.com/2018/07/02/Email-driven-git.html"
 :text "email driven workflow") with project discussion, bug reports
-and patches all happening over email.])))
+and patches all happening over email.])
+      (p [guix-forge is opinionated and will not expose all features
+provided by the software components underlying it. Keeping
+configuration options to a minimum is necessary to help casual users
+deploy their own forge, and to reduce the likelihood of configuration
+bugs.])))
   (chapter :title [Tutorial]
     (p [In this tutorial, you will learn how to set up guix-forge to
 host continuous integration for a project. For the purposes of this
-- 
cgit v1.2.3