Hi Harish, Thanks for the KIP, this is a massive effort. A lot has been achieved with automation and continuous efforts.
I am in favour of the cutover and fixing some rough edges with older versions. +1 (binding) Regards, Apoorv Mittal On Fri, Dec 12, 2025 at 2:07 PM David Arthur <[email protected]> wrote: > 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 >
