4 ms·
Designing Docs for Developers
- peter_l_downs 14y agoI'd be satisfied if most documentation looked more like stripe's: https://stripe.com/docs/api https://stripe.com/docs/api
- columbo 14y agoThat was... perfect. -> You send us X <- We give you Y Why is it so many api docs fail on this basic level?
- Androsynth 14y agonice top-level categories. Too many doc pages can't even correctly do something that simple. One thing I hate is fixed headers. If I'm scrolling down the page, I want to read whats on the page, not have you shove your branding down my throat while also reducing the amount of content on my screen. If your stuff is good, i'll happily scroll up and click on your stuff, but don't force it on me (this is a problem with blogs too).