top | item 23913954

(no title)

jwilkinson9 | 5 years ago

Are there any great examples of how Amazon writes their white papers? I've heard of the Press Release method, but are there any examples online? Also curious if there are white papers that don't fit the Press Release model.

discuss

order

bobthepanda|5 years ago

Here's an AWS article explaining how root cause analysis is done at Amazon: https://aws.amazon.com/elasticsearch-service/resources/artic...

> The technique consists of asking the question “Why?” iteratively until you get to the root of the problem. Let’s see a quick example:

Problem: The website is showing error 500.

1. Why? Because the web framework’s routing component malfunctioned.

2. Why? Because it requires another component, which itself malfunctioned.

3. Why? Because this component of the web framework requires the intl extension, which isn’t working.

4. Why? Because it was accidentally deactivated after the server software got updated.

swyx|5 years ago

worth noting that there are reasonable criticisms of the 5 why's method. complex system failures often do not have a single root cause.