vavrtom commented on a change in pull request #36: QPID-8361: [Broker-J] Create a developer guide for Qpid Broker-J URL: https://github.com/apache/qpid-broker-j/pull/36#discussion_r326034435
########## File path: doc/developer-guide/src/main/markdown/release-instructions.md ########## @@ -0,0 +1,193 @@ +# Releasing Qpid Broker-J + +This document summarizes the steps of release process for Qpid Broker-J + +<!-- toc --> + +- [Pre-Requirements](#pre-requirements) + * [PGP](#pgp) + * [Maven](#maven) + * [Java](#java) + * [Git](#git) +- [Release Steps](#release-steps) + +<!-- tocstop --> + +## Pre-Requirements + +The release process is based on [Apache Release Policy](http://www.apache.org/dev/release.html), + [Release Signing](http://www.apache.org/dev/release-signing.html) and + [Publishing of Maven Documents](http://www.apache.org/dev/publishing-maven-artifacts.html#dev-env). + +### PGP + +Release artifacts needs to be signed. GNU Privacy Guard from [OpenPGP](https://www.openpgp.org) is used to sign on + Apache. Please, refer [Release Signing](http://www.apache.org/dev/release-signing.html) about PGP public key + cryptography. The document provides basic information about release signing and contains links to various resources + about PGP public key cryptography and how to use GNU Privacy Guard to generate and sign the PGP keys. Install + [GNU Privacy Guard](http://www.gnupg.org), generate keys following steps provided here and upload public keys to + keyservers . After publishing keys, login into <https://id.apache.org> and enter PGP key fingerprint(s), + then the corresponding keys will be made available under <https://people.apache.org/keys/> within a few hours. + Additionally, qpid project requires adding a public key into <https://dist.apache.org/repos/dist/release/qpid/KEYS>. + +### Maven + +Maven is used to build and manage Qpid Java project. 3.x version of maven needs to be installed and the development + environment should be setup as described at + [Publishing of Maven Artifacts](http://www.apache.org/dev/publishing-maven-artifacts.html#dev-env). + +Please, note that repository id (server id) in `setting.xml` should be **apache.releases.https**. Using different id Review comment: Maven settings file should be 'settings.xml' ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org With regards, Apache Git Services --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@qpid.apache.org For additional commands, e-mail: dev-h...@qpid.apache.org