@peter thanks! Oooh, Telescopic text is cool, I don’t remember seeing it before.
I get the FOMO aspect. 🤔 I think I’ve come to terms with the fact that there’s ALWAYS more to learn. We’re sort of always implicitly picking our depth anyway, but this makes it explicit.
Lots more to ponder here. Thanks again!
Alright ruby folks -- who's building apps in the open? Anyone sharing videos on YouTube or streaming as they build?
Would love to subscribe to more Youtube channels sharing in-progress and open work!
Boosts of this appreciated! 😄️
And will happily boost those who are looking to widen their audience
@jqr TYSM for the feedback!
Too-many breakpoints is definitely a concern. I think even 2 breakpoints is an improvement over a single doc. "ELI5" and "Gory details" beats some docs straddling the line. 3 may very well be the sweet spot.
I published a video about a new kind of documentation: I'm calling it Cognitive Breakpoints, and I'd love to hear your thoughts.
✍️ is challenging because want to communicate a lot of detail to audiences of different backgrounds w/o overwhelming them.
📖 is hard because the author often made assumptions about what know or how deep you want to go.
What if the same document had N levels of depth so the reader could choose how deep they wanted to get into the details?
Joel