[OpenStack-docs] Anchor tag conventions

Andreas Jaeger aj at suse.com
Thu May 14 17:25:23 UTC 2015


On 05/14/2015 08:21 AM, Meg McRoberts wrote:
> Are you saying to not use the :ref: construction?

I was suggesting to use the :doc: construct for file links. We haven't 
added that yet to the markup conventions page but I prefer that for 
these kind of links.

Also, I would only add anchors if they are needed, so don't add them by 
default everywhere...

Btw. I like having some convention on these, so please rework it and 
then let's get it into the wiki,

Andreas
-- 
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
   SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
    GF: Felix Imendörffer, Jane Smithard, Dilip Upmanyu, Graham Norton,
        HRB 21284 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126




More information about the OpenStack-docs mailing list