>From the time I first wrote any docs for Kafka, I wondered "why are we editing HTML like we are in the 2000s?" :)
This has been a long time coming and will be a major quality of life improvement for committers and contributors alike. Thanks for driving this, Harish. +1 binding -David A On Fri, Dec 12, 2025 at 3:07 AM Chia-Ping Tsai <[email protected]> wrote: > +1 (binding) > > Out of curiosity. Why was 3.5 chosen as the baseline? Is 3.5 a kind of > lucky number? > > > David Jacot via dev <[email protected]> 於 2025年12月12日 下午2:48 寫道： > > > > +1 (binding). Thanks for driving this, Harish! > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison < > [email protected]> > >> wrote: > >> > >> Hi, > >> > >> Thanks for contributing this! > >> There are still a few rough edges but the from a quick browse it > >> already looks really good. > >> > >> Really happy we managed to keep the rotating Apache logo Easter egg > >> > >> +1 (binding) > >> > >> Thanks, > >> Mickael > >> > >>> On Thu, Dec 11, 2025 at 10:22 AM Lucas Brutschy via dev > >>> <[email protected]> wrote: > >>> > >>> Thanks, Harish! > >>> > >>> +1 (binding) > >>> > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <[email protected]> > >> wrote: > >>>> > >>>> +1 (binding) > >>>> > >>>> Thanks a ton(!) for all the efforts on this Harish. It's a mountain to > >>>> be moved to make this happen, and I am very happy to see this going > >> over > >>>> the finish line. > >>>> > >>>> Also call out to David Arthur, for his outstanding support! > >>>> > >>>> The bug-bash we did was great, but it's the nature of web-pages to > >>>> literally always have some errors. So I am totally in favor to just > >> make > >>>> the switch, and avoid chasing a moving target. For 4.1 and older > >>>> releases, docs should be stable, and if we cut over now, we can just > >>>> fix-forward anything for upcoming 4.2 release, so I think it's pretty > >>>> good timing to do to now IMHO. The release will force us naturally to > >>>> check docs, and find issue. > >>>> > >>>> > >>>> -Matthias > >>>> > >>>> On 12/5/25 7:43 AM, Harish Vishwanath wrote: > >>>>> Hi all, > >>>>> > >>>>> Following the community review, I would like to call for a vote on > >> cutting > >>>>> over to markdown based AK website (KIP 1133). Fully functional site > >> is live > >>>>> on staging at https://kafka.staged.apache.org/. > >>>>> > >>>>> If the Vote Passes: > >>>>> > >>>>> - I will migrate the source documentation in the docs directory of > >> the > >>>>> apache/kafka repository to Markdown for versions *3.5 and newer.* > >>>>> - Older versions (pre-3.5) will be left as-is (HTML) in the kafka > >> repo to > >>>>> avoid disruption. > >>>>> - Update CI/CD deploy the markdown branch to the live production > >> site. > >>>>> > >>>>> For reference: > >>>>> > >>>>> - KIP 1133: > >>>>> > >> > https://cwiki.apache.org/confluence/display/KAFKA/KIP-1133%3A+AK+Documentation+and+Website+in+Markdown#KIP1133:AKDocumentationandWebsiteinMarkdown-AKwebsitedocumentation > >>>>> - Previous discussions: > >>>>> https://lists.apache.org/thread/yr5rqyx1d6lvyb9t9tbf26stsh214v4r > >>>>> - Markdown source for AK website: `markdown` branch at > >>>>> https://github.com/apache/kafka-site > >>>>> > >>>>> Regards, > >>>>> Harish > >>>>> > >>>> > >> > -- David Arthur
