Community 보관된 메일 그룹


Re: implementing - gitchangelog to odoo and its modules

redCOR AG, robert rottermann
- 2016년 05월 23일 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: 
> look for the thread in the list, (Help is wanted and necesary there).
good to know
> 5.- Technical doc is here:
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.