Hi, I opened a few Jiras for some of the rough edges I mentioned above: - https://issues.apache.org/jira/browse/KAFKA-20008 - https://issues.apache.org/jira/browse/KAFKA-20009 - https://issues.apache.org/jira/browse/KAFKA-20010 - https://issues.apache.org/jira/browse/KAFKA-20011
Thanks, Mickael On Thu, Dec 18, 2025 at 1:34 PM Harish Vishwanath <[email protected]> wrote: > > Thank you for reporting this issue Federico. I will fix this shortly. > > Regards, > Harish > > > On Thu, Dec 18, 2025 at 2:11 AM Federico Valeri <[email protected]> > wrote: > > > Hi Harish, thanks a lot for this work. The new website is great, but I > > wanted to raise an issue: > > > > https://issues.apache.org/jira/browse/KAFKA-20006 > > > > > > On Thu, Dec 18, 2025 at 12:28 AM Matthias J. Sax <[email protected]> wrote: > > > > > Nice! > > > > > > Thanks for the holiday gift, Harish and David! > > > > > > > > > -Matthias > > > > > > On 12/17/25 1:33 PM, David Arthur wrote: > > > > 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/ <https:// > > > > kafka.staged.apache.org/>) > > > > * "Build and Deploy" workflow can be manually run to update the live > > > > website (see screenshot) > > > > > > > > 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] <mailto:[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] <mailto:[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] <mailto:[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] > > > > <mailto:[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] <mailto:[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] > > > > <mailto:[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] <mailto:[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] <mailto:[email protected]>> > > > wrote: > > > > > > > > >>> > > > > > > > > >>> Thanks, Harish! > > > > > > > > >>> > > > > > > > > >>> +1 (binding) > > > > > > > > >>> > > > > > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax < > > > > > [email protected] <mailto:[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/ > > > > <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 > > > < > > > > > 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 > > > > <https://lists.apache.org/thread/yr5rqyx1d6lvyb9t9tbf26stsh214v4r> > > > > > > > > >>>>> - Markdown source for AK website: `markdown` branch > > at > > > > > > > > >>>>> https://github.com/apache/kafka-site <https:// > > > > github.com/apache/kafka-site> > > > > > > > > >>>>> > > > > > > > > >>>>> Regards, > > > > > > > > >>>>> Harish > > > > > > > > >>>>> > > > > > > > > >>>> > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > > > > David Arthur > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > David Arthur > > > > > > > >
