Hacker News new | ask | show | jobs
by threepio 1937 days ago
Pollen, written in Racket, is arguably a "dsl for specifying ssgs"

https://docs.racket-lang.org/pollen/

1 comments

Pollen seems so incredibly cool and powerful, but every time I have tried to play around with it, I get distracted by small quirks and areas that I wish were documented more clearly, or in a more organized format.

My daydream is to make a _good_ technical documentation system with it that is usable by the everyman, but it's still just a bit too much of a stretch. Markdown + pandoc + LaTeX templates get close, but LaTeX templating is a nightmare, and markdown is far too limiting and lacks expressivity (without ad-hoc DSL's slapped on top).

If anyone has a good pollen tutorial or example repo, I'd _love_ to know of it.

This is a sample Pollen project, annotated by the author using Racket's literate-programming dialect.

https://docs.racket-lang.org/pollen-tfl/

Don't mess around with Markdown and LaTeX for documentation. AsciiDoc is what you want.
Your post changed my life. Thanks for sharing this about AsciiDoc. It's such a nice tool.