mimaison commented on code in PR #18027: URL: https://github.com/apache/kafka/pull/18027#discussion_r1869316173
########## README.md: ########## @@ -1,55 +1,105 @@ -Apache Kafka -================= -See our [web site](https://kafka.apache.org) for details on the project. - -You need to have [Java](http://www.oracle.com/technetwork/java/javase/downloads/index.html) installed. - -We build and test Apache Kafka with 17 and 23. The `release` parameter in javac and scalac is set to `11` for the clients -and streams modules, and `17` for the broker and tools, ensuring compatibility with their respective minimum Java versions. - -Scala 2.13 is the only supported version in Apache Kafka. - -### Build a jar and run it ### +# Apache Kafka + +<a href="https://kafka.apache.org/";> +<picture> + <source media="(prefers-color-scheme: dark)" srcset="docs/images/kafka-logo-readme-dark.svg"> + <source media="(prefers-color-scheme: light)" srcset="docs/images/kafka-logo-readme-light.svg"> + <img alt="Kafka Logo" src="docs/images/kafka-logo-readme-light.svg" width="80"> +</picture> +</a> +<br><br> + +* [Building Kafka](#building-kafka) + * [Prerequisites](#prerequisites) + * [Build steps](#build-steps) + * [Build a jar and run it](#build-a-jar-and-run-it) + * [Build source jar](#build-source-jar) + * [Build aggregated javadoc](#build-aggregated-javadoc) + * [Build javadoc and scaladoc](#build-javadoc-and-scaladoc) +* [Testing Kafka](#testing-kafka) + * [Run unit/integration tests](#run-unitintegration-tests) + * [Force re-running tests without code change](#force-re-running-tests-without-code-change) + * [Running a particular unit/integration test](#running-a-particular-unitintegration-test) + * [Repeatedly running a particular unit/integration test with specific times by setting N](#repeatedly-running-a-particular-unitintegration-test-with-specific-times-by-setting-n) + * [Running a particular test method within a unit/integration test](#running-a-particular-test-method-within-a-unitintegration-test) + * [Running a particular unit/integration test with log4j output](#running-a-particular-unitintegration-test-with-log4j-output) + * [Specifying test retries](#specifying-test-retries) +* [Running a Kafka broker in KRaft mode](#running-a-kafka-broker-in-kraft-mode) + * [Using compiled files](#using-compiled-files) + * [Using docker image](#using-docker-image) +* [Test Coverage](#test-coverage) + * [Generating test coverage reports](#generating-test-coverage-reports) +* [Other Actions](#other-actions) + * [Building a binary release gzipped tarball](#building-a-binary-release-gzipped-tar-ball) + * [Building auto generated messages](#building-auto-generated-messages) + * [Cleaning the build](#cleaning-the-build) + * [Running a task for a specific project](#running-a-task-for-a-specific-project) + * [Listing all gradle tasks](#listing-all-gradle-tasks) + * [Building IDE project](#building-ide-project) + * [Publishing the streams quickstart archetype artifact to maven](#publishing-the-streams-quickstart-archetype-artifact-to-maven) + * [Installing specific projects to the local Maven repository](#installing-specific-projects-to-the-local-maven-repository) + * [Building the test jar](#building-the-test-jar) +* [Running code quality checks](#running-code-quality-checks) + * [Checkstyle](#checkstyle) + * [Spotless](#spotless) + * [Spotbugs](#spotbugs) +* [JMH microbenchmarks](#jmh-microbenchmarks) +* [Dependency Analysis](#dependency-analysis) + * [Determining if any dependencies could be updated](#determining-if-any-dependencies-could-be-updated) +* [Common build options](#common-build-options) +* [Running system tests](#running-system-tests) +* [Running in Vagrant](#running-in-vagrant) +* [Contributing Kafka](#contributing-kafka) Review Comment: Contributing **to** Kafka -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: jira-unsubscr...@kafka.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
