miniblog.

I'm increasingly persuaded that a page-per-function organisation of docs is the best. For example, this command in Redis has its own page: https://redis.io/commands/acl-cat/ Using a whole page enables you to have several examples without overwhelming the reader.

I often use Quip for writing documents and I've started using Google Slides for presentations. They have fewer features than competing tools, but I like them. They have what I need, without being overwhelming. Maybe it takes a paradigm shift (e.g. desktop->web) to drop features.

Here's an IDE feature I think should exist: A *random* file finder! Rather than doing a range of static analyses (typical lint issue count, typical number of functions per file), just randomly sample! It's less overwhelming and prevents recent feature bias to code cleanliness.