Hi Brian, many thanks for your comments :-) I've reworded the page following your advice, so hopefully it makes more sense now. Haven't had a lot of sleep lately so it isn't unexpected that the text got dense..
anyway thanks again; if you see the page isn't still clear enough, plese feel free to edit as you see fit. br, juan pablo On Thu, Nov 29, 2018 at 11:36 PM Brian Burch <br...@pingtoo.com> wrote: > 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 > >>> > >> > > > >
