<div dir="ltr"><div>Hi all,<br><br>Sorry to come back to this thread. But, although it seems that we will have a 2.18 documentation release, we are still blocking the documentation of new features arriving to the QGIS 3.0 Branch. And there are tons of it.<br><br></div>So, could we adopt some strategy about this? Maybe two master branches if necessary (as done for QGIS code). Or branch 2.18 documentation, work normally in master and backport all functionalities that were missing?<br><br>Any opinions or ideas?<br><br>Thanks!<br></div><br><div class="gmail_quote"><div dir="ltr">Alexandre Neto <<a href="mailto:senhor.neto@gmail.com">senhor.neto@gmail.com</a>> escreveu no dia quarta, 22/02/2017 às 12:50:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><p dir="ltr" class="gmail_msg">I can try. Although I don't have your eye for details. :-)</p>
<br class="gmail_msg"><div class="gmail_quote gmail_msg"><div dir="ltr" class="gmail_msg">A qua, 22/02/2017, 12:01, DelazJ <<a href="mailto:delazj@gmail.com" class="gmail_msg" target="_blank">delazj@gmail.com</a>> escreveu:<br class="gmail_msg"></div><blockquote class="gmail_quote gmail_msg" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr" class="gmail_msg">Hi,<br class="gmail_msg"><div class="gmail_extra gmail_msg"><br class="gmail_msg"><div class="gmail_quote gmail_msg"></div></div></div><div dir="ltr" class="gmail_msg"><div class="gmail_extra gmail_msg"><div class="gmail_quote gmail_msg">2017-02-22 0:38 GMT+01:00 Alexandre Neto <span dir="ltr" class="gmail_msg"><<a href="mailto:senhor.neto@gmail.com" class="gmail_msg" target="_blank">senhor.neto@gmail.com</a>></span>:<br class="gmail_msg"><blockquote class="gmail_quote gmail_msg" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><p dir="ltr" class="gmail_msg">According to the latest news, it seems that there will make sense to have a 2.18 Documentation release...</p>
<p dir="ltr" class="gmail_msg">Sorry for trying to "rush" it to 3.0. Or will it be 3.2?</p>
<p dir="ltr" class="gmail_msg">Anyway, I am going to put some effort in fixing 2.x issues in the user's manual.</p><div class="m_7968871423247261548m_5910566185164451101HOEnZb gmail_msg"><div class="m_7968871423247261548m_5910566185164451101h5 gmail_msg">
<br class="gmail_msg"></div></div></blockquote></div></div></div><div dir="ltr" class="gmail_msg"><div class="gmail_extra gmail_msg"><div class="gmail_quote gmail_msg"><div class="gmail_msg">Like reviewing some of the pending pull requests? :)<br class="gmail_msg"></div><div class="gmail_msg">Thanks<br class="gmail_msg"><br class="gmail_msg"></div><div class="gmail_msg">H. <br class="gmail_msg"></div></div></div></div><div dir="ltr" class="gmail_msg"><div class="gmail_extra gmail_msg"><div class="gmail_quote gmail_msg"><blockquote class="gmail_quote gmail_msg" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="m_7968871423247261548m_5910566185164451101HOEnZb gmail_msg"><div class="m_7968871423247261548m_5910566185164451101h5 gmail_msg"><div class="gmail_quote gmail_msg"><div dir="ltr" class="gmail_msg">A qui, 9/02/2017, 09:39, DelazJ <<a href="mailto:delazj@gmail.com" class="gmail_msg" target="_blank">delazj@gmail.com</a>> escreveu:<br class="gmail_msg"></div><blockquote class="gmail_quote gmail_msg" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr" class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><div class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">Hi,<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"></div>Alexandre, Thanks for the clarification. Indeed we need to hear people once for all on this (these) topic(s) and ensure any contribution is not rejected or discouraged. And I think making PR guarantee that a contribution is taken into account (we still have a queue shorter than QGIS repo's :) )<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><div class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><div class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><div class="gmail_extra m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">Richard, I think it's more than clear that the next application release is 3.0 and the 2.x serie is behind us now. It's also clear that after 2.14, the next LTR will be 3.2. Btw, we need to update a bit <a href="http://qgis.org/en/site/getinvolved/development/roadmap.html#release-schedule" class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg" target="_blank">http://qgis.org/en/site/getinvolved/development/roadmap.html#release-schedule</a><br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"></div><div class="gmail_extra m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">The 2.x vs 3.0 issue reports separation in Doc repo was at that time due to the hypothetic release of a QGIS 2.20 which would be a LTR hence would deserve a documentation (due to the rule "only LTRs are documented"). Now there will be no 2.20 and the next LTR is two releases away so, as Richard said "the main question is: do we decide to NOT release a newer documentation(!) 2.x branch anymore this year.?" In other words: Do we keep 2.x series documentation at 2.14 level, while there are 2.16 and 2.18 releases that would surely be used for a while?<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">That's all! And I'm fine with whatever (argumented) answer is made! if the answer is a categoric No :), let's pull 3.0 fixes<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"></div><div class="gmail_extra m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">If the answer is "Yes, we want to release a 2.18 documentation" (without translation of course), we can still begin working on 3.0 issues by creating a master_2 branch for 2.18 fixes and port fixes from a branch to another. It has been made with QGIS repo. I'm sure it 'd not be that hard to maintain. It's not like if we have codes, it's all about text (more understandable and cherry-pickable for me, anyway).<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"></div><div class="gmail_extra m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">Btw, given that we are in dev list, allow me to remind that in the thread in psc-list, there was a call for devs to help maintain and reinforce the backend of documentation.... you are welcome... Thanks<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"></div><div class="gmail_extra m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"></div><div class="gmail_extra m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">Regards,<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">Harrissou<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"></div></div></div></div><div dir="ltr" class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><div class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><div class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><div class="gmail_extra m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"> </div><div class="gmail_extra m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><div class="gmail_quote m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">2017-02-09 8:36 GMT+01:00 Richard Duivenvoorde <span dir="ltr" class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><<a href="mailto:rdmailings@duif.net" class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg" target="_blank">rdmailings@duif.net</a>></span>:<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"><blockquote class="gmail_quote m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class="m_7968871423247261548m_5910566185164451101m_5604838996975160140m_5749235124859211397gmail- m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">On 08-02-17 12:42, Alexandre Neto wrote:<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
> My concerns are about this part:<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
><br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
</span>> /"Then, afaict, a part of this commit is more about QGIS 3 changes and I<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
<span class="m_7968871423247261548m_5910566185164451101m_5604838996975160140m_5749235124859211397gmail- m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">> am not sure we are currently documenting QGIS3 stuffs (still waiting for<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
> comments and decision in this thread<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
</span>> <<a href="https://lists.osgeo.org/pipermail/qgis-psc/2017-January/005060.html" rel="noreferrer" class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg" target="_blank">https://lists.osgeo.org/pipermail/qgis-psc/2017-January/005060.html</a>>)."<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
><br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
> /<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
<span class="m_7968871423247261548m_5910566185164451101m_5604838996975160140m_5749235124859211397gmail- m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">> So, with my email, I just wanted to go back to the discussion of what<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
> versions we are planning/want to release and have a decision. Also, make<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
> sure that whatever the decision on that, we have a solution that does<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
> not put a developer's (or anyone else) PR on hold (not merged) if they<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
> want to contribute documentation for the current is master version.<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
> Mainly because people's availability and motivation can be affected by that.<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
</span>Hi Alexandre,<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
the main reason holding back 3.0 descriptions from master is to be able<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
to release a (nowadays pretty theoretical?) new LTR in 2.x branch.<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
This in case that waiting for a stable 3.x (plus a reasonable set of<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
working python plugins!) would take too long, and the community would<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
decide or ask for another 2.x release to be able to do their daily work<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
with QGIS.<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
IF we are more or less sure that there will NO MORE 2.x QGIS (LTR's?)<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
anymore, we can decide to lift this clear 2.x - 3.x separation (thanks<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
Harrissou for defending this :-) ).<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"></blockquote><blockquote class="gmail_quote m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
So the main question is: do we decide to NOT release a newer<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
documentation(!) 2.x branch anymore this year.<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
Regards,<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
Richard<br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg">
</blockquote></div><br class="m_7968871423247261548m_5910566185164451101m_5604838996975160140gmail_msg gmail_msg"></div></div></div></div></blockquote></div></div></div><div class="m_7968871423247261548m_5910566185164451101HOEnZb gmail_msg"><div class="m_7968871423247261548m_5910566185164451101h5 gmail_msg"><div dir="ltr" class="gmail_msg">-- <br class="gmail_msg"></div><div data-smartmail="gmail_signature" class="gmail_msg"><div dir="ltr" class="gmail_msg"><div class="gmail_msg">Alexandre Neto</div><div class="gmail_msg">---------------------</div><div class="gmail_msg">@AlexNetoGeo</div><div class="gmail_msg"><a href="http://sigsemgrilhetas.wordpress.com" class="gmail_msg" target="_blank">http://sigsemgrilhetas.wordpress.com</a></div><a href="http://gisunchained.wordpress.com" class="gmail_msg" target="_blank">http://gisunchained.wordpress.com</a><br class="gmail_msg"></div></div>
</div></div></blockquote></div></div></div></blockquote></div><div dir="ltr" class="gmail_msg">-- <br class="gmail_msg"></div><div data-smartmail="gmail_signature" class="gmail_msg"><div dir="ltr" class="gmail_msg"><div class="gmail_msg">Alexandre Neto</div><div class="gmail_msg">---------------------</div><div class="gmail_msg">@AlexNetoGeo</div><div class="gmail_msg"><a href="http://sigsemgrilhetas.wordpress.com" class="gmail_msg" target="_blank">http://sigsemgrilhetas.wordpress.com</a></div><a href="http://gisunchained.wordpress.com" class="gmail_msg" target="_blank">http://gisunchained.wordpress.com</a><br class="gmail_msg"></div></div></blockquote></div><div dir="ltr">-- <br></div><div data-smartmail="gmail_signature"><div dir="ltr"><div>Alexandre Neto</div><div>---------------------</div><div>@AlexNetoGeo</div><div><a href="http://sigsemgrilhetas.wordpress.com">http://sigsemgrilhetas.wordpress.com</a></div><a href="http://gisunchained.wordpress.com">http://gisunchained.wordpress.com</a><br></div></div>