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