On 30/11/18 7:54 am, Juan Pablo Santos Rodríguez wrote:
Hi,
I've came up with https://jspwiki-wiki.apache.org/Wiki.jsp?page=NewIn2.11
which will be refered on the upcoming release. It contains a "What does
that M# mean anyway?" section which I'd thank a lot if someone could review
it
OK Juan Pablo, I will bite on your bait!
Quoting in full....
"Said that, the M# is only there to note that the release has happened
in the middle of a transition to a "major" release, so next releases
could still have breaking changes and still retain the release
numbering. It does not mean the release is incomplete, only for the
brave, in beta or something along those lines. These releases should be
as production-ready as any other JSPWiki release."
Sorry to pick this important paragraph apart, but you did ask for
comments!!!
1. The English I learnt (a very long time ago) at school taught me to
say "That said,..." rather than "Said that,.." in this particular
context. It doesn't bother me in the slightest, but perhaps you might
like to change it given my next comments are probably more worthy of a
change to the paragraph?
2. "It does not.." before the sentence "These Releases.." is a bit of a
"glass half-empty" approach, rather than an upbeat "glass half full"
one. I would switch those sentences around so anyone who is reading the
paragraph is reassured first, rather than warned.
3. I found the "These Releases.." sentence confusing, even though I
thought I knew what it meant. Did you mean to say "for example,
2.11.0-M1 might (or might not) be followed by 2.11.0-M2, but backward
compatibility with 2.11.0 would be maintained across this family of
stable sub-releases (aka milestones)." I hope my version is what you
mean to say, but if you mean the opposite then it should be highlighted
as some sort of serious warning and be accompanied with a pointer on how
to evaluate the risk of breakage in any particular upgrade case.
I hope my comments are helpful, because they are made by someone who has
a long history with jspwiki and a keen interest in this new milestone
release.
Also, most probably I won't be able to run the vote until next Monday, so
the release most probably will delay a few days.. :-/
I've been lurking on the dev list for years and recently my own plugins
broke for no apparent reason (NOT jspwiki). Instead of fixing the
immediate problem, I intend to move my production system onto 2.11, no
matter how painful that might be to get my plugins working again. I am
not expecting to have an easy "ride" from 2.10.3-git-32.
Take your time with M1. I for one am very grateful for all the work you
and the team have done so far and I look forward to moving from a clunky
"default" skin to a nice "fishy" new one!
HTH Brian
best regards,
juan pablo
On Tue, Nov 27, 2018 at 3:34 PM Harry Metske <harry.met...@gmail.com> wrote:
sounds all good.
thanks for all your efforts
regards,
Harry
Op zo 25 nov. 2018 om 21:18 schreef Juan Pablo Santos Rodríguez <
juanpablo.san...@gmail.com>
Hi,
I'd like to proceed with the vote of our next release, 2.11.0-M1, next
week. I've to come up with a new in 2.11 wiki page, and put in there what
does those Msomething means and main features for this release (Haddock
by
default, new wiki pages, Java 8, new maven coordinates for jspwiki jar,
breaking changes, etc.). If all goes well, I'm expecting we could have
the
release out by 2/3rd of December.
br,
juan pablo
