The IDE lets you view the page you are editing but generally it doesn’t show you the nav or the rest of the site. I am also not confident that everything will be styled exactly the same as it will appear in the browser. So, in short, the IDE is great for editing but I like to do my reviews on a local site.
Ralph > On May 8, 2024, at 9:50 AM, Piotr P. Karwasz <piotr.karw...@gmail.com> wrote: > > 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