4 ms·

Pollen, written in Racket, is arguably a "dsl for specifying ssgs" https://docs.racket-lang.org/pollen/ https://docs.racket-lang.org/pollen/

• 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 ago
    This 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 ago
    Don't mess around with Markdown and LaTeX for documentation. AsciiDoc is what you want.
    • rodolphoarruda 6y ago
      Your post changed my life. Thanks for sharing this about AsciiDoc. It's such a nice tool.