Conversation

Sage Griffin

@sgrif

·

Dec 15, 2017

Things I want from a documentation tool in 2017: - Uses markdown - Generates links from module paths - Executes code examples as tests - Has mechanisms to share setup code for those examples - Provides fuzzy search Rust has 1, 2, 3, 5. Any langs better that I should know about?

8

15

46

Brendan Zabarauskas

@brendanzab

Replying to

@sgrif

As a completely left-of-field thing,

@racketlang

's Scribble tool is very impressive. Does 2, 3, 4, but also allows for 'guide' style documentation and tutorials, and has nicely documented macros, and is beautifully typeset: https://docs.racket-lang.org/scribble/

11:26 PM · Dec 15, 2017·Twitter Web Client