3 ms·
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 do
by mdtusz 6y ago
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.
- threepio 6y agoThis is a sample Pollen project, annotated by the author using Racket's literate-programming dialect. https://docs.racket-lang.org/pollen-tfl/ https://docs.racket-lang.org/pollen-tfl/
- pvorb 6y agoDon't mess around with Markdown and LaTeX for documentation. AsciiDoc is what you want.
- rodolphoarruda 6y agoYour post changed my life. Thanks for sharing this about AsciiDoc. It's such a nice tool.