aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorArun Isaac2021-12-21 00:23:00 +0530
committerArun Isaac2021-12-21 00:23:00 +0530
commit27b0d79373d6afe3b09e52d7448c053a6c082d75 (patch)
tree4f9ca12b81da6731d24cc76ccbd12e06b752c79b
parent45edabc3e8206caf50c7d1b105ebfeec8a82c4e4 (diff)
downloadguix-forge-27b0d79373d6afe3b09e52d7448c053a6c082d75.tar.gz
guix-forge-27b0d79373d6afe3b09e52d7448c053a6c082d75.tar.lz
guix-forge-27b0d79373d6afe3b09e52d7448c053a6c082d75.zip
README: Add README.
* README.org: New file.
-rw-r--r--README.org13
1 files changed, 13 insertions, 0 deletions
diff --git a/README.org b/README.org
new file mode 100644
index 0000000..df0785c
--- /dev/null
+++ b/README.org
@@ -0,0 +1,13 @@
+#+TITLE: guix-forge
+
+/guix-forge/ is a Guix service that lets you run a complete [[https://en.wikipedia.org/wiki/Forge_(software)][software forge]] in the manner of GitHub, GitLab, etc. Unlike other free software forges such as GitLab, Gitea, etc., /guix-forge/ is not a monolith but is an assemblage of several pieces of server software wired up to function as one. In this sense, it is a /meta-service/. /guix-forge/ does for software forges what [[https://mailinabox.email/][Mail-in-a-Box]] does for email.
+
+/guix-forge/ is provided on a best effort basis. Its design is unstable, and open to change. We will try our best to not break your system configuration often, but it might happen.
+
+* Philosophy
+
+In order to empower ordinary users, software should not just be free (as in freedom), but also be simple and easy to deploy, especially for small-scale deployments. /guix-forge/ is therefore minimalistic, and does not require running large database servers such as MariaDB and PostgreSQL.
+
+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. /guile-forge/ tries to be as stateless as possible. Almost all of /guile-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.