ryanmadden
Joined 11 years ago
Karma
73
Submissions
5
Member since
May 6
Recent submissions
Comment · 3 hours ago
(Author) I did this on the 'Plus' plan over a series of 5h quota segments so $20 for me, but at API pricing the tokens would have been $52
Comment · 1 year ago
In my experience, organization/clarity is the biggest hurdle for SWEs trying to improve their doc writing. I like the author's spaghetti code analogy for the importance of idea organization within a doc -- I've struggled to convey the same concept before and I will use this in the future. In the past I've talked about 'ferrying' the reader through your thought process but this post explains the concept in a more familiar way.
I wrote a similar post last year[0] and it was interesting to see the similarities (concision, importance of practice) and differences with someone from a different company. I'm not sure I agree about 'short paragraphs' -- that may be a natural consequence of high information density writing but line breaks themselves aren't much help if the ideas aren't distilled. The 'Editing' section gets at that underlying idea more directly imo.
[0]https://ryanmadden.net/things-i-learned-at-google-design-doc...
Comment · 6 years ago
Reminds me of a parody startup generator I made years ago :) [0].
The ideas that reference a specific other company or niche are good but for more abstract prompts (e.g. "Consider the human desire for power. How could you use technology to take out steps?") I've found it's harder to get a meaningful brainstorm started.