Open Stack

On 15/02/17 11:12, Anne Gentle wrote:
> 
> 
> On Tue, Feb 14, 2017 at 6:59 PM, Lana Brindley <openstack at lanabrindley.com <mailto:openstack at lanabrindley.com>> wrote:
> 
>     On 15/02/17 09:58, Hayes, Graham wrote:
>     > On 14/02/17 23:12, darren chan wrote:
>     >> Hi Graham,
>     >>
>     >> Links to non-core services install guides are added in
>     >> /openstack-manuals/doc/install-guide/source/additional-services.rst. In
>     >> the index file, you can't reference files located in another repo.
>     >>
>     >> That said, Brian Moss has created a remoteinclude Sphinx extension which
>     >> includes remote standalone files https://kallimachos.github.io/chios/ <https://kallimachos.github.io/chios/>. I
>     >> think there would be value in extending this functionality to also
>     >> include remote index files. This would enable all project install guides
>     >> to be listed on the index page.
>     >>
>     >>
>     >
>     > I thought the install-guide plugins published into a path that could be
>     > linked to from the index (we certainly used to [0]). In fact if you look
>     > at the content in additional-services.rst it is just a collection of
>     > hard coded links to a published path.
>     >
>     > If this is no longer the case it is a  regression, and highlights issues
>     > that I have been talking about for the last while for core vs non
>     > core projects - this change makes it quite difficult for installers
>     > to find install docs for "non core" or "non docs supported" services.
>     >
>     > [1] seems to be the change that removed these links.
>     >
>     > 0 - https://docs.openstack.org/project-install-guide/newton/ <https://docs.openstack.org/project-install-guide/newton/> see the
>     > right hand side - some of these are install guide plugins.
>     >
>     > 1 - https://review.openstack.org/#/c/425821/ <https://review.openstack.org/#/c/425821/>
>     >
> 
>     Oh, and now I've read the rest of the thread, yes, that's the patch that has broken things. I'll work with Nish to sort this out.
> 
> 
> Heh, I think our emails high-fived each other as they traveled the tubes. :)
> 
> Anne
>  

Wow. We're great at this :P

L

> 
> 
>     Lana
> 
>     --
>     Lana Brindley
>     Technical Writer
>     Rackspace Cloud Builders Australia
>     http://lanabrindley.com
> 
> 
>     _______________________________________________
>     OpenStack-docs mailing list
>     OpenStack-docs at lists.openstack.org <mailto:OpenStack-docs at lists.openstack.org>
>     http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs>
> 
> 
> 
> 
> -- 
> 
> Read my blog: justwrite.click <https://justwriteclick.com>
> Subscribe to Docs|Code: docslikecode.com <http://docslikecode.com> 

-- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 538 bytes
Desc: OpenPGP digital signature
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20170215/dc44c225/attachment.pgp>