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
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 /
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