name FreeCAD 0.91 instead of 0.20, means version after 0.19 could be 0.91

Have some feature requests, feedback, cool stuff to share, or want to know where FreeCAD is going? This is the place.
Forum rules
Be nice to others! Read the FreeCAD code of conduct!
User avatar
kkremitzki
Posts: 1796
Joined: Thu Mar 03, 2016 9:52 pm
Location: Texas

Re: name FreeCAD 0.91 instead of 0.20, means version after 0.19 could be 0.91

Postby kkremitzki » Fri Mar 29, 2019 7:41 pm

Mark Szlazak wrote:
Fri Mar 29, 2019 7:34 pm

Yes that is what i said. Which means it is more information than version numbers like 1.0, etc.
You said current, which is not the same thing as recent.
Like my FreeCAD work? I'd appreciate any level of support via Patreon, Liberapay, or PayPal! Read more about what I do at my blog.
User avatar
Joel_graff
Posts: 1580
Joined: Fri Apr 28, 2017 4:23 pm
Contact:

Re: name FreeCAD 0.91 instead of 0.20, means version after 0.19 could be 0.91

Postby Joel_graff » Fri Mar 29, 2019 7:57 pm

kkremitzki wrote:
Fri Mar 29, 2019 3:16 pm
Also, there are actually several issues being discussed here:
1. should we drop the leading 0 in the version to communicate FreeCAD's maturity (and stop communicating its immaturity)
2. should we have a 1.0 release to communicate FreeCAD's readiness for wide usage
3. should we use a major.minor.patch or year.date versioning system
Hmmm... some of the above. :)

I like the last two digits of the year best. And I kinda like the idea of adopting an ubuntu style of versioning.

I'd vote for year.month.patch.

Month could be optional, and the year could be 2 or 4 digits, so any of the following make sense to me:

19.xxx, 19.04.xxx, 2019.xxx, 2019.04.xxx
(xxx = patch number)
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
wmayer
Site Admin
Posts: 14999
Joined: Thu Feb 19, 2009 10:32 am

Re: name FreeCAD 0.91 instead of 0.20, means version after 0.19 could be 0.91

Postby wmayer » Fri Mar 29, 2019 8:08 pm

so... how about App::Link ? Is this the goal for v0.19 ? (or any next version)
Yes, that's the plan.
User avatar
bernd
Posts: 8486
Joined: Sun Sep 08, 2013 8:07 pm
Location: Zürich, Switzerland

Re: name FreeCAD 0.91 instead of 0.20, means version after 0.19 could be 0.91

Postby bernd » Fri Mar 29, 2019 8:46 pm

kkremitzki wrote:
Fri Mar 29, 2019 7:14 pm
... Your third yes is in response to a either/or question.
bernd wrote:
Fri Mar 29, 2019 7:10 pm
3. should we use a major.minor.patch
yes
User avatar
bernd
Posts: 8486
Joined: Sun Sep 08, 2013 8:07 pm
Location: Zürich, Switzerland

Re: name FreeCAD 0.91 instead of 0.20, means version after 0.19 could be 0.91

Postby bernd » Fri Mar 29, 2019 8:46 pm

wmayer wrote:
Fri Mar 29, 2019 8:08 pm
so... how about App::Link ? Is this the goal for v0.19 ? (or any next version)
Yes, that's the plan.
:D
User avatar
bejant
Posts: 5953
Joined: Thu Jul 11, 2013 3:06 pm

Re: name FreeCAD 0.91 instead of 0.20, means version after 0.19 could be 0.91

Postby bejant » Fri Mar 29, 2019 10:20 pm

kkremitzki wrote:
Fri Mar 29, 2019 3:16 pm
Also, there are actually several issues being discussed here:
1. should we drop the leading 0 in the version to communicate FreeCAD's maturity (and stop communicating its immaturity)
2. should we have a 1.0 release to communicate FreeCAD's readiness for wide usage
3. should we use a major.minor.patch or year.date versioning system
A1. Again I'd say yes, conditionally, after topological naming has been implemented and proven reliable. (I've included my opinion about including Assembly in FreeCAD version 1.0 toward the end of this post).

