[GitHub] [kafka] LeonSamuel opened a new pull request, #12115: Update README.md

[GitBox <gi...@apache.org>]

LeonSamuel opened a new pull request, #12115:
URL: https://github.com/apache/kafka/pull/12115

   As someone new to Kafka, it would have been welcoming to see a succinct high-level overview of what Kafka is as the first piece of documentation. As I clicked on the home page of Kafka website, I read about seemingly disconnected pieces of what Kafka could do but the project didn't succeed in taking on a tangible form or differentiating itself from similar scaling systems. This leaves it up to the user to either quit or continue to push into a third attempt of research - but now with more apprehension. I thought my additions (quoted from the Kafka website) would add some clarity and decrease the barrier for those who may want to quickly learn about the system.
   
   *More detailed description of your change,
   if necessary. The PR title and PR message become
   the squashed commit message, so use a separate
   comment to ping reviewers.*
   
   *Summary of testing strategy (including rationale)
   for the feature or bug fix. Unit and/or integration
   tests are expected for any behaviour change and
   system tests should be considered for larger changes.*
   
   ### Committer Checklist (excluded from commit message)
   - [X] Verify design and implementation 
   - [ ] Verify test coverage and CI build status
   - [ ] Verify documentation (including upgrade notes)
   


-- 
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-unsubscribe@kafka.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

[GitHub] [kafka] junrao commented on a diff in pull request #12115: Update README.md

[GitBox <gi...@apache.org>]

junrao commented on code in PR #12115:
URL: https://github.com/apache/kafka/pull/12115#discussion_r887335919


##########
README.md:
##########
@@ -1,6 +1,9 @@
 Apache Kafka
 =================
-See our [web site](https://kafka.apache.org) for details on the project.
+
+Kafka is a distributed system consisting of servers and clients that communicate via a high-performance [TCP network protocol](https://kafka.apache.org/protocol.html). It can be deployed on bare-metal hardware, virtual machines, and containers in on-premise as well as cloud environments. Kafka allows you to write distributed applications and microservices that read, write, and process streams of events in parallel, at scale, and in a fault-tolerant manner even in the case of network problems or machine failures.

Review Comment:
   Kafka is a distributed system => Kafka is a distributed event streaming system ?



-- 
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-unsubscribe@kafka.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org