I would like to make two initial assumptions.
- Clearly written and explicit documentation saves time.
- Programmer time is usually the most expensive component in a software project.
As an example of assumption #1, if documentation clearly states expected behaviour of an application, then a programmer would not need to expend the time and effort necessary to draft a test of the application to discover how it actually works.
As to assumption #2. I do not offer any specific examples, yet at university this is a prevailing notion.
In the Help Center > Asking, it states that
"Stack Overflow is for professional and enthusiast programmers ... if your question generally covers ... software tools commonly used by programmers; and is a practical, answerable problem that is unique to software development."
Furthermore, in the Help Center > Asking "How do I ask a good question," it states
"Pretend you're talking to a busy colleague."
So, if we agree that my two assumptions above are most often true, and that StackOverflow exists in part for (potentially) busy professional programmers, then are questions that clarify documentation indeed welcomed on this site?