[all] Removing privacy breaches in doc
smooney at redhat.com
Fri Apr 5 22:35:38 UTC 2019
On Sat, 2019-04-06 at 00:06 +0200, Thomas Goirand wrote:
> In may docs, I can see stuff like this, especially in README.rst:
> .. image:: http://governance.openstack.org/badges/something.svg
> :target: http://governance.openstack.org/reference/tags/index.html
> I'd like to let everyone know that, from a package maintainer
> perspective, and considering that we do package your Sphinx doc in
> distros, this is an annoyance. Indeed, I do feel like I must patch it
> out and remove the external source.
> The reason is, as a Debian user, I do not expect my browser to do
> external queries to a website when I'm browsing a local documentation.
> This one is on openstack.org, it's mildly ok-ish, though, I'm removing
> the image still. There's other more annoying stuff (think: travis,
> github, and other spies which we don't control).
> So, it'd be nice if these images with external resources were completely
> avoided in OpenStack docs. Either by simply not putting such useless
> image, replacing it by text only, or by embedding the image itself in
> the doc (or in openstackdocstheme? I suspect that's not what people
> want, they want it to be displayed in github... so embedding would be
> the only solution).
am we could do this but they do not exist to spy on people.
the are there to let people know that a project is maintained and follows
different aspect of the governace policys.
such as is it vulnerablity managed or suppors-upgrades.
i undersand the concern but the reason we follow the current linking approch instead
of embeding is allow them to be centrally managed in a singel repo.
perhaps we can figure out how to automtically staticaly embed them some how so that
when sphinx build executes it embdes a local copy in the html?
i dont think these image are useless as they do provide relevent info to users of
the respecitve project although ill admit i had assumed these tags actully were not
a singel image but were added one by one.
> Thomas Goirand (zigo)
More information about the openstack-discuss