A2. If the FreeCAD release numbering system is going to be changed from 0.xx.commit to 1.0 or 1.0.commit, I think that it would be confusing to the general public to then change again to a yyyy.mm or yy.mm.commit release numbering system. But I can surely understand that people would want to have 1.0 as a celebratory release version.

A3. I don't think that including the mm (two-digit month abbreviation) in what would be a yyyy.mm release numbering scheme adds much worthwhile information, unless FreeCAD development becomes so rapid that there might be more than one "stable" release per year. Until that happens, to me it seems that "FreeCAD 2019" or "FreeCAD 2020" would work well and be appropriate. I'm becoming fonder of the "FreeCAD YYYY" suggestion. I see it as a corollary to "It's Done When It's Done": similarly FreeCAD 2019, FreeCAD 2020, and like numbered releases suggest that the FreeCAD release simply "Is What It Is".
Again this is only my 2 cents worth, and I don't have very strong opinions about the numbering scheme. I'm simply offering my suggestions because I care about FreeCAD.

wmayer wrote:
Tue Mar 26, 2019 9:38 pm
And seriously what else do you expect from me? I have to check the majority of PRs, fix bugs listed in our bug tracker, make sure that FreeCAD compiles on a wide range of different platforms with different versions of libraries, participate on several development discussion, help newcomers to get their things done who use the FreeCAD API, look through the results of code checkers regularly offered by saso to improve code quality, ... while for several years I have nearly no time any more to implement the stuff that I am interested in.
Thank you, Werner, for all the work you do, and have already done. Unfortunately no matter what, or how much, you contribute there will always be some people who aren't happy about it, will be critical, and so on.

wmayer wrote:
Wed Mar 27, 2019 9:30 am
bejant wrote:
Wed Mar 27, 2019 2:40 am
Just to post before the topic gets locked:
I like the 0.xx numbering convention FreeCAD has been using, and think a 1.0 release could wait until after Topological Naming has been implemented and proven successful...
As far as I remember from discussions with Jürgen the plan to switch to version 1.0 was when the most important issues are solved:
it's the topological naming as you said and the assembly workbench.
My opinion is that Assembly isn't so important to have in the first 1.0 or non 0.xx release, in part because people have already been creating assemblies for years without having had an Assembly WB. FreeCAD also has Placement, the Edit > Alignment tool, and the Draft WB > Move tool, so at least some rudimentary Assembly capability exists.
Mark Szlazak
Posts: 407
Joined: Tue Apr 04, 2017 6:06 pm
Location: Edmonton, Canada

Re: name FreeCAD 0.91 instead of 0.20, means version after 0.19 could be 0.91

Postby Mark Szlazak » Sat Mar 30, 2019 2:37 am

bejant wrote:
Fri Mar 29, 2019 10:20 pm
kkremitzki wrote:
Fri Mar 29, 2019 3:16 pm
Also, there are actually several issues being discussed here:
1. should we drop the leading 0 in the version to communicate FreeCAD's maturity (and stop communicating its immaturity)
2. should we have a 1.0 release to communicate FreeCAD's readiness for wide usage
3. should we use a major.minor.patch or year.date versioning system
A1. Again I'd say yes, conditionally, after topological naming has been implemented and proven reliable. (I've included my opinion about including Assembly in FreeCAD version 1.0 toward the end of this post).

A2. If the FreeCAD release numbering system is going to be changed from 0.xx.commit to 1.0 or 1.0.commit, I think that it would be confusing to the general public to then change again to a yyyy.mm or yy.mm.commit release numbering system. But I can surely understand that people would want to have 1.0 as a celebratory release version.

A3. I don't think that including the mm (two-digit month abbreviation) in what would be a yyyy.mm release numbering scheme adds much worthwhile information, unless FreeCAD development becomes so rapid that there might be more than one "stable" release per year. Until that happens, to me it seems that "FreeCAD 2019" or "FreeCAD 2020" would work well and be appropriate. I'm becoming fonder of the "FreeCAD YYYY" suggestion. I see it as a corollary to "It's Done When It's Done": similarly FreeCAD 2019, FreeCAD 2020, and like numbered releases suggest that the FreeCAD release simply "Is What It Is".
Again this is only my 2 cents worth, and I don't have very strong opinions about the numbering scheme. I'm simply offering my suggestions because I care about FreeCAD.

