[QGIS-Developer] Please help with the changelog for 3.12

Tim Sutton tim at kartoza.com
Sun Mar 1 11:21:01 PST 2020


Hi

That’s a bit of an odd question Paolo, I’m surprised that you would ask this….and also a bit surprising that Salvatore did this work without collaborating with us. The changelog we have built and operated for many years now allows for collaborative editing of entries in a structured way, properly edited for end users to read nicely and sorted into different categories with a feed that can be ingested into QGIS.org <http://qgis.org/> where it can be translated into multiple languages. And for the next release we will pull in the items automatically too so his work won’t really add anything that we don’t already have.


Regards

Tim

> On 1 Mar 2020, at 11:13, Paolo Cavallini <cavallini at faunalia.it> wrote:
> 
> Hi Tim, all,
> I surely miss something here, but what is the reason for our system? I
> have seen an interesting recent attempt by Salvatore:
> https://github.com/pigreco/changelog312 <https://github.com/pigreco/changelog312>
> which looks much easier to implement and update.
> Cheers.
> 
> Il 28/02/20 13:44, Tim Sutton ha scritto:
>> Hi Nyall (and others up for helping with the changelog)
>> 
>> Firstly apologies I couldn’t work on the changelog much on the run up to
>> the release. If those who added features in 3.12 could be so kind as to
>> add the ‘Changelog’ label to their PR’s and make sure the description in
>> the PR is nicely formatted, I will put them all through into the
>> changelog. Unfortunately I can’t (yet) slice it e.g. by date so I have
>> to do it in one go. I did go through about 18 pages!!! Of PR’s and tried
>> to add Changelog label to them but there are many many more pages of
>> PR’s to review. You guys are machines. Unfortunately the volunteer that
>> Paolo found last release to help with the changelog hasn’t resurfaced,
>> so anyone who can help will earn my (our) undying gratitude.
>> 
>> I am going to try to have the auto-adding of changelog entries (based on
>> a label) done mid cycle for the next release.
>> 
>> Regards
>> 
>> 
>> Tim
>> 
>>> On 11 Feb 2020, at 05:31, Nyall Dawson <nyall.dawson at gmail.com
>>> <mailto:nyall.dawson at gmail.com <mailto:nyall.dawson at gmail.com>>> wrote:
>>> 
>>> On Fri, 7 Feb 2020 at 19:49, Denis Rouzaud <denis.rouzaud at gmail.com <mailto:denis.rouzaud at gmail.com>
>>> <mailto:denis.rouzaud at gmail.com <mailto:denis.rouzaud at gmail.com>>> wrote:
>>>> 
>>>> Hi all,
>>>> 
>>>> It sounds that going through pull requests rather than the commits
>>>> make sense.
>>>> 
>>>> For now, I have created a small -- not anymore ;) -- script that will
>>>> output corresponding pull requests as JSON with title, HTML body and
>>>> author.
>>>> Working for this series, the script returns all PRs having [FEATURE]
>>>> in one of their commit message or in the PR title, within the
>>>> corresponding dates and targeting master
>>>> script: https://gist.github.com/3nids/0cf399297888ea8ebd0e64169c9fbbc2 <https://gist.github.com/3nids/0cf399297888ea8ebd0e64169c9fbbc2>
>>>> output (changelog):
>>>> https://gist.github.com/3nids/4f6e948a94526515391899a5701cce47 <https://gist.github.com/3nids/4f6e948a94526515391899a5701cce47>
>>> 
>>> Are you sure this is working? There's definitely items missing from
>>> this, e..g. https://github.com/qgis/QGIS/pull/33165 <https://github.com/qgis/QGIS/pull/33165>
>>> 
>>> Nyall
>>> 
>>> 
>>>> 
>>>> That should be easy to feed the changelog with this.
>>>> 
>>>> Probably for the future, it would be interesting to create a
>>>> Changelog label?
>>>> 
>>>> Best wishes,
>>>> 
>>>> Denis
>>>> 
>>>> 
>>>> Le jeu. 6 févr. 2020 à 00:25, Tim Sutton <tim at kartoza.com <mailto:tim at kartoza.com>
>>>> <mailto:tim at kartoza.com <mailto:tim at kartoza.com>>> a écrit :
>>>>> 
>>>>> Hi
>>>>> 
>>>>> On 5 Feb 2020, at 17:03, Matthias Kuhn <matthias at opengis.ch <mailto:matthias at opengis.ch>
>>>>> <mailto:matthias at opengis.ch <mailto:matthias at opengis.ch>>> wrote:
>>>>> 
>>>>> On 2/5/20 11:33 AM, Nyall Dawson wrote:
>>>>> 
>>>>> On Wed, 5 Feb 2020 at 20:29, Tim Sutton <tim at kartoza.com <mailto:tim at kartoza.com>
>>>>> <mailto:tim at kartoza.com <mailto:tim at kartoza.com>>> wrote:
>>>>> 
>>>>> Hi
>>>>> 
>>>>> 
>>>>> 
>>>>> On 4 Feb 2020, at 23:57, Nyall Dawson <nyall.dawson at gmail.com <mailto:nyall.dawson at gmail.com>
>>>>> <mailto:nyall.dawson at gmail.com <mailto:nyall.dawson at gmail.com>>> wrote:
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> Is it enough to just grab the items labelled ‘Feature’ - we are
>>>>> planning to automatically create entries from the changelog as part
>>>>> of the QGIS funded improvements we are doing
>>>>> 
>>>>> 
>>>>> In my experience... no. Some of us naughty developers don't always use
>>>>> this tag :(
>>>>> 
>>>>> 
>>>>> Now about we add a ‘Changelog’ tag that we can just go and add to
>>>>> each PR (either at the time of making it or retrosopectively) and we
>>>>> can just go through the PR queue and scan for those? Other options I
>>>>> guess is to strongly encourage people to use a relevant tag when
>>>>> they submit their PR.
>>>>> 
>>>>> Definitely. Like you've pointed out, it could be done retrospectively,
>>>>> and added also by others.
>>>>> 
>>>>> 
>>>>> What are the guidelines for using [feature] in the future? I think
>>>>> it acted as a combination of [needs docs], [changelog] and [look,
>>>>> this is cool] in the past. If the first two are about to be solved
>>>>> by more precise labels, do we keep it for the third one or are there
>>>>> other compelling reasons?
>>>>> 
>>>>> 
>>>>> For me, I don’t have any strong opinions - I think we will build the
>>>>> harvester to take a user-defined list of tags that should be
>>>>> harvested, so that we can deal with things flexibly. Basically just
>>>>> looking for advice on which tags I should use and then we will set
>>>>> it up to use those.
>>>>> 
>>>>> Thanks,
>>>>> 
>>>>> Tim
>>>>> 
>>>>> 
>>>>> 
>>>>> Matthias
>>>>> 
>>>>> 
>>>>>>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> Tim Sutton
>>>>> 
>>>>> Co-founder: Kartoza
>>>>> Ex Project chair: QGIS.org <http://qgis.org/> <http://QGIS.org <http://qgis.org/>>
>>>>> 
>>>>> Visit http://kartoza.com <http://kartoza.com/> to find out about open source:
>>>>> 
>>>>> Desktop GIS programming services
>>>>> Geospatial web development
>>>>> GIS Training
>>>>> Consulting Services
>>>>> 
>>>>> Skype: timlinux
>>>>> IRC: timlinux on #qgis at freenode.net <http://freenode.net/> <http://freenode.net <http://freenode.net/>>
>>>>> 
>>>>> I'd love to connect. Here's my calendar link to make finding time easy.
>>>>> 
>>>>> _______________________________________________
>>>>> QGIS-Developer mailing list
>>>>> QGIS-Developer at lists.osgeo.org <mailto:QGIS-Developer at lists.osgeo.org> <mailto:QGIS-Developer at lists.osgeo.org <mailto:QGIS-Developer at lists.osgeo.org>>
>>>>> List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer <https://lists.osgeo.org/mailman/listinfo/qgis-developer>
>>>>> Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer <https://lists.osgeo.org/mailman/listinfo/qgis-developer>
>> 
>>>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> *Tim Sutton*
>> 
>> *Co-founder:* Kartoza
>> *Ex Project chair:* QGIS.org <http://qgis.org/> <http://QGIS.org <http://qgis.org/>>
>> 
>> Visit http://kartoza.com <http://kartoza.com/> <http://kartoza.com/ <http://kartoza.com/>> to find out about open
>> source:
>> 
>> Desktop GIS programming services
>> Geospatial web development
>> GIS Training
>> Consulting Services
>> 
>> *Skype*: timlinux 
>> *IRC:* timlinux on #qgis at freenode.net <http://freenode.net/> <http://freenode.net <http://freenode.net/>>
>> 
>> I'd love to connect. Here's my calendar link
>> <https://calendly.com/timlinux <https://calendly.com/timlinux>> to make finding time easy.
>> 
>> 
>> _______________________________________________
>> QGIS-Developer mailing list
>> QGIS-Developer at lists.osgeo.org <mailto:QGIS-Developer at lists.osgeo.org>
>> List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer <https://lists.osgeo.org/mailman/listinfo/qgis-developer>
>> Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer <https://lists.osgeo.org/mailman/listinfo/qgis-developer>
>> 
> 
> -- 
> Paolo Cavallini - www.faunalia.eu <http://www.faunalia.eu/>
> QGIS.ORG <http://qgis.org/> Chair:
> http://planet.qgis.org/planet/user/28/tag/qgis%20board/ <http://planet.qgis.org/planet/user/28/tag/qgis%20board/>
> _______________________________________________
> QGIS-Developer mailing list
> QGIS-Developer at lists.osgeo.org <mailto:QGIS-Developer at lists.osgeo.org>
> List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer <https://lists.osgeo.org/mailman/listinfo/qgis-developer>
> Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer <https://lists.osgeo.org/mailman/listinfo/qgis-developer>
—









Tim Sutton

Co-founder: Kartoza
Ex Project chair: QGIS.org

Visit http://kartoza.com <http://kartoza.com/> to find out about open source:

Desktop GIS programming services
Geospatial web development
GIS Training
Consulting Services

Skype: timlinux 
IRC: timlinux on #qgis at freenode.net

I'd love to connect. Here's my calendar link <https://calendly.com/timlinux> to make finding time easy.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-developer/attachments/20200301/5046ab0f/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: KartozaNewLogoThumbnail.jpg
Type: image/jpeg
Size: 6122 bytes
Desc: not available
URL: <http://lists.osgeo.org/pipermail/qgis-developer/attachments/20200301/5046ab0f/attachment-0001.jpg>


More information about the QGIS-Developer mailing list