Document Kafka limitations in error handling

[stn1slv]

Added limitations section for Kafka regarding error handling.

Writer's Quality Checklist

Before merging your PR, did you:

• Run spell checker
• Run link checker to check for broken xrefs
• Check for orphan files
• Perform a local build and do a final visual check of your content, including checking for:
  • Broken images
  • Dead links
  • Correct rendering of partials if they are used in your content
  • Formatting issues, such as:
    • Misnumbered ordered lists (steps) or incorrectly nested unordered lists
    • Messed up tables
    • Proper indentation
    • Correct header levels
• Receive final review and signoff from:
  • Technical SME
  • Product Manager
  • Editor or peer reviewer
  • Reporter, if this content is in response to a reported issue (internal or external feedback)
• If applicable, verify that the software actually got released

[salesforce-cla]

Thanks for the contribution! Before we can merge this, we need @stn1slv to sign the Salesforce Inc. Contributor License Agreement.

[Copilot]

Pull Request Overview

This PR documents Kafka limitations in error handling for APIkit AsyncAPI by adding a specific section about the constraints of implementing Dead Letter Queue (DLQ) and Dead Letter Topic (DLT) patterns.

• Added a limitations section for Kafka error handling
• Documented that DLQ/DLT patterns cannot be implemented due to Source Message Listener behavior
• Clarified that consumers are responsible for routing invalid messages to DLQ/DLT topics

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Crispy-Salesforce]

W-19748621 was created to track the effort to address this feedback.

[stn1slv]

@Crispy-Salesforce, could you please provide an update regarding W-19748621? I currently do not have access to view this item.