diff --git a/docs/federation/handbook.md b/docs/federation/handbook.md deleted file mode 100644 index fd0e70e..0000000 --- a/docs/federation/handbook.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Organising handbook ---- - -## Where do I find "the community"? - -The main place is the [Matrix community chat channels](/intro/contact/#matrix). You'll find a number of folks who are actively interested in the project and/or using `abra` and some of our recipes. Furthermore, Matrix has an excellent network of Cool People :tm: and in practice we've e-met a lot of groups who are interested in Co-op Cloud. - -## Onboarding new project members - -We still haven't worked this out. We're working on it. - -## Gathering new case studies - -We try to gather as many "case studies" as possible, stories & concrete examples of Co-op Cloud being used For Good :tm: See [coopcloud.tech](https://coopcloud.tech) for our existing examples. These studies help people identify what the purpose of the project is. - -## Monthly updates - -We have decided we'll try to do monthly progress updates. These will be published on the Co-op Cloud blog. It's a pretty loose format and we're basically just copy/pasta'ing things to a public pad during the month: ["This month in Co-op Cloud"](https://pad.autonomic.zone/YHKn4vHORmS6wjN1t2zi5A?both). Feel free to add your items to the monthly agenda and they will be included! All the previous posts can be seen [here](https://coopcloud.tech/blog/). diff --git a/docs/federation/join.md b/docs/federation/join.md index a36c5d2..c461e25 100644 --- a/docs/federation/join.md +++ b/docs/federation/join.md @@ -1,5 +1,5 @@ --- -title: Joining the Co-op Cloud Federation (CCF) +title: Join the CCF --- Organisations that are aligned with our values (e.g. [vision](/federation/proposals/federation/#vision), [strategy](/intro/strategy/), [code of co-operation](/federation/code-of-coop/) and [bylaws](/federation/bylaws/)) can apply to join CCF. diff --git a/docs/federation/kite-flying-pad-archive.md b/docs/federation/minutes/kf-archive.md similarity index 100% rename from docs/federation/kite-flying-pad-archive.md rename to docs/federation/minutes/kf-archive.md diff --git a/docs/federation/organisers.md b/docs/federation/organisers.md deleted file mode 100644 index 7e31465..0000000 --- a/docs/federation/organisers.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Organisers ---- - -Welcome to the organisers guide! Organisers are folks who focus on the social work in the project. Speaking for the project at talks, helping new tech co-ops & collectives join, keeping an eye out for funding opportunities, seeing what things come up in the community chats, etc. It's important work. - -
- -- __Organisers Handbook__ - - One-stop shop for all you need to know to organise in the community :sparkles: - - [Read Handbook](/federation/handbook){ .md-button .md-button--primary } - -- __Say Hello First__ - - If you like what you see, but are not sure how to best contribute :speech_left: - - [Get In Touch](/intro/contact/){ .md-button .md-button--primary } - -
- -We're still working out what it looks like to do this kind of work in the project. If you like the idea of this kinda of work and/or are already doing it, please send patches to improve this documentation :rocket: - diff --git a/docs/federation/proposals/federation.md b/docs/federation/proposals/federation.md index 6feaf9e..80375f8 100644 --- a/docs/federation/proposals/federation.md +++ b/docs/federation/proposals/federation.md @@ -1,5 +1,5 @@ --- -title: The Co-op Cloud Federation Proposal +title: CCF --- # The Co-op Cloud Federation Proposal diff --git a/docs/federation/surveys/index.md b/docs/federation/surveys/index.md new file mode 100644 index 0000000..7050176 --- /dev/null +++ b/docs/federation/surveys/index.md @@ -0,0 +1,3 @@ +--- +title: Surveys +--- diff --git a/docs/federation/surveys/usage-2026.md b/docs/federation/surveys/usage-2026.md new file mode 100644 index 0000000..edb00bd --- /dev/null +++ b/docs/federation/surveys/usage-2026.md @@ -0,0 +1,12 @@ +--- +title: Usage Survey (2026) +--- + +Federation member `@hex` conducted our first community usage survey in October 2026. + +> [...] In the end we had 62% coming from Europe, 31% from North America, 1 from Austrailia, and 1 from South America. +85% responded that they maintain recipes, 77% manage services for customers. Almost half added more information on their use cases. +The majority of respondents were "small" organizations. 69% were managing services for themselves or for less than 10 customers, while about 1/3 were what might be described as "medium to large" organizations (with 101-1000 customer organizations). I think this presents a really interesting picture of the Federation, with a diverse ecosystems from tiny to large organizations all interacting and cooperating. + +Here is a link to all the results: [`results.csv`](/results.csv). Please note, +all identifying information has been stripped out. diff --git a/docs/federation/tools.md b/docs/federation/tools.md deleted file mode 100644 index 229fbf8..0000000 --- a/docs/federation/tools.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Digital tools ---- - -- [Public documentation](https://docs.coopcloud.tech/federation) -- [Git hosting](https://git.coopcloud.tech/) -- [Matrix Space](https://matrix.to/#/#coop-cloud-space:autonomic.zone) -- [Website](https://coopcloud.tech/) -- [Single Sign On](https://translate.coopcloud.tech/) -- [Translation](https://translate.coopcloud.tech/) -- [Sheets and time tracking](https://sheets.coopcloud.tech/) -- [Drone CI/CD](https://build.coopcloud.tech) diff --git a/docs/federation/tools/index.md b/docs/federation/tools/index.md new file mode 100644 index 0000000..ca77831 --- /dev/null +++ b/docs/federation/tools/index.md @@ -0,0 +1,3 @@ +--- +title: Digital Tools +--- diff --git a/docs/federation/infra.md b/docs/federation/tools/infra.md similarity index 75% rename from docs/federation/infra.md rename to docs/federation/tools/infra.md index cb7b928..e318e7c 100644 --- a/docs/federation/infra.md +++ b/docs/federation/tools/infra.md @@ -1,7 +1,16 @@ --- -title: Shared Infrastructure Inventory +title: Inventory --- +- [Public documentation](https://docs.coopcloud.tech/federation) +- [Git hosting](https://git.coopcloud.tech/) +- [Matrix Space](https://matrix.to/#/#coop-cloud-space:autonomic.zone) +- [Website](https://coopcloud.tech/) +- [Single Sign On](https://translate.coopcloud.tech/) +- [Translation](https://translate.coopcloud.tech/) +- [Sheets and time tracking](https://sheets.coopcloud.tech/) +- [Drone CI/CD](https://build.coopcloud.tech) + ## Shared repository for fedi maintainers > [coop-cloud-apps](https://git.coopcloud.tech/toolshed/coop-cloud-apps) diff --git a/mkdocs.yml b/mkdocs.yml index ed2da6e..78a6730 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -9,7 +9,6 @@ theme: features: navigation.instant.progress - content.action.edit - - navigation.expand - navigation.indexes - navigation.instant - navigation.path @@ -80,25 +79,17 @@ nav: - "Packaging Handbook": maintainers/handbook.md - maintainers/catalogue.md - "Operators": - - operators/index.md - "New operators Tutorial": operators/tutorial.md - "Operators Handbook": operators/handbook.md - "Federation": - - federation/index.md - - federation/handbook.md - - federation/organisers.md - - federation/kite-flying-pad-archive.md - "Bylaws": federation/bylaws.md - "Finance": federation/finance.md - "Membership": federation/membership.md - - "Joining the Co-op Cloud Federation": federation/join.md + - "Join the CCF": federation/join.md - "Code of Co-operation": federation/code-of-coop.md - - "Shared Infrastructure Inventory": federation/infra.md - "Proposals": - - federation/proposals/index.md - federation/proposals/federation.md - "Resolutions": - - federation/resolutions/index.md - "Draft": - federation/resolutions/index.md - "Passed": @@ -153,9 +144,9 @@ nav: - federation/resolutions/in-progress/046.md - federation/resolutions/index.md - "Minutes": - - federation/minutes/index.md - "Recently": - federation/minutes/2025-12-28.md + - federation/minutes/kf-archive.md - "Archive": - federation/minutes/2024-08-15.md - federation/minutes/2024-04-17.md @@ -163,9 +154,11 @@ nav: - federation/minutes/2024-02-01.md - federation/minutes/2022-03-03.md - federation/minutes/2023-05-03.md - - "Digital Tools": federation/tools.md + - "Digital Tools": + - federation/tools/infra.md + - "Surveys": + - federation/surveys/usage-2026.md - "Funding applications": - - federation/funding-applications/index.md - federation/funding-applications/culture-of-solidarity.md - federation/funding-applications/ford-foundation.md - federation/funding-applications/private-funder.md @@ -185,7 +178,6 @@ nav: - "Specifications": - specs/index.md - "Backups": - - specs/backup/index.md - specs/backup/maintain.md - specs/backup/spec.md