[
https://issues.apache.org/jira/browse/KAFKA-2881?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15025610#comment-15025610
]
ASF GitHub Bot commented on KAFKA-2881:
---------------------------------------
Github user gwenshap commented on the pull request:
https://github.com/apache/kafka-site/pull/5#issuecomment-159430950
The patch looks good, but I'm concerned that by committing to kafka-site
directly, we will lose sync with the docs in the trunk.
Mind making this a kafka trunk PR and then we can push the change to both
repos?
> Documentation improvement
> -------------------------
>
> Key: KAFKA-2881
> URL: https://issues.apache.org/jira/browse/KAFKA-2881
> Project: Kafka
> Issue Type: Improvement
> Affects Versions: 0.9.0.0
> Reporter: Gwen Shapira
> Assignee: Guozhang Wang
>
> 1. We seem to be missing section 4.9 (Quotas) in the table of contents
> 2. The consumer documentation could use a little meta-guidance. There are
> three sections "High Level Consumer", "Simple Consumer", "New Consumer". If I
> came into this fresh, I would be super confused as to what these things were
> and which I should use. I think we need to add a section that introduces the
> state of things--i.e. when should you use each?
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
