[Openstack-docs] Common Folder
Pranav Salunke
dguitarbite at gmail.com
Wed Jul 23 09:42:21 UTC 2014
Thank you for point it out, I need to take a look into this.
Regards,
Pranav
On Wed, Jul 23, 2014 at 1:47 PM, Andreas Jaeger <aj at suse.com> wrote:
> On 07/23/2014 09:46 AM, Pranav Salunke wrote:
> > Anne,
> >
> > I think useage of xml:id tag will not work across repositories, hence
> > the issues I was facing. To be very clear, training-manuals builds were
> > failing straight away. It was a bit hectic to get it back on track.
> >
> > We need to use xi:include for including common folder's content and
> > xpointer for the xml:id. So you see the problems faced. This patch will
> > give you some idea of what exactly happened.
> >
> https://review.openstack.org/#/c/108263/3/doc/training-guides/associate-guide/bk001-ch007-associate-network-node.xml
>
> Looking at that change: The file was just moved from one location to
> another, just changing the path would have been enough...
>
> Still, I don't understand why you include this in the training guides, a
> reference to the CLI guide would be enough,
>
> Andreas
>
> > Ignore the xi:fallback part, I could not fix the changes myselves
> > because someone else had taken up the bug. But it was eventually fixed.
> >
> http://git.openstack.org/cgit/openstack/training-guides/commit/?id=67f88dd957e78f850bfb4e04281f56ff2a432188
> >
> >
> > On Mon, Jul 21, 2014 at 6:50 PM, Anne Gentle <anne at openstack.org
> > <mailto:anne at openstack.org>> wrote:
> >
> > Hi Pranav,
> > I don't know if the file names are changing, do you have evidence of
> > a file name change so I can troubleshoot further?
> >
> > My working theory is that the conditionals are causing the error you
> > pasted. The file is "not found" because it has a particular
> > condition. As an example, any image starting with dbconfig-
> > is not accessible to the build unless the condition os="debian" is
> met.
> >
> > We typically use xml:id so that file name changes do not matter, but
> > it does require everyone to refer to items only by xml:id. In the
> > case of images, the reference to the image would need an xml:id on
> > it, that the training guide would then reference.
> >
> > This difficulty happens often when sharing content, I've seen it
> > many times. We can work through it with the toolchain we have, I
> > believe.
> > Anne
> >
> >
> > On Sun, Jul 20, 2014 at 9:42 PM, Pranav Salunke
> > <dguitarbite at gmail.com <mailto:dguitarbite at gmail.com>> wrote:
> >
> > Hello,
> >
> > I have seen a few changes in the common folder present under
> > openstack-manuals repository break training manuals.
> > Particularly the changes which include file name change. We need
> > to address this so that the training manuals and other
> > repositories which use common folder can adopt to the changes.
> > These changes should be merged only when the dependences under
> > other documentation related projects are addressed.
> >
> >
> > The other issue with common folder arises with relative paths
> > which gives following errors.
> > http://paste.openstack.org/show/86763/
> > We need to address these errors properly to encourage re-use of
> > existing material. Can we discuss these issues during the IRC
> > meeting or during the design session at Juno Summit?
> > Regards,
> > Pranav
> >
> > _______________________________________________
> > 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
> >
> >
> >
> >
> >
> > _______________________________________________
> > Openstack-docs mailing list
> > Openstack-docs at lists.openstack.org
> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> >
>
>
> --
> Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
> SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
> GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
> GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140723/eff86c1a/attachment-0001.html>
More information about the Openstack-docs
mailing list