From 6aceddaaae1999a69d582d99335d32abda43c3fb Mon Sep 17 00:00:00 2001
From: Franck Cuny <franck@fcuny.net>
Date: Fri, 27 May 2022 12:29:45 -0700
Subject: docs: start documenting gerrit

Change-Id: I8d00bfd71248e1403e8966d74e93941d90462b47
Reviewed-on: https://cl.fcuny.net/c/world/+/83
Reviewed-by: Franck Cuny <franck@fcuny.net>
---
 docs/gerrit.org | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 docs/gerrit.org

diff --git a/docs/gerrit.org b/docs/gerrit.org
new file mode 100644
index 0000000..1b48395
--- /dev/null
+++ b/docs/gerrit.org
@@ -0,0 +1,18 @@
+#+TITLE: Configuration of gerrit
+
+A gerrit instance is running at [[https://cl.fcuny.net][cl.fcuny.net]].
+
+* Permissions
+- branches other than main can be pushed to the server
+- the main branch can only be modified by gerrit
+* Secure configuration
+The file =/var/lib/gerrit/etc/secure.config= is not (yet) managed by nix. The file contains:
+#+begin_src ini
+[auth]
+  registerEmailPrivateKey = <redacted>
+[sendemail]
+  smtpUser = <fastmail user>
+  smtpPass = <fastmail SMTP password>
+[plugin "gerrit-oauth-provider-google-oauth"]
+  client-secret = <google oauth secret>
+#+end_src
-- 
cgit 1.4.1