<div dir="ltr"><div>Hi,<br></div>Agreed, the Table of Contents needs to be improved, to help the reader know where he is. This was the behaviour until 2.2 and this is how it behaves in <a href="http://qgis.org">qgis.org</a> website.<br></div><div class="gmail_extra"><br><div class="gmail_quote">2016-01-27 13:37 GMT+01:00 Frank Sokolic <span dir="ltr"><<a href="mailto:sokolic@worldonline.co.za" target="_blank">sokolic@worldonline.co.za</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi all,<br>
<br>
My preference is for shorter pages but with with improved navigation so that users know where they are in the documentation.<br>
<br>
I find the navigation in the user guide frustrating at times. For example, have a look at "Working with Vector Data":<br>
<a href="http://docs.qgis.org/2.8/en/docs/user_manual/working_with_vector/index.html" rel="noreferrer" target="_blank">http://docs.qgis.org/2.8/en/docs/user_manual/working_with_vector/index.html</a><br>
<br>
At the top of this page is a list hyperlinks showing all the topics in this section. However, if you click on one of the hyperlinks then a new page is opened but the list of topics disappears and the user doesn't know where they are anymore.<br>
<br>
If long pages are split into a series of short pages then I think that the list of topics and sub-topics should appear in the Table of Contents on the left as a nested list and the current topic/page should be highlighted. In this way it would be easier for users to navigate the manual.<br>
<br>
Regards, Frank.<div><div class="h5"><br>
<br>
<br>
On 27/01/2016 14:06, DelazJ wrote:<br>
</div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div class="h5">
Hi documenters,<br>
<br>
There's currently a discussion<br>
(<a href="https://github.com/qgis/QGIS-Documentation/pull/760" rel="noreferrer" target="_blank">https://github.com/qgis/QGIS-Documentation/pull/760</a>) whether long<br>
one-page chapters should be divided into shorter pages (files) or not.<br>
Richard is less enthusiastic with split because he's afraid that<br>
increasig the number of files (thus pages) means more resources, more<br>
clicks and may increase the build (and transifex-push) time.<br>
At the other hand, short and single-feature pages easier navigation,<br>
reading, updating, ensures no repetition and, given that QGIS features<br>
are increasing, we risk to end up with very long and less usable pages<br>
(scrolling is difficult, no way to directly reach section of interest...).<br>
<br>
An example can be viewed here:<br>
<a href="http://docs.qgis.org/2.8/en/docs/user_manual/print_composer/print_composer.html" rel="noreferrer" target="_blank">http://docs.qgis.org/2.8/en/docs/user_manual/print_composer/print_composer.html</a><br>
vs<br>
<a href="http://docs.qgis.org/testing/en/docs/user_manual/print_composer/index.html" rel="noreferrer" target="_blank">http://docs.qgis.org/testing/en/docs/user_manual/print_composer/index.html</a><br>
<br>
We'd like to hear your voices about splitting chapters in general and<br>
especially in PR 760 on splitting Editing vector layer chapter<br>
(<a href="http://docs.qgis.org/testing/en/docs/user_manual/working_with_vector/editing_geometry_attributes.html" rel="noreferrer" target="_blank">http://docs.qgis.org/testing/en/docs/user_manual/working_with_vector/editing_geometry_attributes.html</a>).<br>
<br>
I also made a Pull Request on splitting layer vector properties (see<br>
<a href="https://github.com/qgis/QGIS-Documentation/pull/776" rel="noreferrer" target="_blank">https://github.com/qgis/QGIS-Documentation/pull/776</a>). now broken but<br>
comments are welcome.<br>
<br>
PS: note that in PR760, there's also a discussion about how to better<br>
structure the "Working with vector layer" chapter. It's worth your<br>
comments, too.<br>
<br>
Regards,<br>
Harrissou<br>
<br>
<br></div></div>
_______________________________________________<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" target="_blank">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><br>
<br>
</blockquote>
<br>
_______________________________________________<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" target="_blank">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></blockquote></div><br></div>