Hi Volkan, On Wed, 8 May 2024 at 14:57, Volkan Yazıcı <vol...@yazi.ci> wrote: > In my opinion, > > - Being able to view `target/site` with just using my browser and > nothing else is super convenient. The development experience is much > smoother.
If we use a non-default `html_extension_style`, you can still preview the website locally. You just need to modify the Antora Playbook (AFAIK Antora does not support variable substitution in the playbook). We can also set `html_extension_style: default` in our Git repo and configure the CI to modify it when it builds the staging site. I usually use my IDE to preview the documentation pages, so for me it is not a problem. Anyway I value consistency more than one particular solution. If we prefer to stick with the `default` style, for SEO purposes we should ensure that all our internal links end up in `.html`. This mainly applies to index files. Piotr
