There are lots of other articles about what's in an Amazon doc [0]. They're mostly accurate but it depends on the team quite a bit.
Comments are exactly what you'd expect from any doc comments. (what does this mean? who's the audience? does it scale? what are alternatives?) There are other links in the comments here with more examples if you're curious.
Most of the documents are shared via calendar invite. Lots of teams/products have team folders to collect docs centrally. Finding docs at Amazon has been the biggest gap IMO. There are too many places a document can exist and no way to centrally search them all.
Thank you very much for both your comment and link. This cleared things up for me.
It feels like an obvious oversight that there is not some company-wide Wiki to organize all of these docs. Since we are talking about Amazon/AWS, this has to be intentional. Can you speculate on why this gap exists?
Sadly the post skips over the format of these docs - is there a good resource for examples/templates of the different doc types (with comments?)?
Also, how are these documents shared and made discoverable internally? Do they refer to each other?