Nice!
Thanks for the holiday gift, Harish and David!
-Matthias
On 12/17/25 1:33 PM, David Arthur wrote:
Just a quick note, we have made the following changes in kafka-site
* Default branch is now "markdown" (PRs should target this branch)
* asf-site has been updated with the Hugo-built site
* Any new commits to "markdown" branch are automatically deployed to
asf-staging (https://kafka.staged.apache.org/ <https://
kafka.staged.apache.org/>)
* "Build and Deploy" workflow can be manually run to update the live
website (see screenshot)
image.png
We have not yet merged the markdown changes to the Kafka release
branches, though expect that to happen soon.
So, in other words, we are live!
-David A
On Fri, Dec 12, 2025 at 7:49 PM Harish Vishwanath
<[email protected] <mailto:[email protected]>> wrote:
Thank you all for the support. The proposal to cutover has been accepted
with 7 binding (Matthias J. Sax, Lucas Brutschy, David Jacot, Mickael
Maison, Chia-Ping Tsai, David Arthur, Apoorv Mittal) and 1 non-binding
(Muralidhar Basani) votes.
I will work on the next steps and complete this effort at the earliest.
Regards,
Harish
On Fri, Dec 12, 2025 at 10:57 AM Muralidhar Basani via dev <
[email protected] <mailto:[email protected]>> wrote:
> Hi Harish,
> Great effort and a nice initiative.
>
> +1 (non-binding)
>
> Regards,
> Murali
>
> On Fri, Dec 12, 2025 at 7:40 PM Apoorv Mittal
<[email protected] <mailto:[email protected]>>
> wrote:
>
> > Hi Harish,
> > Thanks for the KIP, this is a massive effort. A lot has been
achieved
> with
> > automation and continuous efforts.
> >
> > I am in favour of the cutover and fixing some rough edges with
older
> > versions.
> >
> > +1 (binding)
> >
> > Regards,
> > Apoorv Mittal
> >
> >
> > On Fri, Dec 12, 2025 at 2:07 PM David Arthur <[email protected]
<mailto:[email protected]>> wrote:
> >
> > > From the time I first wrote any docs for Kafka, I wondered
"why are we
> > > editing HTML like we are in the 2000s?" :)
> > >
> > > This has been a long time coming and will be a major quality
of life
> > > improvement for committers and contributors alike.
> > >
> > > Thanks for driving this, Harish.
> > >
> > > +1 binding
> > >
> > > -David A
> > >
> > > On Fri, Dec 12, 2025 at 3:07 AM Chia-Ping Tsai
<[email protected] <mailto:[email protected]>>
> > wrote:
> > >
> > > > +1 (binding)
> > > >
> > > > Out of curiosity. Why was 3.5 chosen as the baseline? Is
3.5 a kind
> of
> > > > lucky number?
> > > >
> > > > > David Jacot via dev <[email protected]
<mailto:[email protected]>> 於 2025年12月12日 下午2:48
> 寫道：
> > > > >
> > > > > +1 (binding). Thanks for driving this, Harish!
> > > > >
> > > > >> On Thu, Dec 11, 2025 at 12:02 PM Mickael Maison <
> > > > [email protected] <mailto:[email protected]>>
> > > > >> wrote:
> > > > >>
> > > > >> Hi,
> > > > >>
> > > > >> Thanks for contributing this!
> > > > >> There are still a few rough edges but the from a quick
browse it
> > > > >> already looks really good.
> > > > >>
> > > > >> Really happy we managed to keep the rotating Apache logo
Easter
> egg
> > > > >>
> > > > >> +1 (binding)
> > > > >>
> > > > >> Thanks,
> > > > >> Mickael
> > > > >>
> > > > >>> On Thu, Dec 11, 2025 at 10:22 AM Lucas Brutschy via dev
> > > > >>> <[email protected] <mailto:[email protected]>> wrote:
> > > > >>>
> > > > >>> Thanks, Harish!
> > > > >>>
> > > > >>> +1 (binding)
> > > > >>>
> > > > >>> On Thu, Dec 11, 2025 at 7:50 AM Matthias J. Sax <
> [email protected] <mailto:[email protected]>>
> > > > >> wrote:
> > > > >>>>
> > > > >>>> +1 (binding)
> > > > >>>>
> > > > >>>> Thanks a ton(!) for all the efforts on this Harish. It's a
> > mountain
> > > to
> > > > >>>> be moved to make this happen, and I am very happy to
see this
> > going
> > > > >> over
> > > > >>>> the finish line.
> > > > >>>>
> > > > >>>> Also call out to David Arthur, for his outstanding
support!
> > > > >>>>
> > > > >>>> The bug-bash we did was great, but it's the nature of
web-pages
> to
> > > > >>>> literally always have some errors. So I am totally in
favor to
> > just
> > > > >> make
> > > > >>>> the switch, and avoid chasing a moving target. For 4.1
and older
> > > > >>>> releases, docs should be stable, and if we cut over
now, we can
> > just
> > > > >>>> fix-forward anything for upcoming 4.2 release, so I
think it's
> > > pretty
> > > > >>>> good timing to do to now IMHO. The release will force us
> naturally
> > > to
> > > > >>>> check docs, and find issue.
> > > > >>>>
> > > > >>>>
> > > > >>>> -Matthias
> > > > >>>>
> > > > >>>> On 12/5/25 7:43 AM, Harish Vishwanath wrote:
> > > > >>>>> Hi all,
> > > > >>>>>
> > > > >>>>> Following the community review, I would like to call
for a vote
> > on
> > > > >> cutting
> > > > >>>>> over to markdown based AK website (KIP 1133). Fully
functional
> > site
> > > > >> is live
> > > > >>>>> on staging at https://kafka.staged.apache.org/
<https://kafka.staged.apache.org/>.
> > > > >>>>>
> > > > >>>>> If the Vote Passes:
> > > > >>>>>
> > > > >>>>> - I will migrate the source documentation in the docs
directory
> > of
> > > > >> the
> > > > >>>>> apache/kafka repository to Markdown for versions *3.5 and
> newer.*
> > > > >>>>> - Older versions (pre-3.5) will be left as-is (HTML)
in the
> kafka
> > > > >> repo to
> > > > >>>>> avoid disruption.
> > > > >>>>> - Update CI/CD deploy the markdown branch to the live
> production
> > > > >> site.
> > > > >>>>>
> > > > >>>>> For reference:
> > > > >>>>>
> > > > >>>>> - KIP 1133:
> > > > >>>>>
> > > > >>
> > > >
> > >
> >
> https://cwiki.apache.org/confluence/display/KAFKA/
KIP-1133%3A+AK+Documentation+and+Website+in+Markdown#KIP1133:AKDocumentationandWebsiteinMarkdown-AKwebsitedocumentation
<https://cwiki.apache.org/confluence/display/KAFKA/KIP-1133%3A+AK+Documentation+and+Website+in+Markdown#KIP1133:AKDocumentationandWebsiteinMarkdown-AKwebsitedocumentation>
> > > > >>>>> - Previous discussions:
> > > > >>>>>
> https://lists.apache.org/thread/yr5rqyx1d6lvyb9t9tbf26stsh214v4r
<https://lists.apache.org/thread/yr5rqyx1d6lvyb9t9tbf26stsh214v4r>
> > > > >>>>> - Markdown source for AK website: `markdown` branch at
> > > > >>>>> https://github.com/apache/kafka-site <https://
github.com/apache/kafka-site>
> > > > >>>>>
> > > > >>>>> Regards,
> > > > >>>>> Harish
> > > > >>>>>
> > > > >>>>
> > > > >>
> > > >
> > >
> > >
> > > --
> > > David Arthur
> > >
> >
>
--
David Arthur
