Skip to content
This repository has been archived by the owner on Feb 11, 2022. It is now read-only.

Release v0.3.1 #22

Merged
merged 3 commits into from Feb 8, 2017
Merged

Release v0.3.1 #22

merged 3 commits into from Feb 8, 2017

Conversation

mr-archano
Copy link
Contributor

Scope of the PR

We want to release a new version of the plugin on Novoda Bintray maven repo, to ship the changes from #20.

Considerations and implementation

  • Updated README to be compliant with internal convention
  • Updated CHANGELOG to track changes in releases
  • Added a simple gradle script that helps the automation of the release, including:
    • Publishing of plugin artifact to Bintray
    • Creation and upload of groovydocs to github pages
    • Creation of tag

CHANGELOG.md Outdated
Version 0.3.1 *(08/02/2017)*
--------------------------

- Honour exclude filters in Findbugs tasks ([PR#20](https://github.com/novoda/gradle-static-analysis-plugin/pull/20))
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Honor for us english

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you can just type PR #20, like so: PR #20

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@takecare I wasn't sure it would work in this file too, I'll try

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah i think you're right, it won't work!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I checked, it doesn't work indeed (I might even had done the same check before 😅 )

CHANGELOG.md Outdated
@@ -1,6 +1,11 @@
Change Log
==========

Version 0.3.1 *(08/02/2017)*
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will merging this trigger a build and release? If not, the release should go before updating this imo

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is no automatic trigger at the moment, but ideally it would yes. Once this gets merged the task on the CI will execute publishRelease that in turn will scan the changelog file to fill the release and create the tag

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To be honest we could remove the date completely and add links to the GH release instead. What you think @ataulm?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah cool

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To be honest we could remove the date completely and add links to the GH release instead. What you think @ataulm?

I think safer since the date could be incorrect (if no one merges this til tomorrow, then the release doesn't actually happen til the day after).

With the link to releases, the link will be broken, but when the release is made, it will work (or link to releases page)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes plus one for link to release instead of date

apply plugin: 'org.ajoberstar.github-pages'

githubPages {
commitMessage = "Deploy groovydoc for release $tag"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

}
}

task prepareGhCredentials {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i'd stick to Github (clearer and consistent)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it was to align with the naming used by one of the gradle plugin we are using to use the git/github API

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 just mentioned it 'cause there's a githubPages just above

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah, that extension (and the incosistent naming) is coming from the aforementioned plugin 👼

@@ -20,3 +20,6 @@ local.properties

# Generated files
gen/

# Properties files
secrets.properties
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👀


String extractChangelog() {
String fullChangelog = rootProject.file('CHANGELOG.md').text
def latestChangelog = (fullChangelog =~ /Version ${project.version}.*\n-*([\s\S]*?)Version.*\n-*/)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Gotta thanks the god of regex 😄

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is there a format to follow? As in, a guide on how to adhere to the required format

Copy link
Contributor Author

@mr-archano mr-archano Feb 8, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@florianmski The struggle was real! But you probably remember ;)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ataulm yes, this is assuming the changelog is written always following a specific structure. The script here is a first draft, something I hacked together a while ago that I feel should not be just a stashed snippet. Soon a follow-up PR will enhance this script adding the missing piece of functionality (the creation of a release entry in GitHub) and the documentation on how to release (including the format of the changelog).

@florianmski florianmski merged commit 2f1c103 into master Feb 8, 2017
@florianmski florianmski deleted the release/prepare_v0.3.1 branch February 8, 2017 15:04
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants