You have also AsciiDoctor ( https://asciidoctor.org/ ) which is alive and well. I am using it for technical CS documentation internally, but only for single page documents. I did not try to deploy their whole multi-document setup called Antora ( https://antora.org/ ). - Source: Hacker News / 4 months ago

Well scaffolding an extension also generates a docs module wich leverages Antora, and with a minimal effort, we can produce a nice and clean documentation. - Source: dev.to / 7 months ago

AsciiDoc has a bit more features compared to Markdown which allows for a richer presentation of the docs. Biggest difference is that Linode has the docs in a separate repository. Not sure if it is a limitation of their toolchain or a deliberate decision. Antora allows you to have the project documentation in the actual project repositories. It then pulls the docs from all the different repos together to build the... - Source: Hacker News / 11 months ago

I've been pushing for Antora everywhere I go. It allows you to keep text-based (AsciiDoc, similar to markdown but an actual standard) documentation with your repositories and from that build a central documentation portal site. Source: about 1 year ago

We use AsciiDoc for our technical documentation, and it's great. Last year we moved from AsciiDoctor to Antora [1] and I can't recommend it enough. [1] https://antora.org/. - Source: Hacker News / over 1 year ago

"But it's surprisingly challenging to publish books on the web in nice, cohesive, tight, easy-to-navigate HTML format." Quarto is one great option for doing that today. Bonus: it can also generate EPUBs and PDFs, all from one set of source files. https://quarto.org/ It's free and open source. https://github.com/quarto-dev/quarto-cli https://jjallaire.github.io/hopr/. - Source: Hacker News / about 18 hours ago

I've used Quarto[1] to build a personal blog and it has been really easy and straightforward. Especially if you want to run some code alongside the post (like Python, R, or Julia). As far as I know, you can also use it to write books and presentations. [1]: https://quarto.org/. - Source: Hacker News / 6 days ago

> Interactive examples have been added to the documentation, allowing users to run the examples locally on embedded Jupyterlite notebooks in their browser. This might sound strange, but to me this is the most exciting thing listed in the update document. I've been looking for ways to include _interactive_ Python scripts on static webpages (such as those made using Jupyter Book [1] or Quarto [1]. Up to now the only... - Source: Hacker News / about 2 months ago

Deckset was the OG in this space, which I used a decade (!) ago in college. Looks like they moved off the Mac App Store, and are bringing out an iOS app now: https://www.deckset.com Now I much prefer something like https://quarto.org with dataviz. - Source: Hacker News / 3 months ago

To mirror another comment: I really like the concept and will give it a try. As an alternative, I want to suggest [Quarto](https://quarto.org) - somewhat similar, easy to use, one might even call it "basic" (I mean that in a good way!) 7/5 ^^. - Source: Hacker News / 3 months ago