<div dir="ltr"><div><div><div>Hi all,<br><br></div>Yves, thanks for your recommendations about the headers. I'll do the changes.<br>I
 thought that symbols were what define the "level" of the title meaning 
that, chapter should always have header (===), section header (---), 
sub-section header ... with no link whether they begin a new page or 
not. But if I understand u, the right "level" of a title/subtitle is 
built from the index files (and folder) and the order of appearance of 
headers symbol in each file.<br></div>I suppose that, if I want to 
generate for example a pdf file with these files, it's the index file 
(and folder) that tells the Rst engine how to build the file according 
to chapter >section > subsection... Am I right?<br><br></div>About
 an introductive text at the beginning of the chapter, I thought about 
this but I was unable to find a chapter with such presentation so I gave
 up. I can pick the first two paragraphs of "first step" section, unless
 one is enough...<div><br></div><div>Regards, <br></div>Harrissou</div><div class="gmail_extra"><br><div class="gmail_quote">2015-06-07 16:16 GMT+02:00 Yves Jacolin <span dir="ltr"><<a href="mailto:yjacolin@free.fr" target="_blank">yjacolin@free.fr</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">Le samedi 6 juin 2015, 01:22:26 DelazJ a écrit :<br>
</span><span class="">> Hi Folks,<br>
><br>
> While reading QGIS documentation, there are some pages that leave me<br>
> puzzled. You may have a look at Print Composer [1], vector properties<br>
> dialog [2] pages.<br>
> IMHO, these pages are too long. For the reader, scrolling can become<br>
> tedious while looking for a precise information. Sure, the subject is wide<br>
> and there is a lot of informations at these pages but I think that, because<br>
> subject is wide, it can be splited into several pages, shorter, more<br>
> precise and readable. As there are Previous/Next buttons, skipping sections<br>
> while reading can easily be done.<br>
> From writer side, I think that having short (and specialized) page helps us<br>
> to quickly identify where there may be a lack of documentation, easily<br>
> update or improve them...<br>
><br>
> So, few days ago, I made a pull request [3] that splits Print Composer<br>
> chapter into many pages, reorganizing sections and sequences.<br>
><br>
> If you agree with the spliting principle of these chapters, can some<br>
> documentation writers review it, amend it and let me know if it is ok? It's<br>
> the first time I use rst files so it'd be nice if someone can review my PR<br>
> before I begin spliting vector properties chapter.<br>
><br>
> Regards,<br>
> Harrissou<br>
><br>
> [1]<br>
</span><span class="">> <a href="http://docs.qgis.org/2.8/fr/docs/user_manual/print_composer/print_composer.h" target="_blank">http://docs.qgis.org/2.8/fr/docs/user_manual/print_composer/print_composer.h</a><br>
> tml [2]<br>
> <a href="http://docs.qgis.org/2.8/fr/docs/user_manual/working_with_vector/vector_prop" target="_blank">http://docs.qgis.org/2.8/fr/docs/user_manual/working_with_vector/vector_prop</a><br>
> erties.html [3] <a href="https://github.com/qgis/QGIS-Documentation/pull/544/" target="_blank">https://github.com/qgis/QGIS-Documentation/pull/544/</a><br>
</span>DelazJ,<br>
<br>
My opinions is that your split is perfect. As you said all in one page should<br>
be too much and the split is great.<br>
<br>
One more feedback (with my comments in you Pr): the index page contains only a<br>
toc, do you think we can add a small paragraph to introduce the composer<br>
chapter? As the one in "First Steps" section for instance?<br>
<br>
Otherwise just merge.<br>
<span class="HOEnZb"><font color="#888888"><br>
Y.<br>
--<br>
Yves Jacolin<br>
</font></span></blockquote></div><br></div>