Thanks Gwen! When I first wrote the possible error codes in code I was also thinking about auto-generate the table in docs if possible. But unfortunately cannot find a possible manner. When we add more error codes / change error codes for requests / responses we need to keep track on the wiki, which will be hard for all developers to follow.
Guozhang On Tue, Jan 19, 2016 at 11:27 PM, Muqtafi Akhmad <muqt...@traveloka.com> wrote: > Thank you guys for filling the details in the wiki, it really helps > > On Tue, Jan 19, 2016 at 2:07 AM, Ismael Juma <ism...@juma.me.uk> wrote: > > > That would be even better Gwen. > > > > Ismael > > I'm wondering if the protocol docs can be auto-generated from our code > to a > > large extent. Or if we can enhance our protocol definition classes a bit > to > > make them self-documenting (the way we did for configuration). > > > > Regarding Dana's suggestion: I think you need special wiki-edit > privileges. > > If you don't see the "edit" bottom, I'd ask in "dev" list for that > > privilege (sorry, looks like I'm not a wiki admin, so I can't add you). > > > > On Mon, Jan 18, 2016 at 7:46 AM, Ismael Juma <ism...@juma.me.uk> wrote: > > > > > In addition to this, it would be great to move the protocol docs to the > > > docs folder of the git repo: > > > > > > https://github.com/apache/kafka/tree/trunk/docs > > > > > > This way, we can ensure that the protocol docs are updated at the same > > time > > > as the protocol code. > > > > > > Ismael > > > > > > On Mon, Jan 18, 2016 at 3:36 PM, Dana Powers <dana.pow...@gmail.com> > > > wrote: > > > > > > > Not exactly - there is some documentation in the source code, but I > > agree > > > > that a wiki on this would be extremely useful. > > > > > > > > Can anyone create a wiki page? If so, I'm happy to get something > > started. > > > > It is really the missing piece for folks writing custom clients / > > > anything > > > > at the api layer. > > > > > > > > -Dana > > > > On Jan 18, 2016 04:07, "Muqtafi Akhmad" <muqt...@traveloka.com> > wrote: > > > > > > > > > dear all, > > > > > > > > > > I found a guide in Kafka protocol (Kafka Protocol Guide > > > > > < > > > > > > > > > > > > > > > > > https://cwiki.apache.org/confluence/display/KAFKA/A+Guide+To+The+Kafka+Protocol#AGuideToTheKafkaProtocol-OffsetRequest > > > > > >), > > > > > the guide describes API calls complete with their request and > > response > > > > > format, and list of error codes with their description . My > question > > > is, > > > > is > > > > > there documentation of possible error code mapping for each API > > > request? > > > > > > > > > > Thank you, > > > > > > > > > > -- > > > > > Muqtafi Akhmad > > > > > Software Engineer > > > > > Traveloka > > > > > > > > > > > > > > > > > > -- > Muqtafi Akhmad > Software Engineer > Traveloka > -- -- Guozhang
