Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Announce the availability of the new release.

Please remember to give a brief description of your component

To: announce@apache.org, dev@juneau.apache.org

[ANNOUNCEMENT] Apache Juneau 9.x.x Released

Hello all,

The Apache Juneau team is proud to announce the release of Juneau 9.x.x.

Apache Juneau is...

  • A toolkit for marshalling POJOs to a variety of content types using a common framework.
  • A REST server API for creating Swagger-based self-documenting REST interfaces using POJOs.
  • A REST client API for interacting with REST interfaces using POJOs.
  • A remote proxy API built on top of REST.
  • A sophisticated INI config file API.
  • A REST microservice API that combines all the features above for creating lightweight standalone REST interfaces that start up in milliseconds.

<A description of latest updates>

The release is available here (don't forget to verify the signatures):
xxx

Release notes can be found here:
xxx

We welcome your help and feedback. For more information on the project and how to get involved, visit the project website at
http://juneau.apache.org/

Send this mail from your @apache.org account.  Please spell check the document!

Wait to send the release announcement until you have verified that

  1. The release artifacts are available on the mirrors.
  2. The component website including the updated download page has been updated on the public site http://juneau.apache.org/proper/juneau.
  3. If the component publishes maven artifacts, these artifacts have been replicated to the central maven repo at repo.maven.apache.org
    (Clear your local repo of the release artifacts and either activate the clirr report with the updated version info or update a local project with a dependency to the new release version to get maven to try to download the release artifacts. Or just access repo using a web browser.)

8 - Updating Website

The website contents are located in GitHub:  https://github.com/apache/juneau-website

Checkout the contents of this repo to the same git folder of the juneau project (e.g. /juneau and /juneau-website should be in the same parent git folder).

Generate the Javadocs for the new version by doing the following:

  1. Make sure JUNEAU_VERSION is set to the new version in /juneau/juneau-env.sh.  (should already be done at this point)
  2. In the juneau-doc/docs folder, copy-and-replace all instance of "<juneauVersion>last-version</juneauVersion>" with "<juneauVersion>current-version</juneauVersion>" (e.g. "<juneauVersion>9.0.0</juneauVersion>" with "<juneauVersion>9.0.1</juneauVersion>").
  3. In the juneau-doc/docs folder, copy-and-replace all instance of "<juneauVersionNext>current-version</juneauVersionNext>" with "<juneauVersionNext>next-version</juneauVersionNext>" (e.g. "<juneauVersionNext>9.0.1</juneauVersionNext>" with "<juneauVersionNext>9.0.2</juneauVersionNext>".
  4. Run the following command in the /juneau folder to generate the Javadocs and add them to the website:  ./juneau-build-javadoc.sh
  5. Verify that a new folder is created at juneau-website/content/site/apidocs-x.x.x containing the newly-generated javadocs. 

Update the downloads page and regenerate templates.

  1. Update the juneau-website/templates/downloads.html to reflect the newest release.
    1. Change Current release section.
    2.  Add new entry to Older releases section.
  2. Update the settings in juneau-website.properties to reflect new versions.
  3. Run the juneau-website.sh script to regenerate the templated files.

After completion, commit and push the changes to the master branch.  The website should be updated immediately.