Open Stack

So are you saying we can only link to whole books, not to individual sections of books?  I guess one can give the section titlein the text surrounding the link but it puts quite a burden on the reader to find the relevant material.

So the "draft" site is for docs being developed for Liberty, right?  But if I use "liberty" in the URL, the links won't workas we're trying to develop the content.  Will kilo links be automagically updated to liberty when the time comes or willthat also be a manual procedure?.
The HA Guide content is so intimately related to the content of several other guides so this may be more important to methan to some other people.  And I realize that we may need to live with some ugliness until everything is converted to RSTand we implement intersphinx -- I just need to understand.
meg

 
      From: Lana Brindley <openstack at lanabrindley.com>
 To: Meg McRoberts <dreidellhasa at yahoo.com>; Andreas Jaeger <aj at suse.com> 
Cc: "openstack-docs at lists.openstack.org" <openstack-docs at lists.openstack.org> 
 Sent: Tuesday, June 2, 2015 4:26 PM
 Subject: Re: Cross-references between documents
   
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 03/06/15 09:19, Meg McRoberts wrote:
> Nice to see the beginnings of the Kilo doc!
> As I understand it, for Kilo, xrefs to docs in different repos are done with straight HTML references.So, right now, the URL is going to include "draft" -- for example, http://docs.openstack.org/kilo/config-reference/content/ch_configuring-openstack-image-service.html
> Will all these URLs be automatically converted when the Kilo docs are released or does someone need to go through and manuallysearch-and-replace?
> Thanks much!meg
>  
> 

Sorry Meg, I'm not sure I'm following here. If you're linking to a
Kilo-specific doc, then use http://docs.openstack.org/kilo/[bookname]/

Linking to the draft site isn't generally a good idea, and I would avoid
it if you can.

As for updating links, unless a permanent redirect is put in place, they
will need to be manually updated, but this is another really great
reason not to link to the draft site.



L


- -- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQEcBAEBAgAGBQJVbjudAAoJELppzVb4+KUyFJIH/2KHunhOmMvRgKPUHrqDUPXd
pTLAYRKf4fXhuFUtmsrARKMBu1c+iGOTSOw1ADlhp56h2LWJVWYbtpUScNn87X4s
UEnDmfdsggrxeQiXofY6lgDd3mTsjdVyFJCMFj/g3yfIbZj9X32zN3qyO5YwrTFS
qTfxaEsEYMqZLkkncGuqxCXZw5IXtOEDfiM9ROUbp40h0qKEzAbXYJVIJlbT6sYB
pWQh6sDC+vHicloz35xA8ktle5q3K9Ik7SLACRRPB0EMydC/e/q4JwkCd+Uq4vrx
4XAfyITAXqjGvobqFVh7zzq0iEeT1nRtK7RZwcFqmamxc/LzEVBXsdBiknMFhJg=
=ENUZ
-----END PGP SIGNATURE-----


   
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20150603/e50339c8/attachment-0001.html>