[QGIS-Developer] Changelog for 3.8! ARgh!

Fri Jun 21 00:03:38 PDT 2019

Hi

> On 21 Jun 2019, at 08:50, Matthias Kuhn <matthias at opengis.ch> wrote:
> 
> Hi Nyall,
> 
> Ouch, that's a real pity. Releasing the version without a changelog is a communication-GAU we should try to avoid.
> 
> As a first step I have just added the new version to projecta http://changelog.qgis.org/en/qgis/version/3.8/ <http://changelog.qgis.org/en/qgis/version/3.8/>
> 
> I'll try to fill it up at least with some basics, but I won't be able to do it all on my own, so anyone else with a bit of spare time please jump in and fill the gaps!
> 
> If we ship the next release towards mid next week we should be able to put together something if everyone spends some time.
> 
> 
> Now that this is sorted out:
> 
> Yes, I think it would make a lot of sense to integrate the changelog creation directly with labels into pull requests.
> 
> Since projecta is also based on markdown this should all play nicely together. And we could even add an (optional) #Changelog section to the pull requests and some other tags to automatically set funder etc. so one could already write the whole changelog entry during the development cycle. That should easily pay back with all the volunteer time that is saved during the already busy run up time to release!
> 
> Resource wise, most the allocated time in the grant proposal is for getting the service up and running and integrating with all the notification hooks. Parsing the content and sending it to another API should be pretty much straightforward. The main question would rather be if creation of new versions can also be automated and how to decide to which version a new feature should be sent (i.e. find out the "current" version). The best match for this would probably be to use github milestones. In the end I would say that this should increase the offer by 20%.
> 
> Tim, is everything ready on your end for that?

So yes we would be happy to pitch in to help here. Admire can help more immediately by getting this changelog ready and we can work with Anita (Hapsari) to get things in place to support PR githook thing-a-me-doodahs. (See my reply to OP)

Regards

Tim

> 
> Best regards
> 
> Matthias
> 
> 
> On 6/21/19 2:52 AM, Nyall Dawson wrote:
>> Hey all,
>> 
>> It just struck me that we're finalizing 3.8 in < 24 hours, and our
>> visual changelog is.... completely non-existent. As in, we have NO
>> entries, and not even a version number created yet.
>> 
>> This is far from ideal, since the visual changelog is basically the
>> only way we have of informing users of all the lovely new toys we've
>> spent the last 4 months slaving away at making. If users don't even
>> know these exist, there's basically no point in writing them :(
>> 
>> In the past I've spent considerable time in the lead up to a release
>> trawling through the git logs and adding dummy entries for all new
>> features/stuff to highlight, which a handful of others have then spent
>> HOURS fleshing out into pretty/nicely readable entries. Unfortunately
>> I have no spare time to do that this round.
>> 
>> Suffice to say, I think it's clear that this process was never great,
>> and has totally broken down this time.
>> 
>> It seems to me like Matthias' grant proposal covering documentation
>> Pull Requests would tie in very nicely here. If that proposal is
>> successful, and he can get the contents of feature pull requests
>> pushed to documentation PRs, then it's a natural step to extend this
>> and also push the same feature PR descriptions automatically to the
>> changelog.
>> 
>> So I have some questions:
>> 1. Matthias: Do you think this would be a possible extension of your
>> proposal? How much extra would you need to cover it?
>> 2. Tim: Does the changelog API already exist which would make this
>> possible? OR if not, would it be tricky/costly to develop?
>> 3. How can we make this a reality? Who needs payment, and who can make
>> this payment happen?
>> 
>> -- OR --
>> 
>> 4. Who is going to take this on for future releases and ensure we have
>> a changelog ready to go at launch time?
>> 
>> and finally, the most pertinent question right now:
>> 
>> 5. Who the heck can get a changelog in place for 3.8.0? Who has 2-3
>> days spare they want to volunteer into getting this in place?
>> 
>> Nyall
>> _______________________________________________
>> 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>
>> 
> _______________________________________________
> 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/20190621/9efb4b1d/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/20190621/9efb4b1d/attachment-0001.jpg>