[Fiware-webui] REMINDER: Link of ReadTheDocs to GitHub-Releases

[Torsten Spieldenner]

Hi all,

many of you have already updated their Read-The-Docs-Documentation to 
point to a specific GitHub-Release of their GE, but a few are still 
missing. As a reminder: According to Jose Manuel's email earlier this 
week, it will not be accepted that ReadTheDocs points to the "latest" 
version of the documentation, i.e. 
"https://xml3d.readthedocs.org/en/latest/"  would be WRONG. Instead, 
there needs to be a pointer to the Release version that is also 
specified as the version of the GE that is published in FIWARE. So for 
example, if the release tag of XML3D that corresponds to the FIWARE 
Release is 5.0.3, then the correct ReadTheDocs-Resource is: 
"https://xml3d.readthedocs.org/en/5.0.3/"<https://xml3d.readthedocs.org>

You can select the tags for which documentation should be created in 
your ReadTheDocs-Admin center.

When I had a look at this earlier today, I noticed that the tool can be 
very slow when it comes to updating the list of available release tags 
to choose from. For me, it helped to perform the " Post Commit Hook"  
CURL request that is given in the Overview dashboard of your 
ReadTheDocs-project:

curl -X POST https://readthedocs.org/build/[$projectname] .

After I performed this command, the list of commits and releases was up 
to date again.

Best Regards,
Torsten

-- 
Torsten Spieldenner, M.Sc.

Tel.: +49 6 81 / 8 57 75 - 77 48
Fax.: +49 6 81 / 8 57 75 - 22 35

Internet: http://www.dfki.de/web/forschung/asr/

-------------------------------------------------------------
Deutsches Forschungszentrum fuer Kuenstliche Intelligenz GmbH
Trippstadter Strasse 122, D-67663 Kaiserslautern, Germany

Geschaeftsfuehrung:
Prof. Dr. Dr. h.c. mult. Wolfgang Wahlster (Vorsitzender)
Dr. Walter Olthoff

Vorsitzender des Aufsichtsrats:
Prof. Dr. h.c. Hans A. Aukes

Amtsgericht Kaiserslautern, HRB 2313
-------------------------------------------------------------

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/fiware-webui/attachments/20160113/8ee12a33/attachment.html>