wmayer wrote:
Tue Mar 26, 2019 9:38 pm
And seriously what else do you expect from me? I have to check the majority of PRs, fix bugs listed in our bug tracker, make sure that FreeCAD compiles on a wide range of different platforms with different versions of libraries, participate on several development discussion, help newcomers to get their things done who use the FreeCAD API, look through the results of code checkers regularly offered by saso to improve code quality, ... while for several years I have nearly no time any more to implement the stuff that I am interested in.
Thank you, Werner, for all the work you do, and have already done. Unfortunately no matter what, or how much, you contribute there will always be some people who aren't happy about it, will be critical, and so on.

wmayer wrote:
Wed Mar 27, 2019 9:30 am
bejant wrote:
Wed Mar 27, 2019 2:40 am
Just to post before the topic gets locked:
I like the 0.xx numbering convention FreeCAD has been using, and think a 1.0 release could wait until after Topological Naming has been implemented and proven successful...
As far as I remember from discussions with Jürgen the plan to switch to version 1.0 was when the most important issues are solved:
it's the topological naming as you said and the assembly workbench.
My opinion is that Assembly isn't so important to have in the first 1.0 or non 0.xx release, in part because people have already been creating assemblies for years without having had an Assembly WB. FreeCAD also has Placement, the Edit > Alignment tool, and the Draft WB > Move tool, so at least some rudimentary Assembly capability exists.
I have no problem dropping the month part after the year but still having year (of release) gives more information to people using FreeCAD than say 1.0. Using 1.0 so that a few can momentarily celebrate over the many users that would continuely get more information on a year-based versions number schemes seems like a step backward.
User avatar
bernd
Posts: 8486
Joined: Sun Sep 08, 2013 8:07 pm
Location: Zürich, Switzerland

Re: name FreeCAD 0.91 instead of 0.20, means version after 0.19 could be 0.91

Postby bernd » Sat Mar 30, 2019 6:25 am

bejant wrote:
Fri Mar 29, 2019 10:20 pm
My opinion is that Assembly isn't so important to have in the first 1.0 or non 0.xx release, in part because people have already been creating assemblies for years without having had an Assembly WB. FreeCAD also has Placement, the Edit > Alignment tool, and the Draft WB > Move tool, so at least some rudimentary Assembly capability exists.
+1
abdullah
Posts: 3174
Joined: Sun May 04, 2014 3:16 pm

Re: name FreeCAD 0.91 instead of 0.20, means version after 0.19 could be 0.91

Postby abdullah » Sat Mar 30, 2019 7:11 am

kkremitzki wrote:
Fri Mar 29, 2019 3:16 pm
I'm not a fan of year.date versioning systems because doesn't allow you to communicate the significance of the changes in a new version, just that it's newer, but dotted decimal versions can do that too.
Would it make sense to have a major for version followed by a yy.mm or it would be an abherration?

Something like: 1-19.03 or 1.19.03.

I am not sure if this is better (more information) or worst (poor cohesion by mixing traditional versioning with release date information).
User avatar
kkremitzki
Posts: 1796
Joined: Thu Mar 03, 2016 9:52 pm
Location: Texas

Re: name FreeCAD 0.91 instead of 0.20, means version after 0.19 could be 0.91

Postby kkremitzki » Sat Mar 30, 2019 7:14 am

abdullah wrote:
Sat Mar 30, 2019 7:11 am

Would it make sense to have a major for version followed by a yy.mm or it would be an abherration?

Something like: 1-19.03 or 1.19.03.

I am not sure if this is better (more information) or worst (poor cohesion by mixing traditional versioning with release date information).
Hah, I'm not sure if it's any better either. Whether major.minor.patch, YY.M.patch, or any other variation, does not matter too much to me, so long as the 0 is dropped. With a topic like this it's probably something Werner/Yorik will have to decide on.
Like my FreeCAD work? I'd appreciate any level of support via Patreon, Liberapay, or PayPal! Read more about what I do at my blog.