Community mailing list archives
Re: Reflection about documentation.by
El Aleman, David Arnold
For those who are lazy to read askslashdot (it's worthwhile however, because those people vastely seem to have maintained a very strong critical sense), the discussion is quite inline with what we have been discussing herein. It seems, however, that Fabien's strategic approach about User Docs (I hope all have understood it by now) has been validated, as well as many of the other concepts herein discussed, urging however not to only rely on it not even for users only. The retionals provided are very diverse and intersting and give a good overview of the limitations and implications of documentation investment and its impact on the ecosystem.
As Stephen Mack reported on the sister thread, something is done here: https://github.com/odoo-dev/odoo/tree/8.0-newnewdoc-xmo. I think, everyone else than Odoo leading this effort, would be a really, really bad idea.
Sidenote/Reminder: I did not read one single time the distinction between "funcional" and "technical" doc on slashdot, it seems indeed an tendentially isolated concept of our context. I still doubt this syntactical distiction is anything more than arbitrary in an integrated systemic view. Correct me if I'm wrong.