Community mailing list archives

Re: Reflection about documentation.

Daniel Reis
- 08/14/2014 10:42:12
<blockquote cite="" type="cite">
1. Decide how the host these docs and the collaboration process.
4. Let this team draft the initial skeleton and guidelines.
Again, I think is the place to start and
involve odoo in the process.

That's an already WIP then. Great!

<blockquote cite="" type="cite">
2. Create an OCA/docs repository for it.
3. Nominate a small team of lead contributors.
I say +1, but again, IMHO it should be a repository with 100% of people ready to colaborate.

OK, I believe that the "Repository Files" could be our best option, mainly because it's branch-able.
Anyone can collaborate using PRs without the need for technical skills. Probably that's enough.
In case it feels like there's a bottleneck there, remember that GitHub allows to set write-access users per Repo, so it could be decided to have a broader committer policy on the docs repo.