Hi Harish, Great effort and a nice initiative. +1 (non-binding)
Regards, Murali On Fri, Dec 12, 2025 at 7:40 PM Apoorv Mittal <[email protected]> wrote: > 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 > > >
