Community mailing list archives

Re: Reflection about documentation.

David Arnold
- 08/12/2014 22:30:49
Few want to read all this discussion, it has got somewhat diluted. But it is of utmost relevance and importance. So I bother to give a resume for you:

Basically we have three (non contradictory) opinion tendencies:
  1. Odoo has almost grown up, it will become a serious player in the market. Quality root/english is a prerequisite for future growth. It empowers the whole ecosystem, generates dynamic and is a big argument to "more serious" customers and "more serious" implementation partners. How we can fix that?
  2. Odoo has had a strategy of knowledge retention as part of their revenue model in the past. This explains priorities, which in turn perfectly explain the status quo.
  3. Responsibility is seen within the community, based in honest principles of reciprocity. This, as being political/opinionated notion, explains part of the heat of this discussion.
Somone (Kurt) already made a link to reconcile all this three opinion tendencies - distilling the basic questions:

How can we transform? How can we achieve the next steps in the odoo ecosystem? How much more do we need to professionalize for the "more serious" customer? He's raising the annoyance of a partial "head-in-the-sand attitude" within the ecosystem - Here: In relation to the documentation.

Furthermore some community "fundamentalists" :) came up with some loosly coordineted "call for action" suggestions:
  1. Make Student project and engage 20 Students in setting up a documentation based on existing peaces (remarkable suggestion!)
  2. Move to for better accessibility/ease of use and "dynamic"
  3. Help with translation from Germany and France

Some additional relevant information has been dropped:
  • Odoo plans: Transifex (still not confirmed) as translation tool, gengo as transaltion service. This makes transaltion a secundary issue.
  • Odoo has plans to integrate walk-throughs inplace within the UI. (you might have a look:
  • There are functional books still residing in the launchpad archive. Some might fear them to become "lost in translation" (to github)
  • OCA (Odoo Community Assotiation - the organized part of the community) has plans to adress this topic for its own "organized" projects (who's interested should probably contact Eric Caudal !)
I honorour of it's creator, I want cite the author of this thread, Miguel Acebes, who asks OpenERP SA for an opinion on this topic:

"I would like OpenERP opine that what we are discussing. I think it's important to know your position."

Hope this helps you get back on top of this very valuable discussion!

Regards, David