<div dir="ltr"><div><div><div><div><div><div>Hi,<br></div>I up this thread given that there were (?) pending PRs and unless i miss something, no decision has been taken to close this discussion (and I didn't "hear" so many voices).<br><br>I must confess that at the beginning I wasn't fan of  the "contents at the top of the page" (as currently proposed in e.g. <a href="http://docs.qgis.org/testing/en/docs/user_manual/working_with_vector/style_library.html" target="_blank">http://docs.qgis.org/testing/en/docs/user_manual/working_with_vector/style_library.html</a>). But while navigating through these pages, it offers the reader an overview of the content of the page, a quick way to access the desired link. From a documenter point of view, it helps to understand how the chapter is structured, identify where a new section can be added or moved to. It's definitely an useful enhancement we should add to all compatible pages.<br></div>Even though it makes some pages noticeably longer (what was the issue reported here) imho it's worth the length and combining the Home button and the content-toc does really simplify navigation.<br><br></div>However, we still have issues with navigation, i think.<br>Richard, about the template of the pages, do you mean that having an expandable TOC like it's done for the QGIS website (e.g., <a href="http://qgis.org/fr/site/getinvolved/development/qgisdevelopersguide/codingstandards.html" target="_blank">http://qgis.org/fr/site/getinvolved/development/qgisdevelopersguide/codingstandards.html</a>) or for 2.2 docs (<a href="http://docs.qgis.org/2.2/en/docs/user_manual/working_with_vector/vector_properties.html" target="_blank">http://docs.qgis.org/2.2/en/docs/user_manual/working_with_vector/vector_properties.html</a>) will require a lot of changes and complicates migration? Currently when you are at <a href="http://docs.qgis.org/testing/en/docs/user_manual/working_with_vector/style_library.html" target="_blank">http://docs.qgis.org/testing/en/docs/user_manual/working_with_vector/style_library.html</a>, it's not that easy to identify in the TOC in which chapter you are and more interesting what are the other sections/topics covered in the same chapter. I think that covering also this (even only for the first level under the main chapter) will provide great improvements to readers and writers.<br><br></div>Sorry to come only with my words (in a rough english) and not be able to come with a technical proposal (I unfortunately have no great skill in this area).<br><br></div>Regards,<br></div>Harrissou<br></div><div class="gmail_extra"><br><div class="gmail_quote">2016-01-29 11:33 GMT+01:00 Richard Duivenvoorde <span dir="ltr"><<a href="mailto:richard@duif.net" target="_blank">richard@duif.net</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 29-01-16 10:28, Frank Sokolic wrote:<br>
> Having the contents at the top of the page is an improvement. Is it<br>
> possible to have hyperlinks back to the contents next to each section<br>
> heading in the long rst files? This would make it easier for users to<br>
> jump back to the contents instead of having to scroll all the way back<br>
> to the top.<br>
<br>
</span>Well, at least for the docs website we could inject some floating div<br>
somewhere on the bottom. Maybe combined with some links to the same page<br>
in other versions? This (via javascript injected) html would probably<br>
not be shown on github.<br>
<br>
On the other hand: does not everybody have a 'home' button, which will<br>
bring you to top == contents?<br>
<br>
I hope to keep the template stuff as default as possible to make it easy<br>
to move to another template in near future.<br>
<br>
Regards,<br>
<br>
Richard<br>
<div class="HOEnZb"><div class="h5">_______________________________________________<br>
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br>
<a href="mailto:Qgis-community-team@lists.osgeo.org">Qgis-community-team@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer" target="_blank">http://lists.osgeo.org/mailman/listinfo/qgis-community-team</a></div></div></blockquote></div><br></div>