You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@kafka.apache.org by Harish Vishwanath <ha...@gmail.com> on 2025/12/05 15:43:15 UTC

[VOTE]: KIP 1133 - Cut over to markdown based AK Website

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

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Mickael Maison <mi...@gmail.com>.
Hi,

I also opened https://issues.apache.org/jira/browse/KAFKA-20051

Thanks,
Mickael

On Wed, Jan 7, 2026 at 11:33 AM Mickael Maison <mi...@gmail.com> wrote:
>
> Hi,
>
> Thanks for the updates!
>
> I opened a few more Jiras regarding the website:
> - https://issues.apache.org/jira/browse/KAFKA-20048
> - https://issues.apache.org/jira/browse/KAFKA-20049
> - https://issues.apache.org/jira/browse/KAFKA-20050
>
> Another thing that's probably a matter of taste. I wonder if we could
> use more contrast for the table of content on the right hand side and
> in the footer.
> In both cases, I find the gray text hard to read.
>
> Finally I wonder if we should rebase the markdown branch on top of
> asf-site so we keep the commit history.
>
> Thanks,
> Mickael
>
> On Mon, Dec 22, 2025 at 4:32 PM Chia-Ping Tsai <ch...@gmail.com> wrote:
> >
> > hi Harish
> >
> > Thanks for the explanation. I'll follow that process
> >
> > Best,
> > Chia-Ping
> >
> > Harish Vishwanath <ha...@gmail.com> 於 2025年12月22日週一 下午11:23寫道:
> >
> > > Hello Chia-Ping,
> > >
> > > The `docs` directory PRs on apache/kafka repo follows a similar process as
> > > before. Merge in apache/kafka repo, and once we are ready to build the
> > > website, copy them over to apache/kafka-site repo and trigger a build.
> > >
> > > Regards,
> > > Harish
> > >
> > >
> > > On Mon, Dec 22, 2025 at 3:12 AM Chia-Ping Tsai <ch...@apache.org>
> > > wrote:
> > >
> > > > hi Harish
> > > >
> > > > Quick question: how should I handle PRs that updates `.md` files in the
> > > > Kafka repo (e.g., #21203)? Can I simply merge it, or do I need to update
> > > > the kafka-site repo as well?
> > > >
> > > > thanks,
> > > > Chia-Ping
> > > >
> > > > On 2025/12/18 16:31:33 Harish Vishwanath wrote:
> > > > > Thank you, I will work on those.
> > > > >
> > > > > Regards,
> > > > > Harish
> > > > >
> > > > >
> > > > > On Thu, Dec 18, 2025 at 8:30 AM Mickael Maison <
> > > mickael.maison@gmail.com
> > > > >
> > > > > wrote:
> > > > >
> > > > > > 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
> > > > > > <ha...@gmail.com> 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 <
> > > > fedevaleri@gmail.com>
> > > > > > > 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 <
> > > mjsax@apache.org
> > > > >
> > > > > > 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
> > > > > > > > > > <harish.shastry@gmail.com <ma...@gmail.com>>
> > > > > > 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
> > > > <
> > > > > > > > > >     dev@kafka.apache.org <ma...@kafka.apache.org>>
> > > 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
> > > > > > > > > >     <apoorvmittal10@gmail.com <mailto:
> > > apoorvmittal10@gmail.com
> > > > >>
> > > > > > > > > >      > 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 <
> > > > > > > > mumrah@gmail.com
> > > > > > > > > >     <ma...@gmail.com>> 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
> > > > > > > > > >     <chia7712@gmail.com <ma...@gmail.com>>
> > > > > > > > > >      > > 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 <dev@kafka.apache.org
> > > > > > > > > >     <ma...@kafka.apache.org>> 於 2025年12月12日 下午2:48
> > > > > > > > > >      > 寫道:
> > > > > > > > > >      > > > > >
> > > > > > > > > >      > > > > > +1 (binding). Thanks for driving this,
> > > Harish!
> > > > > > > > > >      > > > > >
> > > > > > > > > >      > > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael
> > > > Maison <
> > > > > > > > > >      > > > > mickael.maison@gmail.com <mailto:
> > > > > > mickael.maison@gmail.com
> > > > > > > > >>
> > > > > > > > > >      > > > > >> 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
> > > > > > > > > >      > > > > >>> <dev@kafka.apache.org <mailto:
> > > > > > dev@kafka.apache.org>>
> > > > > > > > > wrote:
> > > > > > > > > >      > > > > >>>
> > > > > > > > > >      > > > > >>> Thanks, Harish!
> > > > > > > > > >      > > > > >>>
> > > > > > > > > >      > > > > >>> +1 (binding)
> > > > > > > > > >      > > > > >>>
> > > > > > > > > >      > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J.
> > > > Sax <
> > > > > > > > > >      > mjsax@apache.org <ma...@apache.org>>
> > > > > > > > > >      > > > > >> 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
> > > > > > > > >
> > > > > > > > >
> > > > > > > >
> > > > > >
> > > > >
> > > >
> > >

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Mickael Maison <mi...@gmail.com>.
Hi,

Thanks for the updates!

I opened a few more Jiras regarding the website:
- https://issues.apache.org/jira/browse/KAFKA-20048
- https://issues.apache.org/jira/browse/KAFKA-20049
- https://issues.apache.org/jira/browse/KAFKA-20050

Another thing that's probably a matter of taste. I wonder if we could
use more contrast for the table of content on the right hand side and
in the footer.
In both cases, I find the gray text hard to read.

Finally I wonder if we should rebase the markdown branch on top of
asf-site so we keep the commit history.

Thanks,
Mickael

On Mon, Dec 22, 2025 at 4:32 PM Chia-Ping Tsai <ch...@gmail.com> wrote:
>
> hi Harish
>
> Thanks for the explanation. I'll follow that process
>
> Best,
> Chia-Ping
>
> Harish Vishwanath <ha...@gmail.com> 於 2025年12月22日週一 下午11:23寫道:
>
> > Hello Chia-Ping,
> >
> > The `docs` directory PRs on apache/kafka repo follows a similar process as
> > before. Merge in apache/kafka repo, and once we are ready to build the
> > website, copy them over to apache/kafka-site repo and trigger a build.
> >
> > Regards,
> > Harish
> >
> >
> > On Mon, Dec 22, 2025 at 3:12 AM Chia-Ping Tsai <ch...@apache.org>
> > wrote:
> >
> > > hi Harish
> > >
> > > Quick question: how should I handle PRs that updates `.md` files in the
> > > Kafka repo (e.g., #21203)? Can I simply merge it, or do I need to update
> > > the kafka-site repo as well?
> > >
> > > thanks,
> > > Chia-Ping
> > >
> > > On 2025/12/18 16:31:33 Harish Vishwanath wrote:
> > > > Thank you, I will work on those.
> > > >
> > > > Regards,
> > > > Harish
> > > >
> > > >
> > > > On Thu, Dec 18, 2025 at 8:30 AM Mickael Maison <
> > mickael.maison@gmail.com
> > > >
> > > > wrote:
> > > >
> > > > > 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
> > > > > <ha...@gmail.com> 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 <
> > > fedevaleri@gmail.com>
> > > > > > 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 <
> > mjsax@apache.org
> > > >
> > > > > 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
> > > > > > > > > <harish.shastry@gmail.com <ma...@gmail.com>>
> > > > > 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
> > > <
> > > > > > > > >     dev@kafka.apache.org <ma...@kafka.apache.org>>
> > 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
> > > > > > > > >     <apoorvmittal10@gmail.com <mailto:
> > apoorvmittal10@gmail.com
> > > >>
> > > > > > > > >      > 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 <
> > > > > > > mumrah@gmail.com
> > > > > > > > >     <ma...@gmail.com>> 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
> > > > > > > > >     <chia7712@gmail.com <ma...@gmail.com>>
> > > > > > > > >      > > 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 <dev@kafka.apache.org
> > > > > > > > >     <ma...@kafka.apache.org>> 於 2025年12月12日 下午2:48
> > > > > > > > >      > 寫道:
> > > > > > > > >      > > > > >
> > > > > > > > >      > > > > > +1 (binding). Thanks for driving this,
> > Harish!
> > > > > > > > >      > > > > >
> > > > > > > > >      > > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael
> > > Maison <
> > > > > > > > >      > > > > mickael.maison@gmail.com <mailto:
> > > > > mickael.maison@gmail.com
> > > > > > > >>
> > > > > > > > >      > > > > >> 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
> > > > > > > > >      > > > > >>> <dev@kafka.apache.org <mailto:
> > > > > dev@kafka.apache.org>>
> > > > > > > > wrote:
> > > > > > > > >      > > > > >>>
> > > > > > > > >      > > > > >>> Thanks, Harish!
> > > > > > > > >      > > > > >>>
> > > > > > > > >      > > > > >>> +1 (binding)
> > > > > > > > >      > > > > >>>
> > > > > > > > >      > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J.
> > > Sax <
> > > > > > > > >      > mjsax@apache.org <ma...@apache.org>>
> > > > > > > > >      > > > > >> 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
> > > > > > > >
> > > > > > > >
> > > > > > >
> > > > >
> > > >
> > >
> >

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Chia-Ping Tsai <ch...@gmail.com>.
hi Harish

Thanks for the explanation. I'll follow that process

Best,
Chia-Ping

Harish Vishwanath <ha...@gmail.com> 於 2025年12月22日週一 下午11:23寫道:

> Hello Chia-Ping,
>
> The `docs` directory PRs on apache/kafka repo follows a similar process as
> before. Merge in apache/kafka repo, and once we are ready to build the
> website, copy them over to apache/kafka-site repo and trigger a build.
>
> Regards,
> Harish
>
>
> On Mon, Dec 22, 2025 at 3:12 AM Chia-Ping Tsai <ch...@apache.org>
> wrote:
>
> > hi Harish
> >
> > Quick question: how should I handle PRs that updates `.md` files in the
> > Kafka repo (e.g., #21203)? Can I simply merge it, or do I need to update
> > the kafka-site repo as well?
> >
> > thanks,
> > Chia-Ping
> >
> > On 2025/12/18 16:31:33 Harish Vishwanath wrote:
> > > Thank you, I will work on those.
> > >
> > > Regards,
> > > Harish
> > >
> > >
> > > On Thu, Dec 18, 2025 at 8:30 AM Mickael Maison <
> mickael.maison@gmail.com
> > >
> > > wrote:
> > >
> > > > 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
> > > > <ha...@gmail.com> 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 <
> > fedevaleri@gmail.com>
> > > > > 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 <
> mjsax@apache.org
> > >
> > > > 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
> > > > > > > > <harish.shastry@gmail.com <ma...@gmail.com>>
> > > > 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
> > <
> > > > > > > >     dev@kafka.apache.org <ma...@kafka.apache.org>>
> 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
> > > > > > > >     <apoorvmittal10@gmail.com <mailto:
> apoorvmittal10@gmail.com
> > >>
> > > > > > > >      > 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 <
> > > > > > mumrah@gmail.com
> > > > > > > >     <ma...@gmail.com>> 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
> > > > > > > >     <chia7712@gmail.com <ma...@gmail.com>>
> > > > > > > >      > > 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 <dev@kafka.apache.org
> > > > > > > >     <ma...@kafka.apache.org>> 於 2025年12月12日 下午2:48
> > > > > > > >      > 寫道:
> > > > > > > >      > > > > >
> > > > > > > >      > > > > > +1 (binding). Thanks for driving this,
> Harish!
> > > > > > > >      > > > > >
> > > > > > > >      > > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael
> > Maison <
> > > > > > > >      > > > > mickael.maison@gmail.com <mailto:
> > > > mickael.maison@gmail.com
> > > > > > >>
> > > > > > > >      > > > > >> 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
> > > > > > > >      > > > > >>> <dev@kafka.apache.org <mailto:
> > > > dev@kafka.apache.org>>
> > > > > > > wrote:
> > > > > > > >      > > > > >>>
> > > > > > > >      > > > > >>> Thanks, Harish!
> > > > > > > >      > > > > >>>
> > > > > > > >      > > > > >>> +1 (binding)
> > > > > > > >      > > > > >>>
> > > > > > > >      > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J.
> > Sax <
> > > > > > > >      > mjsax@apache.org <ma...@apache.org>>
> > > > > > > >      > > > > >> 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
> > > > > > >
> > > > > > >
> > > > > >
> > > >
> > >
> >
>

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Harish Vishwanath <ha...@gmail.com>.
Hello Chia-Ping,

The `docs` directory PRs on apache/kafka repo follows a similar process as
before. Merge in apache/kafka repo, and once we are ready to build the
website, copy them over to apache/kafka-site repo and trigger a build.

Regards,
Harish


On Mon, Dec 22, 2025 at 3:12 AM Chia-Ping Tsai <ch...@apache.org> wrote:

> hi Harish
>
> Quick question: how should I handle PRs that updates `.md` files in the
> Kafka repo (e.g., #21203)? Can I simply merge it, or do I need to update
> the kafka-site repo as well?
>
> thanks,
> Chia-Ping
>
> On 2025/12/18 16:31:33 Harish Vishwanath wrote:
> > Thank you, I will work on those.
> >
> > Regards,
> > Harish
> >
> >
> > On Thu, Dec 18, 2025 at 8:30 AM Mickael Maison <mickael.maison@gmail.com
> >
> > wrote:
> >
> > > 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
> > > <ha...@gmail.com> 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 <
> fedevaleri@gmail.com>
> > > > 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 <mjsax@apache.org
> >
> > > 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
> > > > > > > <harish.shastry@gmail.com <ma...@gmail.com>>
> > > 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
> <
> > > > > > >     dev@kafka.apache.org <ma...@kafka.apache.org>> 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
> > > > > > >     <apoorvmittal10@gmail.com <mailto:apoorvmittal10@gmail.com
> >>
> > > > > > >      > 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 <
> > > > > mumrah@gmail.com
> > > > > > >     <ma...@gmail.com>> 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
> > > > > > >     <chia7712@gmail.com <ma...@gmail.com>>
> > > > > > >      > > 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 <dev@kafka.apache.org
> > > > > > >     <ma...@kafka.apache.org>> 於 2025年12月12日 下午2:48
> > > > > > >      > 寫道:
> > > > > > >      > > > > >
> > > > > > >      > > > > > +1 (binding). Thanks for driving this, Harish!
> > > > > > >      > > > > >
> > > > > > >      > > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael
> Maison <
> > > > > > >      > > > > mickael.maison@gmail.com <mailto:
> > > mickael.maison@gmail.com
> > > > > >>
> > > > > > >      > > > > >> 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
> > > > > > >      > > > > >>> <dev@kafka.apache.org <mailto:
> > > dev@kafka.apache.org>>
> > > > > > wrote:
> > > > > > >      > > > > >>>
> > > > > > >      > > > > >>> Thanks, Harish!
> > > > > > >      > > > > >>>
> > > > > > >      > > > > >>> +1 (binding)
> > > > > > >      > > > > >>>
> > > > > > >      > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J.
> Sax <
> > > > > > >      > mjsax@apache.org <ma...@apache.org>>
> > > > > > >      > > > > >> 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
> > > > > >
> > > > > >
> > > > >
> > >
> >
>

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Chia-Ping Tsai <ch...@apache.org>.
hi Harish

Quick question: how should I handle PRs that updates `.md` files in the Kafka repo (e.g., #21203)? Can I simply merge it, or do I need to update the kafka-site repo as well?

thanks,
Chia-Ping

On 2025/12/18 16:31:33 Harish Vishwanath wrote:
> Thank you, I will work on those.
> 
> Regards,
> Harish
> 
> 
> On Thu, Dec 18, 2025 at 8:30 AM Mickael Maison <mi...@gmail.com>
> wrote:
> 
> > 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
> > <ha...@gmail.com> 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 <fe...@gmail.com>
> > > 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 <mj...@apache.org>
> > 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
> > > > > > <harish.shastry@gmail.com <ma...@gmail.com>>
> > 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 <
> > > > > >     dev@kafka.apache.org <ma...@kafka.apache.org>> 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
> > > > > >     <apoorvmittal10@gmail.com <ma...@gmail.com>>
> > > > > >      > 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 <
> > > > mumrah@gmail.com
> > > > > >     <ma...@gmail.com>> 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
> > > > > >     <chia7712@gmail.com <ma...@gmail.com>>
> > > > > >      > > 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 <dev@kafka.apache.org
> > > > > >     <ma...@kafka.apache.org>> 於 2025年12月12日 下午2:48
> > > > > >      > 寫道:
> > > > > >      > > > > >
> > > > > >      > > > > > +1 (binding). Thanks for driving this, Harish!
> > > > > >      > > > > >
> > > > > >      > > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
> > > > > >      > > > > mickael.maison@gmail.com <mailto:
> > mickael.maison@gmail.com
> > > > >>
> > > > > >      > > > > >> 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
> > > > > >      > > > > >>> <dev@kafka.apache.org <mailto:
> > dev@kafka.apache.org>>
> > > > > wrote:
> > > > > >      > > > > >>>
> > > > > >      > > > > >>> Thanks, Harish!
> > > > > >      > > > > >>>
> > > > > >      > > > > >>> +1 (binding)
> > > > > >      > > > > >>>
> > > > > >      > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <
> > > > > >      > mjsax@apache.org <ma...@apache.org>>
> > > > > >      > > > > >> 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
> > > > >
> > > > >
> > > >
> >
> 

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Harish Vishwanath <ha...@gmail.com>.
Thank you, I will work on those.

Regards,
Harish


On Thu, Dec 18, 2025 at 8:30 AM Mickael Maison <mi...@gmail.com>
wrote:

> 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
> <ha...@gmail.com> 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 <fe...@gmail.com>
> > 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 <mj...@apache.org>
> 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
> > > > > <harish.shastry@gmail.com <ma...@gmail.com>>
> 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 <
> > > > >     dev@kafka.apache.org <ma...@kafka.apache.org>> 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
> > > > >     <apoorvmittal10@gmail.com <ma...@gmail.com>>
> > > > >      > 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 <
> > > mumrah@gmail.com
> > > > >     <ma...@gmail.com>> 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
> > > > >     <chia7712@gmail.com <ma...@gmail.com>>
> > > > >      > > 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 <dev@kafka.apache.org
> > > > >     <ma...@kafka.apache.org>> 於 2025年12月12日 下午2:48
> > > > >      > 寫道:
> > > > >      > > > > >
> > > > >      > > > > > +1 (binding). Thanks for driving this, Harish!
> > > > >      > > > > >
> > > > >      > > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
> > > > >      > > > > mickael.maison@gmail.com <mailto:
> mickael.maison@gmail.com
> > > >>
> > > > >      > > > > >> 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
> > > > >      > > > > >>> <dev@kafka.apache.org <mailto:
> dev@kafka.apache.org>>
> > > > wrote:
> > > > >      > > > > >>>
> > > > >      > > > > >>> Thanks, Harish!
> > > > >      > > > > >>>
> > > > >      > > > > >>> +1 (binding)
> > > > >      > > > > >>>
> > > > >      > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <
> > > > >      > mjsax@apache.org <ma...@apache.org>>
> > > > >      > > > > >> 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
> > > >
> > > >
> > >
>

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Mickael Maison <mi...@gmail.com>.
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
<ha...@gmail.com> 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 <fe...@gmail.com>
> 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 <mj...@apache.org> 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
> > > > <harish.shastry@gmail.com <ma...@gmail.com>> 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 <
> > > >     dev@kafka.apache.org <ma...@kafka.apache.org>> 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
> > > >     <apoorvmittal10@gmail.com <ma...@gmail.com>>
> > > >      > 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 <
> > mumrah@gmail.com
> > > >     <ma...@gmail.com>> 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
> > > >     <chia7712@gmail.com <ma...@gmail.com>>
> > > >      > > 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 <dev@kafka.apache.org
> > > >     <ma...@kafka.apache.org>> 於 2025年12月12日 下午2:48
> > > >      > 寫道:
> > > >      > > > > >
> > > >      > > > > > +1 (binding). Thanks for driving this, Harish!
> > > >      > > > > >
> > > >      > > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
> > > >      > > > > mickael.maison@gmail.com <mailto:mickael.maison@gmail.com
> > >>
> > > >      > > > > >> 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
> > > >      > > > > >>> <dev@kafka.apache.org <ma...@kafka.apache.org>>
> > > wrote:
> > > >      > > > > >>>
> > > >      > > > > >>> Thanks, Harish!
> > > >      > > > > >>>
> > > >      > > > > >>> +1 (binding)
> > > >      > > > > >>>
> > > >      > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <
> > > >      > mjsax@apache.org <ma...@apache.org>>
> > > >      > > > > >> 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
> > >
> > >
> >

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Harish Vishwanath <ha...@gmail.com>.
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 <fe...@gmail.com>
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 <mj...@apache.org> 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
> > > <harish.shastry@gmail.com <ma...@gmail.com>> 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 <
> > >     dev@kafka.apache.org <ma...@kafka.apache.org>> 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
> > >     <apoorvmittal10@gmail.com <ma...@gmail.com>>
> > >      > 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 <
> mumrah@gmail.com
> > >     <ma...@gmail.com>> 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
> > >     <chia7712@gmail.com <ma...@gmail.com>>
> > >      > > 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 <dev@kafka.apache.org
> > >     <ma...@kafka.apache.org>> 於 2025年12月12日 下午2:48
> > >      > 寫道:
> > >      > > > > >
> > >      > > > > > +1 (binding). Thanks for driving this, Harish!
> > >      > > > > >
> > >      > > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
> > >      > > > > mickael.maison@gmail.com <mailto:mickael.maison@gmail.com
> >>
> > >      > > > > >> 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
> > >      > > > > >>> <dev@kafka.apache.org <ma...@kafka.apache.org>>
> > wrote:
> > >      > > > > >>>
> > >      > > > > >>> Thanks, Harish!
> > >      > > > > >>>
> > >      > > > > >>> +1 (binding)
> > >      > > > > >>>
> > >      > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <
> > >      > mjsax@apache.org <ma...@apache.org>>
> > >      > > > > >> 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
> >
> >
>

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Federico Valeri <fe...@gmail.com>.
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 <mj...@apache.org> 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
> > <harish.shastry@gmail.com <ma...@gmail.com>> 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 <
> >     dev@kafka.apache.org <ma...@kafka.apache.org>> 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
> >     <apoorvmittal10@gmail.com <ma...@gmail.com>>
> >      > 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 <mumrah@gmail.com
> >     <ma...@gmail.com>> 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
> >     <chia7712@gmail.com <ma...@gmail.com>>
> >      > > 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 <dev@kafka.apache.org
> >     <ma...@kafka.apache.org>> 於 2025年12月12日 下午2:48
> >      > 寫道:
> >      > > > > >
> >      > > > > > +1 (binding). Thanks for driving this, Harish!
> >      > > > > >
> >      > > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
> >      > > > > mickael.maison@gmail.com <ma...@gmail.com>>
> >      > > > > >> 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
> >      > > > > >>> <dev@kafka.apache.org <ma...@kafka.apache.org>>
> wrote:
> >      > > > > >>>
> >      > > > > >>> Thanks, Harish!
> >      > > > > >>>
> >      > > > > >>> +1 (binding)
> >      > > > > >>>
> >      > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <
> >      > mjsax@apache.org <ma...@apache.org>>
> >      > > > > >> 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
>
>

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by "Matthias J. Sax" <mj...@apache.org>.
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 
> <harish.shastry@gmail.com <ma...@gmail.com>> 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 <
>     dev@kafka.apache.org <ma...@kafka.apache.org>> 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
>     <apoorvmittal10@gmail.com <ma...@gmail.com>>
>      > 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 <mumrah@gmail.com
>     <ma...@gmail.com>> 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
>     <chia7712@gmail.com <ma...@gmail.com>>
>      > > 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 <dev@kafka.apache.org
>     <ma...@kafka.apache.org>> 於 2025年12月12日 下午2:48
>      > 寫道:
>      > > > > >
>      > > > > > +1 (binding). Thanks for driving this, Harish!
>      > > > > >
>      > > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
>      > > > > mickael.maison@gmail.com <ma...@gmail.com>>
>      > > > > >> 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
>      > > > > >>> <dev@kafka.apache.org <ma...@kafka.apache.org>> wrote:
>      > > > > >>>
>      > > > > >>> Thanks, Harish!
>      > > > > >>>
>      > > > > >>> +1 (binding)
>      > > > > >>>
>      > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <
>      > mjsax@apache.org <ma...@apache.org>>
>      > > > > >> 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


Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by David Arthur <mu...@gmail.com>.
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 <ha...@gmail.com>
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 <
> dev@kafka.apache.org> 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 <ap...@gmail.com>
> > 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 <mu...@gmail.com> 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 <ch...@gmail.com>
> > > 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 <de...@kafka.apache.org> 於 2025年12月12日 下午2:48
> > 寫道:
> > > > > >
> > > > > > +1 (binding). Thanks for driving this, Harish!
> > > > > >
> > > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
> > > > > mickael.maison@gmail.com>
> > > > > >> 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
> > > > > >>> <de...@kafka.apache.org> wrote:
> > > > > >>>
> > > > > >>> Thanks, Harish!
> > > > > >>>
> > > > > >>> +1 (binding)
> > > > > >>>
> > > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <
> > mjsax@apache.org>
> > > > > >> 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

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Harish Vishwanath <ha...@gmail.com>.
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 <
dev@kafka.apache.org> 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 <ap...@gmail.com>
> 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 <mu...@gmail.com> 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 <ch...@gmail.com>
> > 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 <de...@kafka.apache.org> 於 2025年12月12日 下午2:48
> 寫道:
> > > > >
> > > > > +1 (binding). Thanks for driving this, Harish!
> > > > >
> > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
> > > > mickael.maison@gmail.com>
> > > > >> 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
> > > > >>> <de...@kafka.apache.org> wrote:
> > > > >>>
> > > > >>> Thanks, Harish!
> > > > >>>
> > > > >>> +1 (binding)
> > > > >>>
> > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <
> mjsax@apache.org>
> > > > >> 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
> > >
> >
>

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Muralidhar Basani via dev <de...@kafka.apache.org>.
Hi Harish,
Great effort and a nice initiative.

+1 (non-binding)

Regards,
Murali

On Fri, Dec 12, 2025 at 7:40 PM Apoorv Mittal <ap...@gmail.com>
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 <mu...@gmail.com> 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 <ch...@gmail.com>
> 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 <de...@kafka.apache.org> 於 2025年12月12日 下午2:48 寫道:
> > > >
> > > > +1 (binding). Thanks for driving this, Harish!
> > > >
> > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
> > > mickael.maison@gmail.com>
> > > >> 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
> > > >>> <de...@kafka.apache.org> wrote:
> > > >>>
> > > >>> Thanks, Harish!
> > > >>>
> > > >>> +1 (binding)
> > > >>>
> > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <mj...@apache.org>
> > > >> 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
> >
>

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Apoorv Mittal <ap...@gmail.com>.
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 <mu...@gmail.com> 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 <ch...@gmail.com> 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 <de...@kafka.apache.org> 於 2025年12月12日 下午2:48 寫道:
> > >
> > > +1 (binding). Thanks for driving this, Harish!
> > >
> > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
> > mickael.maison@gmail.com>
> > >> 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
> > >>> <de...@kafka.apache.org> wrote:
> > >>>
> > >>> Thanks, Harish!
> > >>>
> > >>> +1 (binding)
> > >>>
> > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <mj...@apache.org>
> > >> 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
>

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by David Arthur <mu...@gmail.com>.
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 <ch...@gmail.com> 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 <de...@kafka.apache.org> 於 2025年12月12日 下午2:48 寫道:
> >
> > +1 (binding). Thanks for driving this, Harish!
> >
> >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
> mickael.maison@gmail.com>
> >> 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
> >>> <de...@kafka.apache.org> wrote:
> >>>
> >>> Thanks, Harish!
> >>>
> >>> +1 (binding)
> >>>
> >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <mj...@apache.org>
> >> 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

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Chia-Ping Tsai <ch...@gmail.com>.
+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 <de...@kafka.apache.org> 於 2025年12月12日 下午2:48 寫道:
> 
> +1 (binding). Thanks for driving this, Harish!
> 
>> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <mi...@gmail.com>
>> 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
>>> <de...@kafka.apache.org> wrote:
>>> 
>>> Thanks, Harish!
>>> 
>>> +1 (binding)
>>> 
>>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <mj...@apache.org>
>> 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
>>>>> 
>>>> 
>> 

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by David Jacot via dev <de...@kafka.apache.org>.
+1 (binding). Thanks for driving this, Harish!

On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <mi...@gmail.com>
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
> <de...@kafka.apache.org> wrote:
> >
> > Thanks, Harish!
> >
> > +1 (binding)
> >
> > On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <mj...@apache.org>
> 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
> > > >
> > >
>

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Mickael Maison <mi...@gmail.com>.
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
<de...@kafka.apache.org> wrote:
>
> Thanks, Harish!
>
> +1 (binding)
>
> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <mj...@apache.org> 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
> > >
> >

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by Lucas Brutschy via dev <de...@kafka.apache.org>.
Thanks, Harish!

+1 (binding)

On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <mj...@apache.org> 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
> >
>

Re: [VOTE]: KIP 1133 - Cut over to markdown based AK Website

Posted by "Matthias J. Sax" <mj...@apache.org>.
+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
>