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

2015-12-07 Thread Thomas Goirand
On 12/07/2015 03:04 PM, Morgan Fainberg wrote: > Lets keep the accusations/defence of wording choices > out of the rest of the thread and focus on getting the docs to a place > that works for all the parties. Yes please. > I did see the earlier comment that the > external resources (due to nation

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

2015-12-07 Thread Anne Gentle
On Mon, Dec 7, 2015 at 8:25 AM, Jeremy Stanley wrote: > On 2015-12-07 09:04:20 -0500 (-0500), Morgan Fainberg wrote: > [...] > > * We should not (regardless of free/non-free/etc) make sure that the docs > > are fully self-contained when built locally. This would address the > privacy > > and secu

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

2015-12-07 Thread Anne Gentle
On Mon, Dec 7, 2015 at 8:04 AM, Morgan Fainberg wrote: > > > On Mon, Dec 7, 2015 at 7:54 AM, Thomas Goirand wrote: > >> On 12/04/2015 03:23 PM, Anne Gentle wrote: >> > >> > >> > On Fri, Dec 4, 2015 at 8:09 AM, Thomas Goirand > > > wrote: >> > >> > Hi, >> > >> > I'

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

2015-12-07 Thread Jeremy Stanley
On 2015-12-07 09:04:20 -0500 (-0500), Morgan Fainberg wrote: [...] > * We should not (regardless of free/non-free/etc) make sure that the docs > are fully self-contained when built locally. This would address the privacy > and security issues for the local docs. (Again Analytics can be enabled as >

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

2015-12-07 Thread Morgan Fainberg
On Mon, Dec 7, 2015 at 7:54 AM, Thomas Goirand wrote: > On 12/04/2015 03:23 PM, Anne Gentle wrote: > > > > > > On Fri, Dec 4, 2015 at 8:09 AM, Thomas Goirand > > wrote: > > > > Hi, > > > > I've investigated a bit the openstackdocstheme, and tried to remove > some

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

2015-12-07 Thread Thomas Goirand
On 12/04/2015 03:23 PM, Anne Gentle wrote: > > > On Fri, Dec 4, 2015 at 8:09 AM, Thomas Goirand > wrote: > > Hi, > > I've investigated a bit the openstackdocstheme, and tried to remove some > of the (numerous) javascript with external references. And it's *v

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

2015-12-06 Thread Qiming Teng
Hi, Anne, As someone unfortunately who was born and is still working behind a national firewall, having a lot Google calls in docs do have some impacts on us. It would be great if we can make the docs just self-contained docs. Thanks. Qiming ___

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

2015-12-04 Thread Anne Gentle
On Fri, Dec 4, 2015 at 8:09 AM, Thomas Goirand 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 addre

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

2015-12-04 Thread Thomas Goirand
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. Not only this, but generated docs could potentially do call some of these objects without usin