THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
- git clone git@github.com:apache/kafka-site.git
- git checkout asf-site
- Update the website content including docs:
- The gradle target
releaseTarGz
generates the Kafka website content including the Kafka documentation (with the exception of a few pages like project-security.html, which are only tracked in the kafka-site repository). This build target also auto-generates the configuration docs of the Kafka broker/producer/consumer/etc. from their respective Java sources. The build output is stored in./core/build/distributions/kafka_2.13-2.8.0-site-docs.tgz
. - Untar the file and rename the
site-docs/
folder to28/
(or, if the latter already exists, replace its contents). That's because the docs for a release are stored in a separate folder (e.g.,27/
for Kafka v2.7 and28/
for Kafka v2.8), which ensures the Kafka website includes the documentation for the current and all past Kafka releases.
- The gradle target
- Update the javadocs:
- Create the release Javadocs with the gradle target
aggregatedJavadoc (`./gradlew aggregatedJavadoc`) on JDK 17
, with output under./build/docs/javadoc/
. - Copy the
javadoc
folder to28/
(i.e., the full path is28/javadoc/
). If this is bug fix release, do this after the vote has passed to avoid showing an unreleased version number in the published javadocs.- Note that this will upload the javadocs with a version named
{RELEASE_VERSION}-SNAPSHOT
. Once you have an RC cut with a git tag, check out that git tag and re-generate the javadocs. That way it will not have the-SNAPSHOT
suffix anymore
- Note that this will upload the javadocs with a version named
- Create the release Javadocs with the gradle target
- Commit & push
Blog Post
- For minor and major releases, consider writing a blog. Since the Apache blogs platform is now sunset, we've added a blog section to the Kafka website. Unfortunately this requires writing it in HTML, see the blog.html file in kafka-site.
It's nice to thank as many people as we can identify. Please use "Find all contributors" script to generate the list of contributors.
- Consider incorporating any suggestions from the dev thread until release is announced
...