[openstack-dev] openstackdocstheme to be considered (very) harmful for your generated sphinx docs

Anne Gentle annegentle at justwriteclick.com
Fri Dec 4 14:23:56 UTC 2015

On Fri, Dec 4, 2015 at 8:09 AM, Thomas Goirand <zigo at debian.org> wrote:

> Hi,
> I've investigated a bit the openstackdocstheme, and tried to remove some
> of the (numerous) javascript with external references. And it's *very*
> ugly: it's full of google stuff, random CDN and so on.
I absolutely want to address these concerns.

Let's start with making sure I understand the concerns so we can start
tracking the work requirements with bugs.

1. Google stuff, considered non-free. Can you list specifics? Fonts and
analytics js for starters, let me know if there are others?
2. Random CDN: maxcdn, which was provided to us by the Foundation's web
designer who gave us the design. We need CDN for performance reasons. What
CDN meets your requirements?
3. Non-minified JS, being worked on two bugs now. [1] [2]

Does that list capture your "ugly" claim in a measureable manner?

[1]  https://bugs.launchpad.net/openstack-manuals/+bug/1501641
[2]  https://bugs.launchpad.net/openstack-manuals/+bug/1502806

Not only this, but generated docs could potentially do call some of
> these objects without using HTTPS (which is the case when browsing a
> local *-doc package generated sphinx document using file://).
Could you list the calls in a bug please? That will help with triaging.

> At the present moment, I would recommend projects to *not* use the
> openstackdocstheme at all until all of this is fixed.

I'd like to understand your concerns further and specifically before taking
this type of action.

> I'm also thinking: am I the only one in this community that cares about
> browsing privacy?
Of course not, and with this line of reasoning and lack of clarity and
specificity you are not representing actual privacy concerns but trying to
manipulate emotions. Please clarify your concerns so we can work on the
problems you have brought forward.


> Cheers,
> Thomas Goirand (zigo)
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Anne Gentle
Principal Engineer
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20151204/50d791c9/attachment.html>

More information about the OpenStack-dev mailing list