commit a68fb8aea61196f3e31fda6087e4fef124324b66
parent f6511f7da89d852815cd9c9b58bfa1435e69a060
Author: decentral1se <decentral1se@web>
Date: Thu, 19 Mar 2026 16:37:01 +0100
refactor!: new realistic but also aspirational onboarding
Diffstat:
| M | onboarding.mdwn | | | 88 | +++++++++++++++++++++++++++++++++++++++---------------------------------------- |
1 file changed, 43 insertions(+), 45 deletions(-)
diff --git a/onboarding.mdwn b/onboarding.mdwn
@@ -1,3 +1,5 @@
+Onboarding page
+
The permacomputing ideas and practices are shaped by its community. To actively
participate in the discussion we facilitate moderated services for individuals
and groups: that's the role of the permacomputing infra. We are trying to be as
@@ -8,19 +10,13 @@ networks that together provide the digital infrastructures for these more
common devices and appliances.
Some of these services can be joined by anyone at any time, such as the public
-XMPP and IRC chatrooms, or the email discussion list. However for those who
-want to participate more actively, we also offer access to a web forum, static
-web hosting, git repos and, of course, the permacomputing wiki. To do this we
-maintain a community server which we call Eik. It's gracefully provided by
-[servus.at](https://core.servus.at/en/about/ueber-uns). Existing members of the
-community help maintain the server. We maintain [a bit of sysadmin
-documentation](https://permacomputing.net/eik/) for this machine.
-
-We are currently working towards a simple onboarding process for existing and
-new community members. Our plans involve a single application form for signing
-up and a single username/password for all our community services. This work
-will begin in 2026. For now we are working with duct tape, rusty typewriters,
-pigeons and stamps. This is why it can take a long time for us to respond.
+XMPP and IRC chatrooms, or the email discussion list (see [[community]] page).
+However for those who want to participate more actively, we also offer access
+to a web forum, static web hosting and, of course, the permacomputing wiki. To
+do this we maintain a community server which we call Eik. It's kindly provided
+by [servus.at](https://core.servus.at/en/about/ueber-uns). Existing members of
+the community help maintain the server. We maintain [sysadmin
+documentation](https://permacomputing.net/eik/) for this machine.
## Growth at the speed of trust
@@ -33,28 +29,21 @@ services we provide are subject to these terms. To be sure, this is a quick
fix, eventually we will move to better articulated community guidelines.
Keep in mind all moderation and communication is shared and carried out by
-community members on a volunteer basis. If it's not urgent you can generally
-expect to receive a response within 1-6 weeks when contacting us or requesting
-to join in. Thanks for your patience in advance. Once the new system is in
-place, things should be much easier and faster (famous last words).
+community members on a volunteer basis. Thanks for your patience in advance.
## Overview of the extra services
-### Forum (for individuals)
+### Web Forum (for individuals and groups)
We host and maintain a [permacomputing forum](https://bbs.permacomputing.net/)
-to promote public discussions around permacomputing. The forum is just starting
-and a bit slow for now. It's been waiting for you. To get started, we ask
-everyone to fill in this short community [signup
-form](https://framaforms.org/account-request-permacomputing-forum-1743087976).
+to promote public discussions around permacomputing.
-### Wiki (for individuals)
+### Wiki (for individuals and groups)
We host and maintain the [permacomputing.net wiki](https://permacomputing.net)
-together. For now access is granted on an individual basis for members who are
-already active on the forum.
+together.
### Website hosting (for groups)
@@ -62,32 +51,41 @@ already active on the forum.
We offer the possibility to host your own permacomputing static websites on
Eik. For example,
[berlin.permacomputing.net](https://berlin.permacomputing.net) and
-[top.permacomputing.net](https://top.permacomputing.net) are hosted on Eik.
+[top.permacomputing.net](https://top.permacomputing.net).
+
+## How to join (WIP)
-### Source code hosting (for groups)
+### Account Request through framaforms
-If you are familiar with [Git](https://git-scm.com) and source code hosting, we
-provide a service for those who would like to share their work. All our
-repositories are publicly available on
-[git.permacomputing.net](https://git.permacomputing.net).
+1) New people fill in this form: https://framaforms.org/account-request-permacomputing-forum-1743087976
+2) Swamp work group receives an email and review it (discussion in a dedicated XMPP room)
+3) If the application receives support from >= 2 members with no objections, it is accepted
+4) Someone from swamp work group will create the account on Rauthy
+5) New people receive an email to confirm and activate account
-### Private chatrooms (for groups)
+### What can you access with this account?
-We chat with each other using [XMPP](https://xmpp.org). If you don't already
-have account, we recommend you to use one of the
-[servers](https://joinjabber.org/docs/servers/) listed by the JoinJabber
-collective. You should also read their [Get
-Started](https://joinjabber.org/docs/) section for suggestions on which
-software to use on your computer or phone. We can also recommend using
-[chat.conversejs.org](https://chat.conversejs.org) as a simple web browser
-client. Once members of your permacomputing group are ready, we can setup
-private rooms for your collective.
+* Web forum
+* Web hosting (for groups)
+* Wiki (pending... We are still working on the editorial guidelines. Once it's published you will get access.)
-## How to get help
+### TODO
-Getting access to all the permacomputing community services is quite ad-hoc and
-requires some patience. If anything is unclear, please send an email to
-permacomputing a/t bleu255 d/o/t com.
+- Backups (Backup console access, Cerca db, Rauthy (TBD), General system stuff (/etc, /home))
+ - Send to trash machine, use https://restic.net, document
+- Toolshed people have access to OS for sysadmin maintenance (ssh)
+- Install Rauthy on eik (rust binary)
+- We add Rauthy support to Cerca (web forum)
+- We make SFTP work with Rauthy for web hosting (with systemd alpine containers)
+- Adjust framaform to reflect new infra
+- Re-organise swamp group to do moderation
+- Migrate wiki from borok to eik
+ - Connect wiki to Rauthy
+- Editorial guideline for wiki
+- Cerca user migrations (LURK SMTP, group mail testing, etc.)
+- Cleanup dormant accounts on eik
+- Migrate web ssh users
+- Announce to the world
