FINERACT-2306: release doc fixes
* docs: link directly to FINERACT-873 and shorten it for brevity / clarity * fineract plugin: * print email, don't send (WIP, but I might keep this... I prefer manually sending emails for now.) * support different release date and release branch date I originally modified EmailService (disabling the actual email sending by just commenting it out) but I reverted that change per discussion with Ádám Sághy. You won't see this in the squashed final commit so I'm mentioning it here for posterity. Ádám wrote: > Is there a reason to remove the email sending? I replied: > Great question. I did think about this for a bit. I should have been more transparent about my intent. Allow me to explain. > > For the 1.12.0 release process I used the groovy code to generate email templates, but I wanted to edit the emails before sending so I disabled this line, and intentionally left it so, figuring I'd be the one using and [hopefully minimally] maintaining it for now. > > The Fineract (release) plugin appears to be more or less unmaintained for about 2 1/2 years now (save the semiautomated dependency updates). Looking at the code and history, I assumed I was the only one that would be using it now and in the near future. It also struck me how most everything it does is primarily to work around antiquated Apache release process steps that are not necessarily what we want for Fineract. Personally I think the Fineract release plugin should be simply replaced by a better release process. > > I think I'll add a comment there, and of course I welcome your feedback. > > Anyway yeah, my intent here was simply to do the simplest, safest, and most useful change here so I could keep this release plugin limping along until we improve the release process itself. No disrespect to @vidakovic and @vorburger and whomever else poured love into this code over the years. Perhaps the options for releasing Apache code have improved since then? > > Today we can of course do better (e.g. just let GitHub help us release with far fewer clicks/steps). > > Also I am not proposing we change the release process today or even soon. Maybe in a quarter or two I'll propose changes, if/when there seems to be political will around that. Ádám replied: > hmm... i am not particularly mind if you are reworking the release process, but i think having a "send" step which was meant to sending a mail but now the actual sending got commented out is misleading, no? I replied: > Yep, you're right. I think I'll just back out this change because I agree with you it's bad to just leave the send() call commented out without any other changes.
This commit is contained in:
@@ -194,7 +194,7 @@ class FineractPlugin implements Plugin<Project> {
|
||||
|
||||
String version = project.properties?['fineract.release.version']
|
||||
String issue = project.properties?['fineract.release.issue']
|
||||
String date = project.properties?['fineract.release.date']
|
||||
String date = project.properties?['fineract.releaseBranch.date']
|
||||
|
||||
if(!version || !issue || !date) {
|
||||
TextIO textIO = TextIoFactory.getTextIO()
|
||||
@@ -225,7 +225,7 @@ class FineractPlugin implements Plugin<Project> {
|
||||
|
||||
this.context?.project?['fineract.release.version'] = version
|
||||
this.context?.project?['fineract.release.issue'] = issue
|
||||
this.context?.project?['fineract.release.date'] = date
|
||||
this.context?.project?['fineract.releaseBranch.date'] = date
|
||||
|
||||
if(step.email) {
|
||||
emailService.send( processEmailParams(step.email, this.context) )
|
||||
|
||||
@@ -20,11 +20,11 @@
|
||||
-->
|
||||
Hello everyone,
|
||||
|
||||
... based on our "How to Release Apache Fineract" process documented at https://cwiki.apache.org/confluence/x/DRwIB:
|
||||
... based on our "How to Release Apache Fineract" process (https://cwiki.apache.org/confluence/x/DRwIB) as well as the "Releases" chapter in the docs (https://fineract.apache.org/docs/current/#_releases),
|
||||
|
||||
I will create a ${project['fineract.release.version']} branch off develop in our git repository at https://github.com/apache/fineract on ${project['fineract.release.date']}.
|
||||
I will create a ${project['fineract.release.version']} branch off develop in our git repository at https://github.com/apache/fineract on ${project['fineract.releaseBranch.date']}.
|
||||
|
||||
The release tracking umbrella issue for tracking all activity in JIRA is FINERACT-${project['fineract.release.issue']!'0000'} (https://issues.apache.org/jira/browse/FINERACT-${project['fineract.release.issue']!'0000'}) for this Fineract ${project['fineract.release.version']}.
|
||||
The release tracking umbrella issue for tracking all activity in JIRA is FINERACT-${project['fineract.release.issue']!'0000'} (https://issues.apache.org/jira/browse/FINERACT-${project['fineract.release.issue']!'0000'}).
|
||||
|
||||
If you have any work in progress that you would like to see included in this release, please add "blocking" links to the release JIRA issue.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user