1st drafts

Author: spelluru

articles/event-hubs/apache-kafka-developer-guide.md

@@ -75,3 +75,11 @@ See the following How-to guides in our documentation:
 ## Next steps
 Review samples in the GitHub repo [azure-event-hubs-for-kafka](https://github.com/Azure/azure-event-hubs-for-kafka) under quickstart and tutorials folders.
 
+Also, see the following articles:
+
+- [Apache Kafka troubleshooting guide for Event Hubs](apache-kafka-troubleshooting-guide.md)
+- [Frequently asked questions - Event Hubs for Apache Kafka](apache-kafka-frequently-asked-questions.md)
+- [Apache Kafka migration guide for Event Hubs](apache-kafka-migration-guide.md)
+
+
+

articles/event-hubs/apache-kafka-frequently-asked-questions.md

@@ -17,6 +17,7 @@ ms.author: shvija
 ---
 
 # Frequently asked questions - Event Hubs for Apache Kafka 
+This article provides answers to some of the frequently asked questions on migrating to Event Hubs for Apache Kafka.
 
 ## Do you run Apache Kafka?
 
@@ -43,12 +44,7 @@ What's the difference between an Event Hub consumer group and a Kafka consumer g
 ## Next steps
 To learn more about Event Hubs and Event Hubs for Kafka, see the following articles:  
 
-- [Event Hubs for Apache Kafka - Overview](event-hubs-for-kafka-ecosystem-overview.md)
-- [Quickstart: Data streaming with Event Hubs using the Kafka protocol](event-hubs-quickstart-kafka-enabled-event-hubs.md)
-- [Tutorial: Process Apache Kafka for Event Hubs events using Stream analytics](event-hubs-kafka-stream-analytics.md)
-- [Mirror a Kafka broker in an event hub](event-hubs-kafka-mirror-maker-tutorial.md)
-- [Connect Apache Spark to an event hub](event-hubs-kafka-spark-tutorial.md)
-- [Integrate Apache Kafka Connect with a event hub (Preview)](event-hubs-kafka-connect-tutorial.md)
-- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
-- [Use the Spring Boot Starter for Apache Kafka with Azure Event Hubs](/azure/java/spring-framework/configure-spring-cloud-stream-binder-java-app-kafka-azure-event-hub)
+- [Apache Kafka developer guide for Event Hubs](apache-kafka-developer-guide.md)
+- [Apache Kafka migration guide for Event Hubs](apache-kafka-migration-guide.md)
+- [Apache Kafka troubleshooting guide for Event Hubs](apache-kafka-troubleshooting-guide.md)
 

articles/event-hubs/apache-kafka-migration-guide.md

@@ -64,12 +64,8 @@ Run your Kafka application that sends events to the event hub. Then, verify that
 ## Next steps
 To learn more about Event Hubs and Event Hubs for Kafka, see the following articles:  
 
-- [Event Hubs for Apache Kafka - Overview](event-hubs-for-kafka-ecosystem-overview.md)
-- [Quickstart: Data streaming with Event Hubs using the Kafka protocol](event-hubs-quickstart-kafka-enabled-event-hubs.md)
-- [Tutorial: Process Apache Kafka for Event Hubs events using Stream analytics](event-hubs-kafka-stream-analytics.md)
-- [Mirror a Kafka broker in an event hub](event-hubs-kafka-mirror-maker-tutorial.md)
-- [Connect Apache Spark to an event hub](event-hubs-kafka-spark-tutorial.md)
-- [Integrate Apache Kafka Connect with a event hub (Preview)](event-hubs-kafka-connect-tutorial.md)
-- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
-- [Use the Spring Boot Starter for Apache Kafka with Azure Event Hubs](/azure/java/spring-framework/configure-spring-cloud-stream-binder-java-app-kafka-azure-event-hub)
+- [Apache Kafka troubleshooting guide for Event Hubs](apache-kafka-troubleshooting-guide.md)
+- [Frequently asked questions - Event Hubs for Apache Kafka](apache-kafka-frequently-asked-questions.md)
+- [Apache Kafka developer guide for Azure Event Hubs](apache-kafka-developer-guide.md)
 
+- 

articles/event-hubs/apache-kafka-troubleshooting-guide.md

@@ -16,7 +16,8 @@ ms.author: shvija
 
 ---
 
-# Troubleshoot issues with using Event Hubs for Apache Kafka
+# Apache Kafka troubleshooting guide for Event Hubs
+This article provides troubleshooting tips for issues that you may run into when using Event Hubs for Apache Kafka. 
 
 ## Server Busy exception
 You may receive Server Busy exception due to Kafka throttling. With AMQP clients, Event Hubs immediately returns a **Server Busy** exception upon service throttling. It's equivalent to a "try again later" message. In Kafka, messages are delayed before being completed. The delay length is returned in milliseconds as `throttle_time_ms` in the produce/fetch response. In most cases, these delayed requests aren't logged as ServerBusy exceptions on Event Hubs dashboards. Instead, the response's `throttle_time_ms` value should be used as an indicator that throughput has exceeded the provisioned quota.
@@ -70,12 +71,7 @@ Apache Kafka vs. Event Hubs Kafka. For the most part, the Event Hubs for Kafka E
 ## Next steps
 To learn more about Event Hubs and Event Hubs for Kafka, see the following articles:  
 
-- [Event Hubs for Apache Kafka - Overview](event-hubs-for-kafka-ecosystem-overview.md)
-- [Quickstart: Data streaming with Event Hubs using the Kafka protocol](event-hubs-quickstart-kafka-enabled-event-hubs.md)
-- [Tutorial: Process Apache Kafka for Event Hubs events using Stream analytics](event-hubs-kafka-stream-analytics.md)
-- [Mirror a Kafka broker in an event hub](event-hubs-kafka-mirror-maker-tutorial.md)
-- [Connect Apache Spark to an event hub](event-hubs-kafka-spark-tutorial.md)
-- [Integrate Apache Kafka Connect with a event hub (Preview)](event-hubs-kafka-connect-tutorial.md)
-- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
-- [Use the Spring Boot Starter for Apache Kafka with Azure Event Hubs](/azure/java/spring-framework/configure-spring-cloud-stream-binder-java-app-kafka-azure-event-hub)
+- [Apache Kafka developer guide for Event Hubs](apache-kafka-developer-guide.md)
+- [Apache Kafka migration guide for Event Hubs](apache-kafka-migration-guide.md)
+- [Frequently asked questions - Event Hubs for Apache Kafka](apache-kafka-frequently-asked-questions.md)