Bug #1466 - Make API documentation country agnostic

[micael-grilo]

Hi,

Please see in attach my contribution to Bug #1466.
I've tried to make the examples as generic as possible.

Best!

[noirbizarre]

Thanks for the contribution 👍

One possible improvement for later is to make this documentation dynamique (ie. use a real organization)

[noirbizarre]

Sorry, I forgot: for every PR with user noticeable changes we try to submit a CHANGELOG entry. Can you do so (in another PR because I merged this one to quickly) ?

[micael-grilo]

@noirbizarre in fact with dynamic documentation (using a real organization) it would be better.
What you have in mind? Get the top or first 20 organizations and then choose one ramdomly to display as example?

Btw, the idea is to send an organization list (limit 20) as an parameter to the JINJA template in this line, then deal with the organization in the Jinja template, is it ok? Or do you suggest a better approach.

udata/udata/api/__init__.py

Line 270 in d02e371

return theme.render('apidoc.html', specs_url=api.specs_url)

I will create a new PR for the CHANGELOG.
Thanks