From bf4390fc79b1a3bedb070d6a44d0f90bf981010c Mon Sep 17 00:00:00 2001 From: cellarspoon <cellarspoon@riseup.net> Date: Tue, 25 Jan 2022 22:31:20 +0100 Subject: [PATCH] another pass on intro page wording --- docs/index.md | 28 +++++++++++++++------------- 1 file changed, 15 insertions(+), 13 deletions(-) diff --git a/docs/index.md b/docs/index.md index 1f480980..370df573 100644 --- a/docs/index.md +++ b/docs/index.md @@ -2,26 +2,28 @@ title: Introduction --- +## Who is this for? + Welcome to the Co-op Cloud documentation 🥳 +The documentation is aimed at a technical audience: tech co-ops, collectives and individuals who are curious about Co-op Cloud or are already running and managing Co-op Cloud deployments. + +A more general public may still find these pages useful but if you're just looking for a quick overview of the project from a less technical perspective, you can take a look at [coopcloud.tech](https://coopcloud.tech). + +We'd be happy to hear feedback about our documentation, if it was helpful, what was missing, what was confusing, etc., please [get in touch!](/intro/contact). + +## Quick start + !!! danger "Here be dragons" - This project is still [alpha quality software](https://en.wikipedia.org/wiki/Software_release_life_cycle#Alpha). Please take that into consideration if you are thinking about using this system in production. We're working hard to make Co-op Cloud stable. In the meantime, this is a good time to help us out with initial testing, feedback, ideas or [join in with development](/get-involved/). + This project is still [alpha quality software](https://en.wikipedia.org/wiki/Software_release_life_cycle#Alpha) :bomb: Please take that into consideration if you are thinking about using this system in production. We're working hard to make Co-op Cloud stable. In the meantime, this is a good time to help us out with initial testing, feedback, ideas or [join in with development](/get-involved/). -It is meant primarily for members of technology co-ops and collectives who are interested in working together to: - -- build a digital configuration commons which is independent and sustainable - -- promote solidarity and strive for concrete co-operation within the progressive technology movement - -The documentation focuses on specific needs & functions within the project: - -- [Operators Guide](/operators/): You run a Co-op Cloud instance or want to do so :computer: +- [Operators guide](/operators/): You run a Co-op Cloud instance or want to do so :computer: - [Applications](/applications/): You want to know what applications are supported :nerd: -- [Get Involved](/get-involved): You want to get involved and help out with the project, we've love to see you stick around :heart: +- [Get involved](/get-involved): You'd like to help out with the project, we've love to see you stick around :heart: -- [Maintainers Guide](/maintainers/): You help maintain recipes and ensure things run smoothly for operators :tools: +- [Maintainers guide](/maintainers/): You maintain recipes and ensure things run smoothly for operators :tools: -- [CLI Reference](/cli/): We published our own CLI tool called `abra` and you need a quick reference with additional context :notebook: +- [CLI deference](/cli/): You need a command-line reference (`abra`, `docker`, etc.) with additional context :notebook: