Re: implementing - gitchangelog to odoo and its modules

Hi Robert and those who want to have a local documentation which is not included in an individual Odoo Installation, what actually the post was all about!

do the following:

Make sure you have sphinx installed on your server/computer

$ pip install Sphinx

next run

$ sphinx-quickstart

this creates a source directory and configures sphinx with some useful stuff.

The sourcefile suffix will be .rst - It will ask you also several other questions.

After you have created your file you can edit it i.e. by using any editor (vi) etc.

close and save your file again

than in the same directory execute

$ make html

if like to get a pdf

$ make latexpdf

last step it need to know where the code is actually

therefore uncomment the line in conf.py before you run

sys.path.append(os.path.abspath('.'))

if you keep it in the make directory - which is our case the current working directory!

When putting that into an Odoo module we would need to specify the correct path to the documentation and also it would be advised to run

$ sphinx-build [options] sourcedir builddir [filenames]

instead of only

$ make html

from a current working directory

If you made changes to the documentation (edits etc.) than run

$ make clean

and run

$ make html

again so that everything gets included properly

go in your directory to

build/html and click on index.html and you will have the documentation.

This is what would be needed to be visible from the backend or even from the frontend of an individual Odoo installation.

As each Odoo Installation has several modules activated and deactivated it would be great to have a way that only the documentation of the active modules get shown but for developers on the other hand it would be also interesting to see what other modules, even those who have not been included would be available including their documentation.

I suggest in having for that kind of documentation a separate directory which for security reasons also could be blocked and made visible only if you sign in from certain IP addresses.

For those who secure their sites in other ways it might be interesting to get the documentation of the modules also been visible from the frontend - especially for installations for support purposes this would be interesting I guess. It is great for SEO too by the way!

What would now be very interesting for developers would be actually if also a gitchangelog could be created for all those modules integrated in an installation. As those modules are very often hosted in many different git repositories and some even locked or not reachable there needs to be a routine to check if a changelog is available.

With that a developer and also a user would have a handy individual documentation for each individual odoo installation and he would be able to call it from with his odoo backend and perhaps even be able to search it. This would be much easier than using Google, looking in multiple repositories of github accounts or trying to find answers in the world wide web.

By the way you could include also your own documentation for the user in the same way.