Just a quick note, we have made the following changes in kafka-site * Default branch is now "markdown" (PRs should target this branch) * asf-site has been updated with the Hugo-built site * Any new commits to "markdown" branch are automatically deployed to asf-staging (https://kafka.staged.apache.org/) * "Build and Deploy" workflow can be manually run to update the live website (see screenshot)
[image: image.png] We have not yet merged the markdown changes to the Kafka release branches, though expect that to happen soon. So, in other words, we are live! -David A On Fri, Dec 12, 2025 at 7:49 PM Harish Vishwanath <[email protected]> wrote: > Thank you all for the support. The proposal to cutover has been accepted > with 7 binding (Matthias J. Sax, Lucas Brutschy, David Jacot, Mickael > Maison, Chia-Ping Tsai, David Arthur, Apoorv Mittal) and 1 non-binding > (Muralidhar Basani) votes. > > I will work on the next steps and complete this effort at the earliest. > > Regards, > Harish > > > On Fri, Dec 12, 2025 at 10:57 AM Muralidhar Basani via dev < > [email protected]> wrote: > > > 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 > > > > > > > > > > -- David Arthur
