[docs] index directives for section text
chris.jerdonek at gmail.com
Thu Jul 26 10:44:41 CEST 2012
When marking section text for inclusion in the index, is there a
preference for whether the index directive should occur immediately
before or after the section header?
For example, "generator, function" in the index links here:
But the "Generator functions" header is not visible after clicking the
link without scrolling (at least for me) because the directive appears
after the header in reference/datamodel.rst:
single: generator; function
single: generator; iterator
This seems like common practice in some areas of the documentation,
but it seems like the result might be less desirable.
More information about the docs