Re: [DISCUSS] New Documentation Website

[Xiao Liu <li...@apache.org>]

+1

Great work! It looks much more modern. Previously, the book pages seemed to support direct PDF export[1]. Will replacing the website affect this functionality?

[1]: https://hbase.apache.org/apache_hbase_reference_guide.pdf

On 2026/01/22 12:24:05 Yurii Palamarchuk wrote:
> Hi Team,
> 
> As discussed earlier here https://lists.apache.org/thread/0ojmobpnyk44lbghqxh2c231c3bm6t6t
> I’m presenting the new documentation website. You can check this out here:
> https://hbase-landing.vercel.app/docs/
> 
> What’s been done:
> - Converted all asciidoc files to mdx (extended markdown). 99% of the content preserved, checked it manually multiple times.
> - Multi-page by default, single-page as an alternative option for those who got used to it.
> - Multi-page has a powerful search. The whole website is static and pre-rendered at a build time.
> - “Edit on GitHub” button is at the bottom of each section that leads directly to the source of the section. Doesn’t work in the demo website because it leads to the original repo, and the change is not merged yet.
> - Dark mode support.
> - The UI now looks modern and beautiful, the user/dev experience is improved significantly.
> - The landing page and documentation are now one application.
> 
> Waiting for your feedback!
> 
> Regards,
> Yurii
> 
> 

Re: [DISCUSS] New Documentation Website

[Yurii Palamarchuk <yu...@cloudera.com>]

Thanks for the review Xiao. There is no direct PDF export, so I will have
to look for a way to do it. I added a script that can export the docs as
PDF, but it's not ideal and doesn't look like a proper book. I will look
for a potential replacement for this. Nice catch, thanks.

On Mon, Feb 2, 2026 at 4:22 AM Xiao Liu <li...@apache.org> wrote:

> +1
>
> Great work! It looks much more modern. Previously, the book pages seemed
> to support direct PDF export[1]. Will replacing the website affect this
> functionality?
>
> [1]: https://hbase.apache.org/apache_hbase_reference_guide.pdf
>
> On 2026/01/22 12:24:05 Yurii Palamarchuk wrote:
> > Hi Team,
> >
> > As discussed earlier here
> https://lists.apache.org/thread/0ojmobpnyk44lbghqxh2c231c3bm6t6t
> > I’m presenting the new documentation website. You can check this out
> here:
> > https://hbase-landing.vercel.app/docs/
> >
> > What’s been done:
> > - Converted all asciidoc files to mdx (extended markdown). 99% of the
> content preserved, checked it manually multiple times.
> > - Multi-page by default, single-page as an alternative option for those
> who got used to it.
> > - Multi-page has a powerful search. The whole website is static and
> pre-rendered at a build time.
> > - “Edit on GitHub” button is at the bottom of each section that leads
> directly to the source of the section. Doesn’t work in the demo website
> because it leads to the original repo, and the change is not merged yet.
> > - Dark mode support.
> > - The UI now looks modern and beautiful, the user/dev experience is
> improved significantly.
> > - The landing page and documentation are now one application.
> >
> > Waiting for your feedback!
> >
> > Regards,
> > Yurii
> >
> >
>