[all] Please remove all external resources from docs

Thomas Goirand zigo at debian.org
Mon Apr 6 15:12:30 UTC 2020


I've wrote about this earlier I guess, but I believe I need to do it
once more. Often I see in the docs things like this:

.. image:: https://governance.openstack.org/tc/badges/<FOO>.svg
    :target: https://governance.openstack.org/tc/reference/tags/index.html

[note: this is only one simple example, there's many of other types
linking to external images, I've even seen stuff linking to CDNs...]

I'd like to see these go away. Indeed, distributions like mine (ie:
Debian) are packaging the doc. And it's *very* annoying when one browses
the doc to have such an external link, and the browser going on the
internet to fetch an external resource.

So, in Debian, I'm patching these away. Often, the most ugly way where I
don't care about the resulting document (as long as the doc is there).
This is both annoying, and a loss of my time.

The solution is simple: have the resource being *LOCAL* (ie: stored in
the project's doc), not stored on an external site.

Thanks to anyone who will follow this advice.


Thomas Goirand (zigo)

More information about the openstack-discuss mailing list