Community mailing list archives

Re: Reflection about documentation.

Vauxoo S.A. de C.V., Nhomar Hernandez
- 08/12/2014 14:48:17

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