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
>