Ubuntu Community Governance and Contributing Documentation

[Philipp Kewisch]

Hello Folks,

Together with Aaron [:arraybolt3] from the community, I'm looking to set 
up an initiative to make the documentation on how to contribute as well 
as the community governance documentation more structured and visible. 
Most of this documentation is on wiki.ubuntu.com, which is somewhat 
cumbersome to edit and not very much appealing. There is a lot of 
outdated information as well. My predecessors have started an initiative 
to move some documentation to discourse, but what is missing is a 
frontend that will make it look like real documentation instead of a 
forum post (compare https://anbox-cloud.io/docs which is also backed by 
discourse). I intend to set that up, scoped towards documentation about 
the community. In order to make the community documentation meaningful 
I'd also like to build a contribution opportunity around this effort, 
where interested community members can help get the documentation into 
shape and help create an easy entry way for contributing to Ubuntu for 
others.

I see we already have an Ubuntu Documentation Team, so it seems natural 
for this initiative to live there. However, this area doesn't belong to 
the scope of that team currently. I would like to add our initiative to 
the scope so we don't end up having two different documentation teams. 
This means using the ubuntu-doc mailing list, #ubuntu-doc IRC channel, 
and potentially a project where issues can be filed under one of the 
teams on Launchpad. I'd be eager to hear if there are any reasons not to 
proceed, and if so maybe you have suggestions on how to better position 
this effort.

You can find information about the planned initiative here: 
https://docs.google.com/document/d/1mwDyX37pVqlDYeYZTKuHnUGGpfAdeVspWASvc4gQCXQ/edit

Philipp

-- 
Philipp Kewisch
Community Engineering Manager
Canonical <https://www.canonical.com>