Build documentation takes very long time

[geonetwork]

Build documentation takes very long time

[Delawen]

The rst files are downloaded automatically from transifex and then documentation is built. If you have a slow connection that may take some time, but also it gets cached on your local, so it will be faster the next time.

As said on the README.md, if you want to force a download a get all the latest files you should use the mvn clean install -Dlatest profile to make sure latest transifex files are downloaded. Transifex should be smart and download only the updates.

Those rst files shouldn't be in the repository. If they are there, that's a mistake, they should be downloaded from Transifex. Unless you want to do the cache on github.

[josegar74]

The cache doesn't seem to do too much. When I execute mvn clean install it seems building several times, I guess for each language? Would be good if that's the case, to be able to configure the languages and maybe by default only build english.

Those rst files shouldn't be in the repository: they are already there https://github.com/geonetwork/doc/tree/develop/source and I don't think is clear how to manage the documentation now. I did yesterday a PR updating the documentation: #28, but there're still some pending pull requests.

Can you point to some documentation about how should be handled the documentation?

[Delawen]

Yes, it builds all the languages. If you want to build only one language, the easiest way right now is to edit this line: https://github.com/geonetwork/doc/blob/develop/Makefile#L60

Yes, maybe we should add that as parameter too.

[Delawen]

The documentation about the documentation is in: https://github.com/geonetwork/doc/blob/develop/README.md

What I did is just add the multilingual part, the rest is the same as it was before.