Skip to content

Commit

Permalink
updated.
Browse files Browse the repository at this point in the history
  • Loading branch information
Luigi R. Viggiano committed Feb 12, 2019
1 parent 9bdaf99 commit e8baa20
Showing 1 changed file with 8 additions and 15 deletions.
23 changes: 8 additions & 15 deletions RELEASING.md
Expand Up @@ -18,19 +18,12 @@ Some links first:
[OSSRH Guide]: http://central.sonatype.org/pages/ossrh-guide.html
[Apache Maven]: http://central.sonatype.org/pages/apache-maven.html


SIGNING JARS
------------

In order to sign artifact jars, you need GnuPG.

So, from OS X:

```bash
$ sudo port selfupdate
$ sudo port -p upgrade outdated
$ sudo port install gnupg2
```
You can download GnuPG from [here](https://gnupg.org/download/) or try MacPorts; I've had issues with brew version of GnuPG on OS X so my recommendation is to download the most updated binaries built for OS X; that at the time of writing is from sourceforge project [gpgosx](https://sourceforge.net/p/gpgosx/docu/Download/).

RELEASE PROCEDURE
-----------------
Expand All @@ -39,13 +32,12 @@ This will upload release artifacts to Sonatype.

First you need to make sure all tests are passing and packages can be created without errors.


```bash
# Check that everything builds smoothly and tests are all passing
$ mvn clean install
$ mvn clean install

# First you need to remove the `-SNAPSHOT` thing and commit on git
$ mvn versions:set -DnewVersion=1.0.10
$ mvn versions:set -DnewVersion=1.0.10
$ mvn versions:commit
$ git commit -am "prepare release owner 1.0.10"
$ git tag owner-1.0.10
Expand All @@ -67,23 +59,24 @@ Maybe I should script this, not urgent anyway since releasing is not a daily rou

SITE DEPLOY
-----------

The site is generated by [Jekyll](https://jekyllrb.com).

The Jekyll site has an ant file providing help target:

```bash
$ cd owner-site
$ ant
$ ant
Buildfile: [...]/owner/owner-site/build.xml

help:
[echo]
[echo]
[echo] ant clean - cleans up the target dir
[echo] ant build - generates the website in the _site dir
[echo] ant publish - publish site to gh-pages
[echo] ant run-drafts - run jekyll serve (with '-w --drafts' options)
[echo] ant run - run jekyll serve (with '-w' option)
[echo]
[echo]

BUILD SUCCESSFUL
Total time: 0 seconds
Expand All @@ -96,4 +89,4 @@ or not: the `run` shows an actual preview of what's going to be shown on the web
additionally the drafts stored in the `_drafts` folder.

The `publish` target publishes the website on GitHub Pages, on the `gh-pages` branch of the project, and makes actually
updates the online website. It does so by using git command line tools which is required to be properly installed.
updates the online website. It does so by using git command line tools which is required to be properly installed.

0 comments on commit e8baa20

Please sign in to comment.