<html><body><div style="color:#000; background-color:#fff; font-family:HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif;font-size:12px"><div id="yui_3_16_0_1_1431547437213_73882">Hi all,</div><div id="yui_3_16_0_1_1431547437213_73883">I am creating files for the ha-guide content and have a question about what the OpenStack docs call</div><div dir="ltr" id="yui_3_16_0_1_1431547437213_73894">"embedded anchor pointers" and the Sphinx docs call labels. Basically, this is the string that you use</div><div id="yui_3_16_0_1_1431547437213_73905" dir="ltr">in a :ref: construct to link to a section. It is coded just above the section title. For example:</div><div id="yui_3_16_0_1_1431547437213_73952" dir="ltr"><br></div><div id="yui_3_16_0_1_1431547437213_73953" dir="ltr">.. _anchor-for-ha-intro:</div><div id="yui_3_16_0_1_1431547437213_73954" dir="ltr"><br></div><div id="yui_3_16_0_1_1431547437213_73955" dir="ltr">============================================</div><div id="yui_3_16_0_1_1431547437213_73956" dir="ltr">Introduction to Highly Available OpenStack environments</div><div id="yui_3_16_0_1_1431547437213_73957" dir="ltr">============================================</div><div id="yui_3_16_0_1_1431547437213_73969" dir="ltr"><br></div><div id="yui_3_16_0_1_1431547437213_73970" dir="ltr">It makes sense to use the file name (minus the .rst extension) for the labels, except that the Structure</div><div id="yui_3_16_0_1_1431547437213_74038" dir="ltr">standard specifies using underbar as the space delimiter, and underbars in these labels can confuse</div><div id="yui_3_16_0_1_1431547437213_74039" dir="ltr">Sphinx.</div><div id="yui_3_16_0_1_1431547437213_74040" dir="ltr"><br></div><div id="yui_3_16_0_1_1431547437213_74041" dir="ltr">I would suggest one of the following:</div><div id="yui_3_16_0_1_1431547437213_74042" dir="ltr"><br></div><div id="yui_3_16_0_1_1431547437213_74043" dir="ltr">- Use hyphen rather than underscore for RST source file names, then use that name as the top-level label</div><div id="yui_3_16_0_1_1431547437213_74044" dir="ltr"> for that section, so the filename would be intro-ha.rst rather than intro_ha.rst (preferred)<br></div><div id="yui_3_16_0_1_1431547437213_74051" dir="ltr">- Replace the underbars in file names with hyphens for labels.</div><div id="yui_3_16_0_1_1431547437213_74098" dir="ltr"><br></div><div id="yui_3_16_0_1_1431547437213_74109" dir="ltr">What does everyone else think?</div><div id="yui_3_16_0_1_1431547437213_74110" dir="ltr">meg<br></div></div></body></html>