Community mailing list archives

RE: Reflection about documentation.

- 08/12/2014 15:48:30

Well , I joined the community recently and to me, is a nightmare:  no clear indication of where is the stable release (is there any BTW?), a useless forum (complicated rules on who can post, no logic in the order of answers publications, a useless search functionality … what about moving back to a classical phpbb ;-) ?), login page always bring me back to the various trials I made and about which I do not care at all, …


Luckily, the old online documentation is still valuable and would ‘only’ need a refresh to align with v8 and more detailed information for the one who have been digging for more than 2 months. :-)


Documented code is OK but please, not too many videos … Waiting minutes to get a guy explaining things that you can capture in some sec. in a written doc is really cumbersome …


My 2c



De : Nhomar Hernandez []
Envoyé : mardi 12 août 2014 20:52
À : Community
Objet : Re: Reflection about documentation.



On Tue, Aug 12, 2014 at 1:36 PM, Miguel Acebes <> wrote:

@Nhomar, the customers don’t understand code.


But the customer to make decisions need is marketing material, and list of "things" and that not "documentation" that's marketing. and the new is doing pretty well.


And remember when "code" was a science from Nasa's people because you need a huge effort to "understand" code this statement was 100% true, today Python, and a lot of open source technologies are changing that, really empowering people with the right knowledge not with "manuals".


The information is power and I see that the partners don’t want the documentation in the hands of the customers. Great mistake.


Let's see, we can't generalize, we has an offer where we offer a complete path of understanding the tool even before implement ( a different history ) but 99% of "customers" don't read docs, who read docs are "consultants" in a biggest proportion to "say" the "know" that's one of biggest issues of modern approach about information.


The "interpretation" of the "information" + "experience" IS knowledge: "AND THAT IN POWER".


What I am trying to let you know is that the "information IS NOT hidden" it is there, and YOU can push and build the parts you need because I am suposing you have the "Knowledge"... Words are dangerous used in the wrong way.


I wish that Odoo thinks different.


I REALLY people like bug accounting firms are not behind Odoo, because if it is... they will push to whare I am worried the should not.


The things aren’t white or black, aren’t binary 0 or 1, both things are compatible: good code and good documentation.


The merge (0.5) IS a well tested, with a GREAT usability and well documented "code" IMHO, code or nothing, I don't want books telling me how i must manage my company (there are A LOT outside) I need a software as obvious as it can and it is REALLY expensive to acheive 


ah! and this organization don't think like you [1]. Everybody MUST code, AND must understand how these code (the tool) needs to be putted toghther to build a better world. (but again, differnet PoV) you are thinks as a Functional BUsiness Guy and the nickelodeo.... I am thinking as a guy that want access of the "information" to get "experience" that allows me build a "knowledge" that will help me to make my "customers" more profitables, efficients and build a better world.


Then again, "YES " we need more ... but, then, "Are you doing something to change that?", It doesn't matter wht OpenERP SA do, "Are you putting your seed in the field?", that's the REAL question. 




Me ha gustado discutir contigo Nhomar, pero hablas como programador y yo como usuario y aspirante a consultor. Sorry everybody.


>> NOTA IMPORTANTE: El problema es un asunto de paradigmas, cuando te los quitas te das cuenta que las cusas SIEMPRE estuvieron allí, pero debes "creer" y no "suponer"..... Bienvenido a este mundo de nerds/consultores/cantantes y gentes de negocios buscando cosas diferentes para un mundo mejor ;-) 




Nhomar Hernandez

CEO Vauxoo.

Twitter: @nhomar

Odoo Gold Partner

Post to: