This is an automated email from the ASF dual-hosted git repository.

vy pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/logging-log4j-tools.git

commit 7803847c794fd3956f392d152de6d619274c46f4
Author: Volkan Yazıcı <[email protected]>
AuthorDate: Thu Jun 22 16:51:33 2023 +0200

    Use `log4j-changelog` for release notes
---
 .github/pull_request_template.md                   |   4 +-
 .github/workflows/build.yml                        |  27 +-----
 CHANGELOG.adoc                                     |  44 ---------
 RELEASE-NOTES.md                                   |  22 +++++
 RELEASING.adoc                                     |  45 +++------
 log4j-changelog-maven-plugin/README.adoc           |   2 +-
 .../java/org/apache/logging/log4j/ExportMojo.java  |   2 +-
 pom.xml                                            | 105 +++++++++++++++++++--
 src/changelog/.0.x.x/.release-notes.md.ftl         |  23 +++++
 .../63_add_versionPattern_to_ReleaseMojo.xml       |  24 +++++
 .../.0.x.x/changed_ExportMojo_outputDirectory.xml  |  24 +++++
 src/changelog/.0.x.x/changelog_migration.xml       |  24 +++++
 src/changelog/.changelog.md.ftl                    |  26 +++++
 src/changelog/.index.md.ftl                        |  22 +++++
 src/changelog/0.1.0/.release-notes.md.ftl          |  22 +++++
 src/changelog/0.1.0/.release.xml                   |  22 +++++
 ...-3628_added_tools_bom_and_changelog_modules.xml |  25 +++++
 src/changelog/0.2.0/.release-notes.md.ftl          |  22 +++++
 src/changelog/0.2.0/.release.xml                   |  22 +++++
 src/changelog/0.2.0/13_added_changelog_xsd.xml     |  26 +++++
 .../0.2.0/14_removed_changelog_security_type.xml   |  26 +++++
 .../0.2.0/17_fixed_unreleased_directory_order.xml  |  25 +++++
 src/changelog/0.2.0/19_fixed_Windows_compat.xml    |  26 +++++
 .../0.2.0/20_added_changelog_maven_plugin.xml      |  26 +++++
 ...0_renamed_exporter_outputDirectory_property.xml |  26 +++++
 src/changelog/0.3.0/.release-notes.md.ftl          |  22 +++++
 src/changelog/0.3.0/.release.xml                   |  22 +++++
 .../0.3.0/37_added_changelogEntryCount.xml         |  26 +++++
 .../0.3.0/44_make_changelog_format_agnostic.xml    |  24 +++++
 src/changelog/0.3.0/java_17.xml                    |  26 +++++
 30 files changed, 670 insertions(+), 112 deletions(-)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index ba288bd..a2f5032 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -2,7 +2,7 @@
 
 ## Checklist
 
-* `./mvnw verify` succeeds (if it fails due to code formatting issues reported 
by Spotless, simply run `spotless:apply` and retry)
-* Changes contain an entry in the `CHANGELOG.adoc`
+* `./mvnw verify` succeeds (if it fails due to code formatting issues reported 
by Spotless, simply run `spotless:apply`, and retry)
+* Changelog entry file in `src/changelog/.0.x.x` folder
 * Tests for the changes are provided
 * [Commits are 
signed](https://docs.github.com/en/authentication/managing-commit-signature-verification/signing-commits)
 (optional, but highly recommended)
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 9c36a34..8d320d8 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -158,19 +158,8 @@ jobs:
             echo "git ref \"$GITHUB_REF\" mismatches with the version: 
\"$PROJECT_VERSION\"" 1>&2
             exit 1
           }
