tombentley commented on pull request #8878: URL: https://github.com/apache/kafka/pull/8878#issuecomment-645868566
Another thought I had about improving the docs (though not for this PR) would be to have an index of links in alphabetical order at the start of each section (e.g. after "Broker Configs" header and before the table). This would make it much simpler to find a specific config (if you knew its name). Currently you can click on the top level ToC to get to, e.g., the "Broker Configs" section, but then have to scroll for pages searching (and they're not in alphabetical order) until you find the one you want. With an index it would be two clicks, one (binary) search of a sorted list and no scrolling. We might not want this for all configs, but for the longer ones I think it would be valuable. ---------------------------------------------------------------- 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. For queries about this service, please contact Infrastructure at: [email protected]
