Hacker News new | past | comments | ask | show | jobs | submit login

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.




Consider applying for YC's Summer 2025 batch! Applications are open till May 13

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: