> -----Original Message----- > From: Thomas Monjalon [mailto:[email protected]] > Sent: Wednesday, October 25, 2017 11:27 AM > To: Kovacevic, Marko <[email protected]> > Cc: [email protected]; Mcnamara, John <[email protected]>; Herakliusz > Lipiec <[email protected]> > Subject: Re: [dpdk-dev] [PATCH v9 1/2] doc: add generic compilation doc > for all sample apps > > 19/10/2017 14:11, Marko Kovacevic: > > +.. _sample_app_compilation: > > + > > +Compiling the Sample Applications > > +================================= > > I think we should stop adding useless anchors. > I may be wrong but I don't see the benefit of > :ref:`sample_app_compilation` > compared to > :doc:`compiling`
There is an advantage when the referred to section isn't the first section in the docs: "Using ref is advised over standard reStructuredText links to sections (like `Section title`_) because it works across files, when section headings are changed, and for all builders that support cross-references." http://www.sphinx-doc.org/en/stable/markup/inline.html#cross-referencing-anything However, that isn't the case here. So it would be better to use :doc:. John
