Quarto for products documentation

[jpecquais]

Hello there,

I've been recently evaluating Quarto for migrating a docsify doc to quarto. To give you some context, we have a page (doc.flux.audio), that host all our product documentation and it's generated from one GitHub repository.

So, I've started to look at how I could structured this with quarto. Apparently, each product documentation could be one book, which provide both html and pdf output : great!

But we also need some kind of landing page that redirect to the different books. This were I struggle to find the most elegant way to do this. I've tried to have books project inside a website project, but I quickly understand that it is not supported by quarto. Another solution I've tried is to have a website project that build its navbar from the html files generated by the other books project. It works, but it makes the whole doc a bit more tedious to build. I've also tried the new feature in Quarto 1.3 that allows to have an alternate render, but as we have several several markdown files per product documentation, it generate multiple pdf which is not ideal.

I've red through most of the quarto documentation, including profiles and variables, but at this point, I haven't seen how it could help me.

Do you have any advices on how to handle this use case the best ? Thank you !