Release notes for v0.19

Here's the place for discussion related to coding in FreeCAD, C++ or Python. Design, interfaces and structures.
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
Post Reply
triplus
Veteran
Posts: 9471
Joined: Mon Dec 12, 2011 4:45 pm

Re: Release notes for v0.19

Post by triplus »

We have been talking about adding possible QtWebEngine support for years now and it has just happened:

https://github.com/FreeCAD/FreeCAD/pull/1937

Likely it makes sense to mention that. Under i guess the general notes about the current state of porting to Python 3 and Qt 5 (or under Web Workbench). A note that porting to Python 3 and Qt 5 effort is considered done and mature. That will likely make sense too. At the end of the development cycle. As a month or two back, most developer already stated, they have moved to using Py3/Qt5 toolchain.
User avatar
sliptonic
Veteran
Posts: 3457
Joined: Tue Oct 25, 2011 10:46 pm
Location: Columbia, Missouri
Contact:

Re: Release notes for v0.19

Post by sliptonic »

mlampert's PR 2056 was merged today.

This adds the ability to have multiple copies of a Path job base object.
triplus
Veteran
Posts: 9471
Joined: Mon Dec 12, 2011 4:45 pm

Re: Release notes for v0.19

Post by triplus »

Yes, this is the ideal scenario. When a module developer(s) highlights a notable feature added. Some text, images or videos can get accumulated under an appropriate release notes sections. Like Path module section. Otherwise it would be hard to understand and keep track of everything, for a single person.
User avatar
Joel_graff
Veteran
Posts: 1949
Joined: Fri Apr 28, 2017 4:23 pm
Contact:

Re: Release notes for v0.19

Post by Joel_graff »

triplus wrote: Wed Apr 03, 2019 9:53 pm Yes, this is the ideal scenario. When a module developer(s) highlights a notable feature added. Some text, images or videos can get accumulated under an appropriate release notes sections. Like Path module section. Otherwise it would be hard to understand and keep track of everything, for a single person.
I'll go through and add this here in the next day or two - getting pulled in several directions lately. ;)

If I can just get 'tickled' here that there's an update / bug fix / feature add to put in the release notes, I have no problem digging further and finding better images, developing a description, etc, as well as noting the changes to the owner if they have a forum topic currently active.

Just wish I could make sense of coming through Mantis / github commits to update from there.
FreeCAD Trails workbench for transportation engineering: https://www.github.com/joelgraff/freecad.trails

pivy_trackers 2D coin3D library: https://www.github.com/joelgraff/pivy_trackers
User avatar
Kunda1
Veteran
Posts: 13434
Joined: Thu Jan 05, 2017 9:03 pm

Re: Release notes for v0.19

Post by Kunda1 »

I think we need something automated especially as the project grows, or @joelgraff you're subject to getting overwhelmed and we need you focused because of all the awesome work you do on Civil stuff. Automated in a way where the info you need is mostly there and easily apprehended. How do other projects do this?...and in a way where it frees up the core developers to focus more on core stuff.
Alone you go faster. Together we go farther
Please mark thread [Solved]
Want to contribute back to FC? Checkout:
'good first issues' | Open TODOs and FIXMEs | How to Help FreeCAD | How to report Bugs
User avatar
sliptonic
Veteran
Posts: 3457
Joined: Tue Oct 25, 2011 10:46 pm
Location: Columbia, Missouri
Contact:

Re: Release notes for v0.19

Post by sliptonic »

It's always a judgements call about what to include. The developer is probably the one best able to make the call.
The github pull request template has a set of questions like 'is the commit message well written?' perhaps it could include a question "does this pr include a feature to be included in the release notes?"
User avatar
Kunda1
Veteran
Posts: 13434
Joined: Thu Jan 05, 2017 9:03 pm

Re: Release notes for v0.19

Post by Kunda1 »

sliptonic wrote: Thu Apr 04, 2019 1:47 pm It's always a judgements call about what to include. The developer is probably the one best able to make the call.
The github pull request template has a set of questions like 'is the commit message well written?' perhaps it could include a question "does this pr include a feature to be included in the release notes?"
I agree, if we add it hopefully it doesn't discourage developers from contributing because writing documentation can be annoying.
Alone you go faster. Together we go farther
Please mark thread [Solved]
Want to contribute back to FC? Checkout:
'good first issues' | Open TODOs and FIXMEs | How to Help FreeCAD | How to report Bugs
User avatar
Joel_graff
Veteran
Posts: 1949
Joined: Fri Apr 28, 2017 4:23 pm
Contact:

Re: Release notes for v0.19

Post by Joel_graff »

Kunda1 wrote: Thu Apr 04, 2019 1:54 pm I agree, if we add it hopefully it doesn't discourage developers from contributing because writing documentation can be annoying.
sliptonic wrote: Thu Apr 04, 2019 1:47 pm It's always a judgements call about what to include. The developer is probably the one best able to make the call.
I tend to agree the devs should be primarily responsible for the release note content - it just makes the most sense, really.

It might be more useful to stay within this thread and use it as a portal for managing the release notes. To that end, I can update the release notes when I get notice here. Before a release, I can ping the owners / devs of the various workbenches to review the release notes and update them or at least provide me with updated information so I can update the wiki.
FreeCAD Trails workbench for transportation engineering: https://www.github.com/joelgraff/freecad.trails

pivy_trackers 2D coin3D library: https://www.github.com/joelgraff/pivy_trackers
User avatar
sliptonic
Veteran
Posts: 3457
Joined: Tue Oct 25, 2011 10:46 pm
Location: Columbia, Missouri
Contact:

Re: Release notes for v0.19

Post by sliptonic »

Joel_graff wrote: Thu Apr 04, 2019 2:57 pm
Kunda1 wrote: Thu Apr 04, 2019 1:54 pm I agree, if we add it hopefully it doesn't discourage developers from contributing because writing documentation can be annoying.
sliptonic wrote: Thu Apr 04, 2019 1:47 pm It's always a judgements call about what to include. The developer is probably the one best able to make the call.
I tend to agree the devs should be primarily responsible for the release note content - it just makes the most sense, really.
Yes. And No.
The dev is DEFINITELY the best one to make the decision. Whether they actually write the release note content kinda depends on what we want release notes to look like. If the pull request and commit messages are, in fact, well written, then there should be enough information present to write the release note as long as the notes are just text. But if they're going to be richer and include images, gifs, links, etc, then I wouldn't expect the dev to do that. I'd rather have them working on the next feature. :D
User avatar
Joel_graff
Veteran
Posts: 1949
Joined: Fri Apr 28, 2017 4:23 pm
Contact:

Re: Release notes for v0.19

Post by Joel_graff »

sliptonic wrote: Thu Apr 04, 2019 3:20 pm The dev is DEFINITELY the best one to make the decision. Whether they actually write the release note content kinda depends on what we want release notes to look like.
Right - I expect to write the release notes myself unless the dev would rather handle that. Having consistent formatting and concise summaries are critical because it's a public-facing document. But if I can get the majority of the notes to 'come to me' here, I'll definitely take that over hunting them down. :)
FreeCAD Trails workbench for transportation engineering: https://www.github.com/joelgraff/freecad.trails

pivy_trackers 2D coin3D library: https://www.github.com/joelgraff/pivy_trackers
Post Reply