summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorArun Isaac2022-03-19 23:53:00 +0530
committerArun Isaac2022-03-19 23:53:00 +0530
commitd809f22e0d6e725862fa76388e5b1b669759554b (patch)
tree85b3a36ba8c8f4d8d0866a85f011b2cf6a836838
parent85e1a38692c3833c2a99540793bcc81fb9820617 (diff)
downloadguix-forge-d809f22e0d6e725862fa76388e5b1b669759554b.tar.gz
guix-forge-d809f22e0d6e725862fa76388e5b1b669759554b.tar.lz
guix-forge-d809f22e0d6e725862fa76388e5b1b669759554b.zip
doc: Mention minimum configurability to philosophy.
* README.org (Philosophy), doc/forge.skb (Introduction)[Philosophy]: Mention minimum configurability.
-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