<div dir="ltr"><div><div><div><div><div>Yves, with the API break due to 3.x releases, there are now two branches in qgis/QGIS repository:<br></div>- master for 3.0 commits<br></div>- and master_2 for 2.18 commits (where there's no API break)<br></div>As already mentioned earlier in this thread, all fixes or new features in master_2 are also present in master.<br><br></div>Then, with the automatic creation of issues in QGIS-Documentation repo, we can get features from master as well as master_2 (examples in my latest message). By default, they are labeled 3.0. All we need to do is (re)label some of them according to the branch they belong to in QGIS repo (master --> 3.0, master_2 --> 2.18).<br></div>For the doc writing, I think that as usual, we'll be tackling 2.16 issues for the moment (as it's the released version) in doc master branch. One release at a moment. The other releases are not concerned for the moment.<br><br></div><div class="gmail_extra"><br><div class="gmail_quote">2016-07-27 11:56 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">Harrissou,<br>
<br>
I am ok to add a new 2.18 milestone, but take care of the work needed to<br>
manage two release.<br>
<br>
I am +1 to manage 3.0 as a normal doc release, just a +0 to manage 2.18.<br>
<br>
Where the feature will be added? in doc master? Does it mean that we need to<br>
only add feature for 2.18, not for 3.0 in doc master?<br>
<br>
Y.<br>
<div><div class="h5">On Wednesday, July 27, 2016 11:44:17 DelazJ wrote:<br>
> Hi,<br>
> Thanks for your comments<br>
><br>
> Richard, I'll be doing it by hand for the moment, meaning that I'll create<br>
> a 2.18 milestone and put issues from master_2 inside (often duplicated in<br>
> 3.0, such as <a href="https://github.com/qgis/QGIS-Documentation/issues/1208" rel="noreferrer" target="_blank">https://github.com/qgis/QGIS-Documentation/issues/1208</a> vs<br>
> <a href="https://github.com/qgis/QGIS-Documentation/issues/1207" rel="noreferrer" target="_blank">https://github.com/qgis/QGIS-Documentation/issues/1207</a>; i'll then remove<br>
> the copy from 3.0 milestone)<br>
><br>
> Do you agree with this process?<br>
> Even if we do not know now if a 2.18 doc will be released, at least we'd<br>
> have kept needed elements to write it if decision is made (will require<br>
> more writers involved).<br>
><br>
><br>
> Harrissou<br>
><br>
> 2016-07-20 23:17 GMT+02:00 Richard Duivenvoorde <<a href="mailto:rdmailings@duif.net">rdmailings@duif.net</a>>:<br>
> > On 20-07-16 09:29, Yves Jacolin wrote:<br>
> > > Matthias, Harrissou,<br>
> > ><br>
> > > On Wednesday, July 20, 2016 9:12:17 Matthias Kuhn wrote:<br>
> > >> Hi Harrissou<br>
> > >><br>
> > >> On 07/20/2016 08:47 AM, DelazJ wrote:<br>
> > >> [..]<br>
> > >><br>
> > >>> So questions:<br>
> > >>> - Will we have a 2.18 (if ever) documentation?<br>
> > >><br>
> > >> I think it would be good to plan 2.18 in general. Triggering the<br>
> > >> release<br>
> > >> scripts should be trivial. Since some features end up in 2.18, I guess<br>
> > >> it will happen.<br>
> > >> Concerning docs and also pre-release fixing, I wonder if this effort<br>
> > >> should be spent on the 3.0 migration instead?<br>
> > ><br>
> > > So, either we can know which feature is in 2.18 and which in 3.0 and we<br>
> ><br>
> > can<br>
> ><br>
> > > target the ticket (in the doc repository) in the two milestone and<br>
> ><br>
> > without<br>
> ><br>
> > > much work, or we can't.<br>
> > ><br>
> > > Anyway, as we are "still" working in the 2.16 release,  I guess we can<br>
> ><br>
> > aims to<br>
> ><br>
> > > release it at the end of the year, not before.<br>
> > ><br>
> > > Next, we should focus on 3.0 to get the doc ready for QGIS 3.0, at the<br>
> > > beginning of 2017.<br>
> > ><br>
> > > So +1 for your proposition.<br>
> > ><br>
> > >> [..]<br>
> > >><br>
> > >>> - Should the webhook set different milestions according to the branch<br>
> > >>> used?<br>
> > >><br>
> > >> Yes, master_2 => 2.18, master => 3.0.<br>
> > ><br>
> > > Are you sure? 2.18 milestone doesn't exist in the QGIS doc repository.<br>
> > ><br>
> > >> Has there ever been a documentation released for 2.10 and 2.12?<br>
> > >> If non-LTR get no documentation, there's probably not much point in<br>
> > >> doing one for 2.18 I think?<br>
> > >> People can still refer to the "testing" doc from master instead which<br>
> > >> should match in many points (and where not, some notes can be<br>
> > >> included).<br>
> > ><br>
> > > Indeed, but this is more a consequence than a cause. In the mid term I<br>
> ><br>
> > prefer<br>
> ><br>
> > > that we add new feature in the doc in the same time that the ticket is<br>
> ><br>
> > created<br>
> ><br>
> > > and so get a documentation release for each QGIS release.<br>
> ><br>
> > We tried in history, but the doc (and doc release-) team could just not<br>
> > cope with all the releases. So we more or less decided to only build (at<br>
> > least translated) the docs for LTR versions.<br>
> ><br>
> > 2.16 is non-ltr and 2.18 is a special case.. so I would also be OK to<br>
> > concentrate on a docs build  for 3.0. So only pick features which will<br>
> > be ported to 3.0 from 2.16 and 2.18 etcetc<br>
> ><br>
> > But we can off course try to follow... currently '[FEATURE]' is<br>
> > automatically labeled as 3.0 milestone...<br>
> > IF we want to distinguish between those, we either have to fix the script:<br>
> ><br>
> > <a href="https://github.com/qgis/QGIS-Sysadmin/blob/master/webhooks/github_feature_" rel="noreferrer" target="_blank">https://github.com/qgis/QGIS-Sysadmin/blob/master/webhooks/github_feature_</a><br>
</div></div>> > tracker.cgi Or do it by hand...<br>
<div class="HOEnZb"><div class="h5">> ><br>
> > Regards,<br>
> ><br>
> > Richard<br>
> > _______________________________________________<br>
> > Qgis-developer mailing list<br>
> > <a href="mailto:Qgis-developer@lists.osgeo.org">Qgis-developer@lists.osgeo.org</a><br>
> > List info: <a href="http://lists.osgeo.org/mailman/listinfo/qgis-developer" rel="noreferrer" target="_blank">http://lists.osgeo.org/mailman/listinfo/qgis-developer</a><br>
> > Unsubscribe: <a href="http://lists.osgeo.org/mailman/listinfo/qgis-developer" rel="noreferrer" target="_blank">http://lists.osgeo.org/mailman/listinfo/qgis-developer</a><br>
<br>
</div></div></blockquote></div><br></div>