From 22c476260cd1adaa5020a3b2566151e601e74201 Mon Sep 17 00:00:00 2001 From: rschoene <rene.schoene@tu-dresden.de> Date: Wed, 15 Jan 2020 18:29:14 +0100 Subject: [PATCH] More details for publishing process. --- CONTRIBUTING.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1d6c4f3..4a60240 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -74,12 +74,14 @@ Currently, there is one test to test whether the output of RelAST is a valid inp To achieve this, there are two Gradle tasks. The first produces the usual `.ast` and `.jadd` files, whereas the second task takes the `.ast` as input. The test then ensures, that both output grammars are identical. -# Publishing +# Publishing (Maintainer only) -To publish a new version, the following needs to be done: +Currently, we are publishing to a private Nexus repository only. As a maintainer, to publish a new version, the following needs to be done: -1) Create a new annotated tag with an appropriate version number increase (major, minor, patch) described in [semantic versioning](https://semver.org/) -2) If not already present, create a new file `gradle.properties` with two entries `repoUser` and `repoPassword` for our Nexus repository. -3) Run `./gradlew publish -PwithNewVersion` (maybe also adding ` -PasSnapshot` to create a SNAPSHOT release) +1) Create a new annotated tag with an appropriate version number increase (major, minor, patch) described in [semantic versioning](https://semver.org/) and with "Version $MAJOR.$MINOR.$PATH" as message. +2) If not already present, create a new file `gradle.properties` with two entries `repoUser` and `repoPassword` for our Nexus repository credentials. +3) Decide, if the new version should only be a snapshot version (whose contents can be overridden within the same version) +4) Run `./gradlew publish -PwithNewVersion` (or `./gradlew publish -PwithNewVersion -PasSnapshot` to create a SNAPSHOT release) +5) (Optional) Update the dependencies in other projects using Relational RAGs. [create-issue]: https://git-st.inf.tu-dresden.de/jastadd/relational-rags/issues/new -- GitLab