[Rapzid]

This is.. Odd. AWS is notoriously a black box. Their services aren't open source and on github; who would have the insider view necessary to work on the docs outside of their own employees? Is this easier than having an edit suggestion feature? Will PR's cause clashes with their technical writers?

[always_good]

You don't need system insight to improve docs. On one end of the spectrum, docs just need people to improve the language like typos, grammar, and sentence flow.

Also, docs map out the black box but end-users use the black box. They are in a position to find disparities between what the docs say and what the black box does. Like noticing the example response doesn't match the actual response.

Or that if you provide a stream to the API, you must provide a content length, yet this relationship is only marked as optional in the docs.

Maybe an engineer would have to double-check the code to verify the behavior, and that's great.