Community mailing list archives

community@mail.odoo.com

Re: implementing - gitchangelog to odoo and its modules

by
redCOR AG, robert rottermann
- 05/23/2016 01:36:46
On 22.05.2016 03:57, Nhomar Hernandez wrote:
>
> BTW...
>
> IMHO I prefer a proper documented API than a changelog... If you follow the 
> commit log in odoo itself you can check that you will find:
so do I. And one does not substitute the other
>
> 1.- Long commits.
> 2.- In the PR you have in more or less the 70% of them the link to the pad.
> 3.- If you RTFC and learn a little of python algorithms are easy to understand.
Sorry, does not help much.
I am well versed with python, but I feel extremely lost. And what documentation 
I find tends to be wrong (as it is V8 based).

> 4.- Functional documentation here: https://github.com/odoo/documentation-user 
> look for the thread in the list, (Help is wanted and necesary there).
good to know
> 5.- Technical doc is here: https://github.com/odoo/odoo/tree/9.0/doc
does not even have a readme. Seems to be an exercise on how you make sure you 
leave people frustrated.
> 6.- You can compile with nginx all of it.
Again a proof how neglected the documentation is. This would be acceptable when 
a finished product is provided for the end user and you want to give the rare 
die-hard power user a way to get into more details.

robert