Designing the documentation #78

New Issue

decentral1se · 2021-06-19T08:38:03Z

decentral1se commented

2021-06-19 08:38:03 +00:00

I think it would be great to think about how to design the documentation now that we have time and money for it. In our proposal we said we'd do:

High-quality documentation. We want to provide accessible documentation for all users of Co-op Cloud, so that both the technical and social elements of the project are well-understood.

I am thinking about some examples that I thought were wonderful:

Any other examples people know about? It might be cool to try to get in touch with people who are doing this kind of documentation and see if they want to work with us.

We might want to orientate it around "roles", so, individual, tech co-op, tech collective.

mkdocs is pretty rad I think, so I am fine with sticking with it as the technical tool underneath if others are. Also we need to think about #74.

I think it would be great to think about how to design the documentation now that we have time and money for it. In our proposal we said we'd do: > High-quality documentation. We want to provide accessible documentation for all users of Co-op Cloud, so that both the technical and social elements of the project are well-understood. I am thinking about some examples that I thought were wonderful: - https://datprotocol.github.io/how-dat-works/ - https://ssbc.github.io/scuttlebutt-protocol-guide/ - https://handbook.scuttlebutt.nz/ - https://yunohost.org/ - https://docs.drone.io/ - https://docs.djangoproject.com/ Any other examples people know about? It might be cool to try to get in touch with people who are doing this kind of documentation and see if they want to work with us. We might want to orientate it around "roles", so, individual, tech co-op, tech collective. `mkdocs` is pretty rad I think, so I am fine with sticking with it as the technical tool underneath if others are. Also we need to think about https://git.autonomic.zone/coop-cloud/organising/issues/74.

decentral1se added this to the Beta release milestone 2021-06-19 08:38:03 +00:00

decentral1se added the

documentation

label 2021-06-19 08:38:03 +00:00

decentral1se commented

2021-06-21 17:26:33 +00:00

I really like the idea of the "Public Stack" and its docs:

http://publicstack.net:8080/layers/

You can click on the blocks on the left and it unpacks them. That is nice.

I really like the idea of the "Public Stack" and its docs: > http://publicstack.net:8080/layers/ You can click on the blocks on the left and it unpacks them. That is nice.

❤️ 1

decentral1se commented

2021-07-01 13:05:17 +00:00

Manga assisted docs!