3 ms·
Sure - something I've been wanting to do for a while. I just wrote a Medium post, as I think it's a longer topic than HN comments are optimized for. Please tak
by sib 8y ago
Sure - something I've been wanting to do for a while. I just wrote a Medium post, as I think it's a longer topic than HN comments are optimized for.
Please take a read and let me know whether it's helpful.
https://medium.com/@sib1013/writing-docs-at-amazon-e025808616bd https://medium.com/@sib1013/writing-docs-at-amazon-e02580861...
- sandGorgon 8y agoThis is super helpful ! Is there a format that you can create/share ? Like - is it like a spec (with "goal", "stakeholders", stuff like that). I'm betting it's not ...and that's makes this a little hard to get started on. You guys had the benefit of looking at your peers' work - what would be a good two pager that we can learn from ?
- sib 8y agoThanks! It's less a spec and more of, choose the tool that fits the job. A lot of these documents fit the overall structure of "high-level situation & recommendation; industry / product / customer context; more depth on recommendations considered; FAQ" I don't have any examples, anymore (I left Amazon some years ago), but here are a couple of links that have reasonable takes on the structure and guidelines: https://www.anecdote.com/2018/05/amazons-six-page-narrative-structure/ https://www.anecdote.com/2018/05/amazons-six-page-narrative-... https://use-cases.org/2018/01/03/the-evil-genius-of-the-amazon-six-page-narrative/ https://use-cases.org/2018/01/03/the-evil-genius-of-the-amaz... https://www.geekwire.com/2017/prepared-6-page-memo-geekwire-summit-session-amazons-jeff-wilke-please-read-silently/ https://www.geekwire.com/2017/prepared-6-page-memo-geekwire-... Bottom line: the purpose of the document is to drive a high-quality decision, so include what will help, and leave out anything extraneous. (I know, that's not very actionable.)