-          [[ "$PROJECT_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || {
-            echo "was expecting a release version, found: 
\"$PROJECT_VERSION\"" 1>&2
-            exit 1
-          }
-          export CHANGELOG_VERSION=$(grep "^== " CHANGELOG.adoc | head -n 1 | 
sed -r 's/^== (.+) \(.+\)$/\1/')
-          [[ "$PROJECT_VERSION" == "$CHANGELOG_VERSION" ]] || {
-            echo "version \"$PROJECT_VERSION\" doesn't match the one in 
changelog: \"$CHANGELOG_VERSION\"" 1>&2
-            exit 1
-          }
-          export CURRENT_DATE=$(date +%Y-%m-%d)
-          export CHANGELOG_DATE=$(grep "^== " CHANGELOG.adoc | head -n 1 | sed 
-r 's/^== .+ \((.+)\)$/\1/')
-          [[ "$CURRENT_DATE" == "$CHANGELOG_DATE" ]] || {
-            echo "current date \"$CURRENT_DATE\" doesn't match the one in the 
changelog: \"$CHANGELOG_DATE\"" 1>&2
+          [[ "$PROJECT_VERSION" =~ 
^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*(-[a-zA-Z][0-9a-zA-Z-]*)?)$ ]] || {
+            echo "invalid release version: \"$PROJECT_VERSION\"" 1>&2
             exit 1
           }
 
@@ -179,7 +168,7 @@ jobs:
           gpg --list-secret-keys
           ./mvnw \
             --show-version --batch-mode --errors --no-transfer-progress \
-            -P release
+            -P deploy
         env:
           # `NEXUS_USERNAME` and `NEXUS_PASSWORD` are used in 
`~/.m2/settings.xml` created by `setup-java` action
           NEXUS_USERNAME: ${{ github.ref == 'refs/heads/master' && 
secrets.NEXUS_USER || secrets.LOGGING_STAGE_DEPLOYER_USER }}
@@ -202,13 +191,3 @@ jobs:
           name: Sources
           path: /tmp/apache-log4j-tools-*-src.zip*
           if-no-files-found: error
-
-      - name: Tag version (RELEASE)
-        if: startsWith(github.ref, 'refs/heads/release/')
-        run: |
-          export RCN=$[ $(git tag -l "rel/$PROJECT_VERSION-rc*" | wc -l) + 1 ]
-          export TAG="rel/$PROJECT_VERSION-rc$RCN"
-          git config user.name github-actions
-          git config user.email [email protected]
-          git tag "$TAG" -m ""
-          git push origin "$TAG"
diff --git a/CHANGELOG.adoc b/CHANGELOG.adoc
deleted file mode 100644
index 2b038e7..0000000
--- a/CHANGELOG.adoc
+++ /dev/null
@@ -1,44 +0,0 @@
-////
-Licensed to the Apache Software Foundation (ASF) under one or more
-contributor license agreements. See the NOTICE file distributed with
-this work for additional information regarding copyright ownership.
-The ASF licenses this file to You under the Apache License, Version 2.0
-(the "License"); you may not use this file except in compliance with
-the License. You may obtain a copy of the License at
-
-    https://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-////
-
-== Unreleased
-
-* Add `versionPattern` parameter to `release` Maven goal 
(https://github.com/apache/logging-log4j-tools/issues/63[#63])
-
-== 0.3.0 (2023-03-14)
-
-* Upgrade the compiler version to Java 17, yet still target Java 8
-
-* Support multiple and formatting-agnostic template files 
(https://github.com/apache/logging-log4j-tools/issues/44[#44])
-
-* The changelog release models passed to the index template file 
(`.index.adoc.ftl`) is enriched with `changelogEntryCount` fields 
(https://github.com/apache/logging-log4j-tools/issues/37[#37])
-
-== 0.2.0 (2023-01-31)
-
-* Fixed Windows compatibility 
(https://github.com/apache/logging-log4j-tools/issues/19[#19])
-
-* Fixed unreleased directory order in `ChangelogExporter` 
(https://github.com/apache/logging-log4j-tools/issues/17[#17])
-
-* Removed `security` as a change type from `log4j-changelog` 
(https://github.com/apache/logging-log4j-tools/issues/14[#14])
-
-* Added XSD for `log4j-changelog` XML files 
(https://github.com/apache/logging-log4j-tools/issues/13[#13])
-
-* Added `log4j-changelog-maven-plugin` module and renamed 
`log4j.changelog.exporter.outputDirectory` property to 
`log4j.changelog.outputDirectory` 
(https://github.com/apache/logging-log4j-tools/issues/20[#20])
-
-== 0.1.0 (2023-01-10)
-
-* Added `log4j-tools-bom` and `log4j-changelog` modules 
(https://issues.apache.org/jira/browse/LOG4J2-3628[LOG4J2-3628])
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
new file mode 100644
index 0000000..61a3df6
--- /dev/null
+++ b/RELEASE-NOTES.md
@@ -0,0 +1,22 @@
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+This project uses itself, i.e., `log4j-changelog-maven-plugin`, for keeping a 
changelog and generating release notes.
+
+Changelog files are located under [`src/changelog`](src/changelog).
+Release notes can be generated using `./mvnw -N log4j-changelog:export` 
command.
+See [`log4j-changelog-maven-plugin`](log4j-changelog-maven-plugin) for details 
on how it all works.
diff --git a/RELEASING.adoc b/RELEASING.adoc
index 77469ac..e30cf09 100644
--- a/RELEASING.adoc
+++ b/RELEASING.adoc
@@ -27,19 +27,15 @@ In the code examples below, assuming the version to be 
released is `7.8.0`.
 . Checkout the release branch: `git checkout -B release/7.8.0 origin/master`
 . Perform and commit following changes:
 .. Set the `revision` property to `7.8.0` in xref:pom.xml[`pom.xml`]
-.. Update the version and date in xref:CHANGELOG.adoc[`CHANGELOG.adoc`]
-. Make sure that `./mvnw clean verify` succeeds – if not, commit necessary 
fixes
-. Push the `release/7.8.0` branch
+.. For release notes
+... Run `./mvnw -N changelog-release` and verify `src/changelog` content 
(e.g., `.release-notes.md.ftl`)
+... Run `./mvnw -N changelog-export` and verify 
`target/generated-sources/site/changelog` content
+... Replace `RELEASE-NOTES.md` with 
`target/generated-sources/site/changelog/7.8.0.md`
+. Make sure that `./mvnw clean verify` succeeds – if not, implement necessary 
fixes
+. Commit and push the `release/7.8.0` branch
 . Make sure the associated 
https://github.com/apache/logging-log4j-tools/actions[GitHub Actions workflow] 
succeeds:
 .. *Signed artifacts* are uploaded to the _Staging Repositories_ in 
https://repository.apache.org/[repository.apache.org]
 .. *Signed sources and their checksum* are uploaded as GitHub Actions workflow 
artifacts
-.. `*rel/7.8.0-rc1*` git tag should be created
-+
-[IMPORTANT]
-====
-The ASF infrastructure treats ``rel/``-prefixed git tags special and ensures 
they are immutable for provenance reasons.
-To make the above operation idempotent and allow retries, the release 
candidate enumeration used in the tag will be incremented automatically; 
`rel/7.8.0-rc1`, `rel/7.8.0-rc2`, etc.
-====
 
 +
 If not, commit necessary fixes, push, and repeat.
@@ -50,27 +46,25 @@ If not, commit necessary fixes, push, and repeat.
 
 Collect release votes via email using the following template:
 
-.`[VOTE] Release Apache Log4j Tools 7.8.0` titled email to 
`[email protected]`
+.`[VOTE][LAZY] Release Apache Log4j Tools 7.8.0` titled email to 
`[email protected]`
 [source]
 ----
-The Apache Log4j Tools 7.8.0 release is now available for voting.
+This is a lazy vote to release the Apache Log4j Tools 7.8.0.
 
 This release contains minor enhancements and bug fixes.
 
 Source repository: https://github.com/apache/logging-log4j-tools
-Tag: rel/7.8.0-rc1
 Commit: e82a44142280d013bd76ea18951fde00dcee192b
-CI run: https://github.com/apache/logging-log4j-tools/actions/runs/3882476949
-Artifacts: https://dist.apache.org/repos/dist/dev/logging/log4j/
-Nexus repository: 
https://repository.apache.org/content/repositories/orgapachelogging-1096
-Signing key: 
https://keyserver.ubuntu.com/pks/lookup?search=077e8893a6dcc33dd4a4d5b256e73ba9a0b592d0&fingerprint=on&op=index
+Artifacts: https://dist.apache.org/repos/dist/dev/logging/log4j
+Signing key: 0x077e8893a6dcc33dd4a4d5b256e73ba9a0b592d0
 
 Please download, test, and cast your votes on the Log4j developers list.
 
 [ ] +1, release the artifacts
 [ ] -1, don't release, because...
 
-The vote will remain open for 24 hours (or more if required). All votes are 
welcome and we encourage everyone to test the release, but only the Logging 
Services PMC votes are officially counted. At least 3 +1 votes and more 
positive than negative votes are required.
+This vote is open for 72 hours and will pass unless getting a net negative 
vote count.
+All votes are welcome and we encourage everyone to test the release, but only 
the Logging Services PMC votes are officially counted.
 ----
 
 [WARNING]
@@ -90,7 +84,7 @@ With that, the release passes with 3 binding +1 votes from 
me, Piotr, and Matt.
 
 == Publish the release
 
-=== In git repository
+=== In the git repository
 
 . Pull the most recent changes and tags
 . Tag the release (e.g., `rel/7.8.0`) and push it
@@ -99,7 +93,7 @@ With that, the release passes with 3 binding +1 votes from 
me, Piotr, and Matt.
 ====
 The ASF infrastructure treats ``rel/``-prefixed git tags special and ensures 
they are immutable for provenance reasons.
 ====
-. Rebase `release/7.8.0` changes to `master`
+. If you have committed any fixes to `release/7.8.0`, `cherry-pick` them onto 
`master`
 . Set the revision property to the next development version (e.g., 
`7.9.0-SNAPSHOT`) in xref:pom.xml[`pom.xml`]
 . Commit changes and push the `master` branch
 . Delete the local and remote copies of the `release/7.8.0` branch
@@ -118,13 +112,4 @@ The ASF infrastructure treats ``rel/``-prefixed git tags 
special and ensures the
 Once the artifacts are visible in 
https://central.sonatype.dev/[central.sonatype.dev], 
https://github.com/apache/logging-log4j-tools/releases/new[create a new release 
in GitHub]
 
 . Use the `rel/7.8.0` tag
-. Copy necessary changes from xref:CHANGELOG.adoc[`CHANGELOG.adoc`]
-.. formatting needs to be converted from AsciiDoc to 
https://github.github.com/gfm/[GitHub Flavored Markdown]
-.. GitHub Issue links need to be converted from
-+
-[source]
-----
-https://github.com/apache/logging-log4j-tools/issues/19[#19]
-----
-+
-AsciiDoc-formatted links to simply `#19`
+. Copy release notes from the generated 
`target/generated-sources/site/changelog/7.8.0.md`
diff --git a/log4j-changelog-maven-plugin/README.adoc 
b/log4j-changelog-maven-plugin/README.adoc
index 1494866..249b062 100644
--- a/log4j-changelog-maven-plugin/README.adoc
+++ b/log4j-changelog-maven-plugin/README.adoc
@@ -77,7 +77,7 @@ It defaults to `${project.basedir}/src/changelog` and can be 
set using the `log4
 
 `outputDirectory` (parameter)::
 Directory to write rendered templates.
-It defaults to 
`${project.build.directory}/generated-sources/site/asciidoc/changelog` and can 
be set using the `log4j.changelog.exporter.outputDirectory` property.
+It defaults to `${project.build.directory}/generated-sources/site/changelog` 
and can be set using the `log4j.changelog.exporter.outputDirectory` property.
 
 `indexTemplates` (parameter)::
 List of xref:#export-template-type[template]s that will be rendered with 
release information of all releases.
diff --git 
a/log4j-changelog-maven-plugin/src/main/java/org/apache/logging/log4j/ExportMojo.java
 
b/log4j-changelog-maven-plugin/src/main/java/org/apache/logging/log4j/ExportMojo.java
index 82b164a..96cb074 100644
--- 
a/log4j-changelog-maven-plugin/src/main/java/org/apache/logging/log4j/ExportMojo.java
+++ 
b/log4j-changelog-maven-plugin/src/main/java/org/apache/logging/log4j/ExportMojo.java
@@ -67,7 +67,7 @@ public final class ExportMojo extends AbstractMojo {
      * Directory to write rendered templates.
      */
     @Parameter(
-            defaultValue = 
"${project.build.directory}/generated-sources/site/asciidoc/changelog",
+            defaultValue = 
"${project.build.directory}/generated-sources/site/changelog",
             property = "log4j.changelog.outputDirectory",
             required = true)
     private File outputDirectory;
diff --git a/pom.xml b/pom.xml
index 9018dad..81e00b8 100644
--- a/pom.xml
+++ b/pom.xml
@@ -59,6 +59,16 @@
 
   <developers>
 
+    <developer>
+      <id>pkarwasz</id>
+      <name>Piotr P. Karwasz</name>
+      <email>[email protected]</email>
+      <roles>
+        <role>PMC Member</role>
+      </roles>
+      <timezone>Europe/Warsaw</timezone>
+    </developer>
+
     <developer>
       <id>rgoers</id>
       <name>Ralph Goers</name>
@@ -80,16 +90,6 @@
       <timezone>Europe/Amsterdam</timezone>
     </developer>
 
-    <developer>
-      <id>pkarwasz</id>
-      <name>Piotr P. Karwasz</name>
-      <email>[email protected]</email>
-      <roles>
-        <role>PMC Member</role>
-      </roles>
-      <timezone>Europe/Warsaw</timezone>
-    </developer>
-
   </developers>
 
   <modules>
@@ -143,9 +143,11 @@
     <error-prone.version>2.19.1</error-prone.version>
     <findsecbugs-plugin.version>1.12.0</findsecbugs-plugin.version>
     <flatten-maven-plugin.version>1.5.0</flatten-maven-plugin.version>
+    
<log4j-changelog-maven-plugin.version>0.3.0</log4j-changelog-maven-plugin.version>
     <maven-deploy-plugin.version>3.0.0</maven-deploy-plugin.version>
     <sign-maven-plugin.version>1.0.1</sign-maven-plugin.version>
     <spotbugs-maven-plugin.version>4.7.3.4</spotbugs-maven-plugin.version>
+    <xml-maven-plugin.version>1.0.2</xml-maven-plugin.version>
 
   </properties>
 
@@ -330,11 +332,93 @@
         </executions>
       </plugin>
 
+      <plugin>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>xml-maven-plugin</artifactId>
+        <version>${xml-maven-plugin.version}</version>
+        <inherited>false</inherited>
+        <executions>
+          <execution>
+            <goals>
+              <goal>validate</goal>
+            </goals>
+            <configuration>
+              <validationSets>
+                <validationSet>
+                  <dir>src/changelog</dir>
+                  <includes>**/*.xml</includes>
+                  
<publicId>http://logging.apache.org/log4j/changelog</publicId>
+                  
<systemId>https://logging.apache.org/log4j/changelog-0.1.1.xsd</systemId>
+                  <validating>true</validating>
+                </validationSet>
+              </validationSets>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+
     </plugins>
 
   </build>
 
   <profiles>
+
+    <!-- `changelog-export` profile to export changelogs.
+         It is manually enabled by users to generate release notes.
+         See `RELEASING.adoc` for instructions. -->
+    <profile>
+      <id>changelog-export</id>
+      <build>
+        <defaultGoal>log4j-changelog:export</defaultGoal>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.logging.log4j</groupId>
+            <artifactId>log4j-changelog-maven-plugin</artifactId>
+            <version>${log4j-changelog-maven-plugin.version}</version>
+            <inherited>false</inherited>
+            <configuration>
+              <!-- `outputDirectory` was broken in 0.3.0, below line can be 
removed in 0.4.0 onwards: -->
+              
<outputDirectory>${project.build.directory}/generated-sources/site/release-notes</outputDirectory>
+              <indexTemplates>
+                <template>
+                  <source>.index.md.ftl</source>
+                </template>
+              </indexTemplates>
+              <changelogTemplates>
+                <template>
+                  <source>.release-notes.md.ftl</source>
+                  <target>%v.md</target>
+                </template>
+              </changelogTemplates>
+            </configuration>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+
+    <!-- `changelog-release` profile to move `src/changelog/.0.x.x` contents 
to their associated release directory.
+         It is manually enabled by users to while cutting a release.
+         See `RELEASING.adoc` for instructions. -->
+    <profile>
+      <id>changelog-release</id>
+      <build>
+        <defaultGoal>log4j-changelog:release</defaultGoal>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.logging.log4j</groupId>
+            <artifactId>log4j-changelog-maven-plugin</artifactId>
+            <version>${log4j-changelog-maven-plugin.version}</version>
+            <inherited>false</inherited>
+            <configuration>
+              <releaseVersion>${revision}</releaseVersion>
+            </configuration>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+
+    <!-- `release` profile activating release-specific configuration.
+         It is manually enabled by `.github/workflows/build.yml` while 
releasing. -->
     <profile>
 
       <id>release</id>
@@ -384,6 +468,7 @@
       </build>
 
     </profile>
+
   </profiles>
 
 </project>
diff --git a/src/changelog/.0.x.x/.release-notes.md.ftl 
b/src/changelog/.0.x.x/.release-notes.md.ftl
new file mode 100644
index 0000000..70b164d
--- /dev/null
+++ b/src/changelog/.0.x.x/.release-notes.md.ftl
@@ -0,0 +1,23 @@
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+# ${release.version}<#if release.date?has_content> (${release.date})</#if>
+
+This minor release contains small enhancements.
+Most importantly, this marks the first release where the project uses itself 
to generate release notes!
+
+<#include "../.changelog.md.ftl">
diff --git a/src/changelog/.0.x.x/63_add_versionPattern_to_ReleaseMojo.xml 
b/src/changelog/.0.x.x/63_add_versionPattern_to_ReleaseMojo.xml
new file mode 100644
index 0000000..e17c170
--- /dev/null
+++ b/src/changelog/.0.x.x/63_add_versionPattern_to_ReleaseMojo.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="added">
+  <author id="vy"/>
+  <description format="markdown">Upgrade the compiler version to Java 17, yet 
still target Java 8</description>
+</entry>
diff --git a/src/changelog/.0.x.x/changed_ExportMojo_outputDirectory.xml 
b/src/changelog/.0.x.x/changed_ExportMojo_outputDirectory.xml
new file mode 100644
index 0000000..8cfb5f9
--- /dev/null
+++ b/src/changelog/.0.x.x/changed_ExportMojo_outputDirectory.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="changed">
+  <author id="vy"/>
+  <description format="markdown">Changed the default value of 
`outputDirectory` to 
`${project.build.directory}/generated-sources/site/changelog` for the 
`ExportMojo`</description>
+</entry>
diff --git a/src/changelog/.0.x.x/changelog_migration.xml 
b/src/changelog/.0.x.x/changelog_migration.xml
new file mode 100644
index 0000000..4e3401c
--- /dev/null
+++ b/src/changelog/.0.x.x/changelog_migration.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="changed">
+  <author id="vy"/>
+  <description format="markdown">Migrated from `CHANGELOG.adoc` to using 
`log4j-changelog-maven-plugin`</description>
+</entry>
diff --git a/src/changelog/.changelog.md.ftl b/src/changelog/.changelog.md.ftl
new file mode 100644
index 0000000..29c6fef
--- /dev/null
+++ b/src/changelog/.changelog.md.ftl
@@ -0,0 +1,26 @@
+<#--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<#if entriesByType?size gt 0>## Changes
+<#list entriesByType as entryType, entries>
+
+### ${entryType?capitalize}
+
+<#list entries as entry>
+* ${entry.description.text?replace("\\s+", " ", "r")}<#if 
entry.issues?has_content> (<#list entry.issues as issue><#if 
issue.link?starts_with("https://github.com";)>#${issue.id}<#else>[${issue.id}](${issue.link})</#if><#if
 issue?has_next>, </#if></#list>)</#if>
+</#list>
+</#list>
+</#if>
diff --git a/src/changelog/.index.md.ftl b/src/changelog/.index.md.ftl
new file mode 100644
index 0000000..26e037e
--- /dev/null
+++ b/src/changelog/.index.md.ftl
@@ -0,0 +1,22 @@
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+# Release Notes
+
+<#list releases as release>
+* [${release.version}](${release.version}.md)<#if release.date?has_content> 
(${release.date})</#if>
+</#list>
diff --git a/src/changelog/0.1.0/.release-notes.md.ftl 
b/src/changelog/0.1.0/.release-notes.md.ftl
new file mode 100644
index 0000000..1ccc01c
--- /dev/null
+++ b/src/changelog/0.1.0/.release-notes.md.ftl
@@ -0,0 +1,22 @@
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+# ${release.version}<#if release.date?has_content> (${release.date})</#if>
+
+This is the first release, aimed to assist [the Apache Log4j 
2](http://logging.apache.org/log4j/2.x/) on generating release notes.
+
+<#include "../.changelog.md.ftl">
diff --git a/src/changelog/0.1.0/.release.xml b/src/changelog/0.1.0/.release.xml
new file mode 100644
index 0000000..d11a434
--- /dev/null
+++ b/src/changelog/0.1.0/.release.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<release xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+         xmlns="http://logging.apache.org/log4j/changelog";
+         xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+         date="2023-01-10"
+         version="0.1.0"/>
diff --git 
a/src/changelog/0.1.0/LOG4J2-3628_added_tools_bom_and_changelog_modules.xml 
b/src/changelog/0.1.0/LOG4J2-3628_added_tools_bom_and_changelog_modules.xml
new file mode 100644
index 0000000..26f6a53
--- /dev/null
+++ b/src/changelog/0.1.0/LOG4J2-3628_added_tools_bom_and_changelog_modules.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="added">
+  <issue id="LOG4J2-3628" 
link="https://issues.apache.org/jira/browse/LOG4J2-3628"/>
+  <author id="vy"/>
+  <description format="markdown">Added `log4j-tools-bom` and `log4j-changelog` 
modules</description>
+</entry>
diff --git a/src/changelog/0.2.0/.release-notes.md.ftl 
b/src/changelog/0.2.0/.release-notes.md.ftl
new file mode 100644
index 0000000..2f5dd8e
--- /dev/null
+++ b/src/changelog/0.2.0/.release-notes.md.ftl
@@ -0,0 +1,22 @@
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+# ${release.version}<#if release.date?has_content> (${release.date})</#if>
+
+This minor release contains various bug fixes and improvements.
+
+<#include "../.changelog.md.ftl">
diff --git a/src/changelog/0.2.0/.release.xml b/src/changelog/0.2.0/.release.xml
new file mode 100644
index 0000000..327d442
--- /dev/null
+++ b/src/changelog/0.2.0/.release.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<release xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+         xmlns="http://logging.apache.org/log4j/changelog";
+         xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+         date="2023-01-31"
+         version="0.2.0"/>
diff --git a/src/changelog/0.2.0/13_added_changelog_xsd.xml 
b/src/changelog/0.2.0/13_added_changelog_xsd.xml
new file mode 100644
index 0000000..81c3fd4
--- /dev/null
+++ b/src/changelog/0.2.0/13_added_changelog_xsd.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="added">
+  <issue id="13" 
link="https://github.com/apache/logging-log4j-tools/issues/13"/>
+  <author id="pkarwasz"/>
+  <author id="vy"/>
+  <description format="markdown">Added XSD for `log4j-changelog` XML 
files</description>
+</entry>
diff --git a/src/changelog/0.2.0/14_removed_changelog_security_type.xml 
b/src/changelog/0.2.0/14_removed_changelog_security_type.xml
new file mode 100644
index 0000000..b4ba1a8
--- /dev/null
+++ b/src/changelog/0.2.0/14_removed_changelog_security_type.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="removed">
+  <issue id="14" 
link="https://github.com/apache/logging-log4j-tools/issues/14"/>
+  <author id="rgoers"/>
+  <author id="vy"/>
+  <description format="markdown">Removed `security` as a change type from 
`log4j-changelog`</description>
+</entry>
diff --git a/src/changelog/0.2.0/17_fixed_unreleased_directory_order.xml 
b/src/changelog/0.2.0/17_fixed_unreleased_directory_order.xml
new file mode 100644
index 0000000..07d0437
--- /dev/null
+++ b/src/changelog/0.2.0/17_fixed_unreleased_directory_order.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="fixed">
+  <issue id="17" 
link="https://github.com/apache/logging-log4j-tools/issues/17"/>
+  <author id="vy"/>
+  <description format="markdown">Fixed unreleased directory order in 
`ChangelogExporter`</description>
+</entry>
diff --git a/src/changelog/0.2.0/19_fixed_Windows_compat.xml 
b/src/changelog/0.2.0/19_fixed_Windows_compat.xml
new file mode 100644
index 0000000..f9fa98c
--- /dev/null
+++ b/src/changelog/0.2.0/19_fixed_Windows_compat.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="fixed">
+  <issue id="19" 
link="https://github.com/apache/logging-log4j-tools/issues/19"/>
+  <author id="pkarwasz"/>
+  <author id="vy"/>
+  <description format="markdown">Fixed Windows compatibility</description>
+</entry>
diff --git a/src/changelog/0.2.0/20_added_changelog_maven_plugin.xml 
b/src/changelog/0.2.0/20_added_changelog_maven_plugin.xml
new file mode 100644
index 0000000..a2d63bc
--- /dev/null
+++ b/src/changelog/0.2.0/20_added_changelog_maven_plugin.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="added">
+  <issue id="20" 
link="https://github.com/apache/logging-log4j-tools/issues/20"/>
+  <author id="vy"/>
+  <author id="rgoers"/>
+  <description format="markdown">Added `log4j-changelog-maven-plugin` 
module</description>
+</entry>
diff --git 
a/src/changelog/0.2.0/20_renamed_exporter_outputDirectory_property.xml 
b/src/changelog/0.2.0/20_renamed_exporter_outputDirectory_property.xml
new file mode 100644
index 0000000..0ac83d0
--- /dev/null
+++ b/src/changelog/0.2.0/20_renamed_exporter_outputDirectory_property.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="changed">
+  <issue id="20" 
link="https://github.com/apache/logging-log4j-tools/issues/20"/>
+  <author id="vy"/>
+  <author id="rgoers"/>
+  <description format="markdown">Renamed 
`log4j.changelog.exporter.outputDirectory` property to 
`log4j.changelog.outputDirectory`</description>
+</entry>
diff --git a/src/changelog/0.3.0/.release-notes.md.ftl 
b/src/changelog/0.3.0/.release-notes.md.ftl
new file mode 100644
index 0000000..2f5dd8e
--- /dev/null
+++ b/src/changelog/0.3.0/.release-notes.md.ftl
@@ -0,0 +1,22 @@
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+# ${release.version}<#if release.date?has_content> (${release.date})</#if>
+
+This minor release contains various bug fixes and improvements.
+
+<#include "../.changelog.md.ftl">
diff --git a/src/changelog/0.3.0/.release.xml b/src/changelog/0.3.0/.release.xml
new file mode 100644
index 0000000..c33354f
--- /dev/null
+++ b/src/changelog/0.3.0/.release.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<release xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+         xmlns="http://logging.apache.org/log4j/changelog";
+         xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+         date="2023-03-14"
+         version="0.3.0"/>
diff --git a/src/changelog/0.3.0/37_added_changelogEntryCount.xml 
b/src/changelog/0.3.0/37_added_changelogEntryCount.xml
new file mode 100644
index 0000000..41b1c00
--- /dev/null
+++ b/src/changelog/0.3.0/37_added_changelogEntryCount.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="added">
+  <issue id="63" 
link="https://github.com/apache/logging-log4j-tools/issues/63"/>
+  <author id="vy"/>
+  <author id="rgoers"/>
+  <description format="markdown">Add `versionPattern` parameter to `release` 
Maven goal</description>
+</entry>
diff --git a/src/changelog/0.3.0/44_make_changelog_format_agnostic.xml 
b/src/changelog/0.3.0/44_make_changelog_format_agnostic.xml
new file mode 100644
index 0000000..e17c170
--- /dev/null
+++ b/src/changelog/0.3.0/44_make_changelog_format_agnostic.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="added">
+  <author id="vy"/>
+  <description format="markdown">Upgrade the compiler version to Java 17, yet 
still target Java 8</description>
+</entry>
diff --git a/src/changelog/0.3.0/java_17.xml b/src/changelog/0.3.0/java_17.xml
new file mode 100644
index 0000000..0ac83d0
--- /dev/null
+++ b/src/changelog/0.3.0/java_17.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+       xmlns="http://logging.apache.org/log4j/changelog";
+       xsi:schemaLocation="http://logging.apache.org/log4j/changelog 
https://logging.apache.org/log4j/changelog-0.1.1.xsd";
+       type="changed">
+  <issue id="20" 
link="https://github.com/apache/logging-log4j-tools/issues/20"/>
+  <author id="vy"/>
+  <author id="rgoers"/>
+  <description format="markdown">Renamed 
`log4j.changelog.exporter.outputDirectory` property to 
`log4j.changelog.outputDirectory`</description>
+</entry>

Reply via email to