Re: Documentation build system

2018-02-07 Thread Sönke Liebau
Hi, I'm in favor of moving away from HTML as well, while I have not had direct exposure to the pain points that Ewen mentions it is in general not pleasant to write docs in I think and bears a lot of risk of parsing failures etc. I can't vote for using rst, not having used it, but I am happy to v

Re: Documentation build system

2018-02-06 Thread Guozhang Wang
Ewen, Thanks for re-picking this up again. I'm big +1 as I was two years ago :P One thing that may still worth pointing out is that migrating from html means that for any edits it would require one more compilation step to review / compare the diffs if it is not only wording but also formatting /

Documentation build system

2018-02-06 Thread Ewen Cheslack-Postava
Hi all, I just wrote a note in https://issues.apache.org/jira/browse/KAFKA-2967 with a proposal for changing how docs are written. I want to move on this soon if possible and normally would just leave the discussion to the JIRA, but as I think this is something everyone has an opinion on and affec