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 when

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 when commonmark -> s-expressions or XML or HTML is readily available. (item [Packages are available to produce: ,(ref :skribe %user-sui :ident "slides" :text [slides]) (overhead transparencies), ,(ref :skribe %user-sui :ident "pie-charts" :text [pie charts]), ,(ref :skribe %user-sui :ident "equations" :text [equation formatting]), ,(ref :skribe %user-sui :ident "programs" :text [syntax highlighting of computer programs]), and others.]) The signal to noise there is not good enough to compete. There's way too much repetition of annotation words. The links to markup language and the simpler syntax were expected to tell me what the syntax is, not what a markup language is. Maybe the simpler syntax is more workable - the page doesn't show what that looks like. edit found it in the docs, looks a lot more like markdown. https://www.nongnu.org/skribilo/doc/user-3.html#skribe-syntax https://www.nongnu.org/skribilo/doc/user-3.html#skribe-synta..., can't seem to link to the subheading. So maybe this is a good thing with a landing page that drives newcomers away? Quite on brand for scheme if so.

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.)

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.)