From 1d9154e8574e0a2b76f9a057b7638724b4477ba7 Mon Sep 17 00:00:00 2001
From: Oliver Bertuch <o.bertuch@fz-juelich.de>
Date: Fri, 18 Oct 2024 13:07:26 +0200
Subject: [PATCH] docs: add notes about dynamic project info #15

---
 README.md | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index d14663a..51ef83f 100644
--- a/README.md
+++ b/README.md
@@ -10,13 +10,18 @@ A common Maven Parent for all GDCC and IQSS Java projects:
 </parent>
 ```
 
+Aside from dependencies and plugin management, the Parent POM provides sane defaults for `<groupId>` and the extended project information bits `<url>`, `<organization>`, `<issueManagement>`, `<scm>`, `<ciManagement>` and `<distributionManagement>`.
+You can always completely override them in a child project.
+
 ## Important variables
 
-| Maven Property | Description                                         |
-|----------------|-----------------------------------------------------|
-| `jdk.version`  | The minimum Java version a project can be used with |
-| `skipUT`       | Skip executing unit tests with Surefire             |
-| `skipIT`       | Skip executing integration tests with Failsafe      |
+| Maven Property        | Description                                               |
+|-----------------------|-----------------------------------------------------------|
+| `jdk.version`         | The minimum Java version a project can be used with       |
+| `skipUT`              | Skip executing unit tests with Surefire                   |
+| `skipIT`              | Skip executing integration tests with Failsafe            |
+| `project.github.org`  | Default `gdcc`, influencing project info                  |
+| `project.github.repo` | Default `${project.artifactId}`, influencing project info |
 
 (There are more, docs to be done)