apache · ppkarwasz · Jul 31, 2026 · Jul 30, 2026 · Jul 30, 2026
diff --git a/pom.xml b/pom.xml
@@ -101,9 +101,6 @@
     <!-- Dummy value; overwritten by CI at release time. Do not edit manually. -->
     <project.build.outputTimestamp>2026-01-01T00:00:00Z</project.build.outputTimestamp>
 
-    <!-- Flume does not use `log4j-changelog` to generate release notes (there is no `src/changelog` directory). -->
-    <log4j.changelog.skip>true</log4j.changelog.skip>
-
     <!-- The website is generated by Antora from the root module: skip the per-module `maven-site-plugin` sites. -->
     <maven.site.skip>true</maven.site.skip>
 

diff --git a/...ra/modules/ROOT/pages/releases/index.adoc → src/changelog/.2.x.x/.release-notes.adoc.ftl b/...ra/modules/ROOT/pages/releases/index.adoc → src/changelog/.2.x.x/.release-notes.adoc.ftl
@@ -6,7 +6,7 @@
     (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
+         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,
@@ -15,28 +15,11 @@
     limitations under the License.
 ////
 
-= Releases
+${"[#release-notes-" + release.version?replace("[^a-zA-Z0-9]", "-", "r") + "]"}
+== ${release.version}
 
-*Current Release*
+<#if release.date?has_content>Release date:: ${release.date}</#if>
 
-The current stable release is xref:releases/1.11.0.adoc[Apache Flume Version 1.11.0].
+This release...
 
-1.11.0
-
-*Previous Releases*
-
-1.10.1
-1.10.0
-1.9.0
-1.8.0
-1.7.0
-1.6.0
-1.5.2
-1.5.0.1
-1.5.0
-1.4.0
-1.3.1
-1.3.0
-1.2.0
-1.1.0
-1.0.0
+<#include "../.changelog.adoc.ftl">
diff --git a/src/changelog/.2.x.x/add_bill_of_materials.xml b/src/changelog/.2.x.x/add_bill_of_materials.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="added">
+  <issue id="FLUME-3456" link="https://issues.apache.org/jira/browse/FLUME-3456"/>
+  <description format="asciidoc">Add a Bill of Materials (`flume-bom`) that manages the versions of all published Flume artifacts</description>
+</entry>
diff --git a/src/changelog/.2.x.x/add_prometheus_monitoring.xml b/src/changelog/.2.x.x/add_prometheus_monitoring.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="added">
+  <issue id="358" link="https://github.com/apache/logging-flume/pull/358"/>
+  <description format="asciidoc">Add `PrometheusHTTPMetricsServer`, which exposes Flume metrics to Prometheus</description>
+</entry>
diff --git a/src/changelog/.2.x.x/add_routable_proxy_channel_selector.xml b/src/changelog/.2.x.x/add_routable_proxy_channel_selector.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="added">
+  <issue id="460" link="https://github.com/apache/logging-flume/pull/460"/>
+  <description format="asciidoc">Add `RoutableProxyChannelSelector`, which routes events to a channel selected by an event header</description>
+</entry>
diff --git a/src/changelog/.2.x.x/fix_http_source_error_responses.xml b/src/changelog/.2.x.x/fix_http_source_error_responses.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="fixed">
+  <issue id="442" link="https://github.com/apache/logging-flume/pull/442"/>
+  <description format="asciidoc">Stop leaking exception details in `HTTPSource` error responses</description>
+</entry>
diff --git a/src/changelog/.2.x.x/fix_property_resolution_order.xml b/src/changelog/.2.x.x/fix_property_resolution_order.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="fixed">
+  <issue id="437" link="https://github.com/apache/logging-flume/pull/437"/>
+  <description format="asciidoc">Fix order-dependent resolution of configuration properties that reference other properties</description>
+</entry>
diff --git a/src/changelog/.2.x.x/fix_rfc5424_timestamp_parsing.xml b/src/changelog/.2.x.x/fix_rfc5424_timestamp_parsing.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="fixed">
+  <issue id="441" link="https://github.com/apache/logging-flume/pull/441"/>
+  <description format="asciidoc">Fix RFC 5424 timestamp parsing edge cases in the syslog sources</description>
+</entry>
diff --git a/src/changelog/.2.x.x/migrate_to_log4j_api.xml b/src/changelog/.2.x.x/migrate_to_log4j_api.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="changed">
+  <issue id="459" link="https://github.com/apache/logging-flume/pull/459"/>
+  <description format="asciidoc">Migrate the logging API from SLF4J to the Log4j API</description>
+</entry>
diff --git a/src/changelog/.2.x.x/move_avro_and_thrift_components.xml b/src/changelog/.2.x.x/move_avro_and_thrift_components.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="removed">
+  <issue id="431" link="https://github.com/apache/logging-flume/pull/431"/>
+  <description format="asciidoc">Move the Avro and Thrift sources and sinks to their own repositories</description>
+</entry>
diff --git a/src/changelog/.2.x.x/move_http_and_irc_sinks.xml b/src/changelog/.2.x.x/move_http_and_irc_sinks.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="removed">
+  <issue id="430" link="https://github.com/apache/logging-flume/pull/430"/>
+  <description format="asciidoc">Move the HTTP sink and the IRC sink to the `logging-flume-http` and `logging-flume-irc` repositories</description>
+</entry>
diff --git a/src/changelog/.2.x.x/move_http_source_to_module.xml b/src/changelog/.2.x.x/move_http_source_to_module.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="changed">
+  <issue id="444" link="https://github.com/apache/logging-flume/pull/444"/>
+  <description format="asciidoc">Move `HTTPSource` from `flume-ng-core` to the new `flume-http-source` module, so core consumers no longer depend on the Jetty HTTP stack</description>
+</entry>
diff --git a/src/changelog/.2.x.x/move_jdbc_channel.xml b/src/changelog/.2.x.x/move_jdbc_channel.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="removed">
+  <issue id="FLUME-3458" link="https://issues.apache.org/jira/browse/FLUME-3458"/>
+  <description format="asciidoc">Move the JDBC channel to the `logging-flume-jdbc` repository</description>
+</entry>
diff --git a/src/changelog/.2.x.x/move_jms_and_scribe_sources.xml b/src/changelog/.2.x.x/move_jms_and_scribe_sources.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="removed">
+  <issue id="432" link="https://github.com/apache/logging-flume/pull/432"/>
+  <description format="asciidoc">Move the JMS source and the Scribe source to the `logging-flume-jms` and `logging-flume-scribe` repositories</description>
+</entry>
diff --git a/src/changelog/.2.x.x/move_kafka_components.xml b/src/changelog/.2.x.x/move_kafka_components.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="removed">
+  <issue id="FLUME-3457" link="https://issues.apache.org/jira/browse/FLUME-3457"/>
+  <description format="asciidoc">Move the Kafka source, channel and sink to the `logging-flume-kafka` repository</description>
+</entry>
diff --git a/src/changelog/.2.x.x/move_legacy_sources.xml b/src/changelog/.2.x.x/move_legacy_sources.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="removed">
+  <issue id="FLUME-3465" link="https://issues.apache.org/jira/browse/FLUME-3465"/>
+  <description format="asciidoc">Move the legacy Avro and Thrift sources to their own repository</description>
+</entry>
diff --git a/src/changelog/.2.x.x/move_monitoring_services.xml b/src/changelog/.2.x.x/move_monitoring_services.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="changed">
+  <issue id="445" link="https://github.com/apache/logging-flume/pull/445"/>
+  <description format="asciidoc">Move the monitoring services from `flume-ng-core` to dedicated modules under `flume-ng-instrumentation`</description>
+</entry>
diff --git a/src/changelog/.2.x.x/move_morphline_solr_sink.xml b/src/changelog/.2.x.x/move_morphline_solr_sink.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="removed">
+  <issue id="FLUME-3466" link="https://issues.apache.org/jira/browse/FLUME-3466"/>
+  <issue id="426" link="https://github.com/apache/logging-flume/pull/426"/>
+  <description format="asciidoc">Move the Morphline Solr sink to the `logging-flume-morphline-solr` repository</description>
+</entry>
diff --git a/src/changelog/.2.x.x/move_spring_boot_support.xml b/src/changelog/.2.x.x/move_spring_boot_support.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="removed">
+  <issue id="FLUME-3453" link="https://issues.apache.org/jira/browse/FLUME-3453"/>
+  <description format="asciidoc">Move the Spring Boot support to the `logging-flume-spring-boot` repository</description>
+</entry>
diff --git a/src/changelog/.2.x.x/move_twitter_source.xml b/src/changelog/.2.x.x/move_twitter_source.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="removed">
+  <issue id="FLUME-3455" link="https://issues.apache.org/jira/browse/FLUME-3455"/>
+  <description format="asciidoc">Move the Twitter source to its own repository</description>
+</entry>
diff --git a/src/changelog/.2.x.x/remove_hadoop_components.xml b/src/changelog/.2.x.x/remove_hadoop_components.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="removed">
+  <description format="asciidoc">Remove the components depending on the Hadoop ecosystem: the HDFS, Hive, HBase and Kudu sinks</description>
+</entry>
diff --git a/src/changelog/.2.x.x/remove_log4j1_appender.xml b/src/changelog/.2.x.x/remove_log4j1_appender.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="removed">
+  <issue id="434" link="https://github.com/apache/logging-flume/pull/434"/>
+  <description format="asciidoc">Remove the Log4j 1.x appender</description>
+</entry>
diff --git a/src/changelog/.2.x.x/replace_joda_time.xml b/src/changelog/.2.x.x/replace_joda_time.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="changed">
+  <issue id="431" link="https://github.com/apache/logging-flume/pull/431"/>
+  <description format="asciidoc">Replace Joda-Time with `java.time`</description>
+</entry>
diff --git a/src/changelog/.2.x.x/require_java_17.xml b/src/changelog/.2.x.x/require_java_17.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="changed">
+  <issue id="438" link="https://github.com/apache/logging-flume/pull/438"/>
+  <description format="asciidoc">Require Java 17 to build and run Flume</description>
+</entry>
diff --git a/src/changelog/.2.x.x/slim_down_core_dependencies.xml b/src/changelog/.2.x.x/slim_down_core_dependencies.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="changed">
+  <issue id="446" link="https://github.com/apache/logging-flume/pull/446"/>
+  <issue id="448" link="https://github.com/apache/logging-flume/pull/448"/>
+  <description format="asciidoc">
+    Remove Jetty, Mina and Netty from the dependencies of `flume-ng-core`.
+    The syslog and Netcat UDP sources now live in the dedicated `flume-syslog-source` and `flume-netcat-source` modules.
+  </description>
+</entry>
diff --git a/src/changelog/.2.x.x/update_third_party_dependencies.xml b/src/changelog/.2.x.x/update_third_party_dependencies.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="updated">
+  <issue id="447" link="https://github.com/apache/logging-flume/pull/447"/>
+  <issue id="453" link="https://github.com/apache/logging-flume/pull/453"/>
+  <issue id="454" link="https://github.com/apache/logging-flume/pull/454"/>
+  <issue id="455" link="https://github.com/apache/logging-flume/pull/455"/>
+  <description format="asciidoc">Update the third-party dependencies to their latest versions, including Jetty 12, Jackson and Apache Commons Lang 3</description>
+</entry>
diff --git a/src/changelog/.changelog.adoc.ftl b/src/changelog/.changelog.adoc.ftl
@@ -0,0 +1,27 @@
+<#--
+  ~ 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>
+<#list entriesByType as entryType, entries>
+
+${"[#release-notes-" + release.version?replace("[^a-zA-Z0-9]", "-", "r") + "-" + entryType?lower_case + "]"}
+=== ${entryType?capitalize}
+
+<#list entries as entry>
+* ${entry.description.text?replace("\\s+", " ", "r")}<#if entry.issues?has_content> (<#list entry.issues as issue>${issue.link}[${issue.id}]<#if issue?has_next>, </#if></#list>)</#if>
+</#list>
+</#list>
+</#if>
diff --git a/src/changelog/.index.adoc.ftl b/src/changelog/.index.adoc.ftl
@@ -0,0 +1,42 @@
+////
+    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 THIS FILE IS CALLED `release-notes.adoc`, IT IS AUTO-GENERATED, DO NOT EDIT IT!
+
+    The release notes page is generated from `src/changelog/.index.adoc.ftl` during
+    the `pre-site` phase of the Maven build and is written to
+    `target/generated-site/antora/modules/ROOT/pages/release-notes.adoc`,
+    where the Antora site build picks it up.
+    Hence, you must always edit `.index.adoc.ftl` and never the generated file.
+////
+
+// Release notes index does not look nice with a deep sectioning, override it:
+:page-toclevels: 1
+
+${"[#release-notes]"}
+= Release notes
+<#list releases as release><#if release.changelogEntryCount gt 0>
+
+include::_release-notes/${release.version}.adoc[]
+</#if></#list>
diff --git a/src/changelog/1.0.0/.release-notes.adoc.ftl b/src/changelog/1.0.0/.release-notes.adoc.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
+
+         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.
+////
+
+${"[#release-notes-" + release.version?replace("[^a-zA-Z0-9]", "-", "r") + "]"}
+== ${release.version}
+
+<#if release.date?has_content>Release date:: ${release.date}</#if>
+
+This release is the first release of Apache Flume within the Apache
+Incubator, and is labelled and should be considered as a beta version.
+
+<#include "../.changelog.adoc.ftl">
diff --git a/src/changelog/1.0.0/.release.xml b/src/changelog/1.0.0/.release.xml
@@ -0,0 +1,21 @@
+<?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="https://logging.apache.org/xml/ns"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+         date="2012-01-03" version="1.0.0"/>