summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.org2
-rw-r--r--doc/forge.skb7
2 files changed, 8 insertions, 1 deletions
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