Re:The Perks of a High-Documentation, Low-Meeting Work Culture
by fumar on Tuesday November 22, 2022 @12:30PM
(#33708372)
Amazon is high documentation, high meetings culture. The documentation is reviewed by peers, bar raisers, and leaders in a process called document read before being official.
[ Parent
| on HN ]
Re:The Perks of a High-Documentation, Low-Meeting Work Culture
by cateblanchett on Tuesday November 22, 2022 @12:30PM
(#33708379)
so the worst of both worlds
Re:The Perks of a High-Documentation, Low-Meeting Work Culture
by xenonite on Tuesday November 22, 2022 @12:44PM
(#33708533)
Why? I think this sounds great.
Re:The Perks of a High-Documentation, Low-Meeting Work Culture
by htrp on Tuesday November 22, 2022 @01:32PM
(#33709183)
Read an amazon 6 pager... then try to write one, about anything. and then invite all of your co-workers to pick apart every single line of your document.
Re:The Perks of a High-Documentation, Low-Meeting Work Culture
by fumar on Tuesday November 22, 2022 @01:51PM
(#33709473)
Correct. Be careful about sharing a document in progress, notes, or just simple thoughts in text. People will pick it apart word by word. Why? It is the culture Amazon created. Sometimes it helps sometimes it's a waste of everyone's time.
Re:The Perks of a High-Documentation, Low-Meeting Work Culture
by gregoriol on Tuesday November 22, 2022 @01:07PM
(#33708800)
If you are writing for reviews, you are not writing for your peers. The question is: who will be using the documents?
Re:The Perks of a High-Documentation, Low-Meeting Work Culture
by von_lohengramm on Tuesday November 22, 2022 @01:37PM
(#33709269)
Sure, but oftentimes technical documentation is severely lacking. PRFAQs, initial design docs, etc. are thoughtfully created and thoroughly reviewed, but the actual implementation lacks the documentation required to make onboarding (be it new team members or new dependent teams) as smooth as it could be. My favorite is finding an out of date Wiki page from 6 years ago that contains a partial list of API method names, descriptions if you're lucky, and then nothing else, not even a link to the service's AAA page/etc. or a high-level summary of what the service _does_ or _why_. With how many moving parts there are and how inaccessible non-platform-level documentation is, the new hire experience at Amazon can be rather daunting. Even SDE1/2s that are a year in often have a very incomplete picture of what's going on in their own domain space. Too much tribal knowledge.
Re:The Perks of a High-Documentation, Low-Meeting Work Culture
by FigmentEngine on Tuesday November 22, 2022 @01:37PM
(#33709276)
this statement needs some detail, "high meetings" is obscuring that meetings use the docs (not meetings with no agenda or lots of presentations). meeying use docs as the primary driver, be that a narrative or analysis of a dataset