4 ms·
> I really like scheme. Strongly in favour of prefix notation. Still cannot imagine having the patience to write significant amounts of prose in this layout Th
by neilv 2y ago
> I really like scheme. Strongly in favour of prefix notation. Still cannot imagine having the patience to write significant amounts of prose in this layout
The Racket people made a Scheme-based documentation formatter, called "Scribble", which includes a specialized syntax that's much more amenable to writing natural language text than s-expressions are:
https://docs.racket-lang.org/scribble/
All/most of the Racket documentation is written using Scribble now.
I started writing a book about Racket using Scribble, so of course needed an Emacs mode:
https://www.neilvandyke.org/scribble-emacs/
I've also adapted Scribble for API documentation embedded in source code. (After previously doing embedded TexInfo. Though, if I ever return to Scheme, I currently want to switch the embedded docs to Markdown, simply because lately I'm trying to promote a pragmatic, lightweight "Markdown everywhere" for software developers.)