Chad schrieb:
I'm not sure what you're proposing here. I think the primary problem isn't "where are the docs?" but rather "how good are the docs?"
A great example came up in #mediawiki a few days ago. A user asked about using pretty urls relative to their document root (ie: example.com/Page). A good number of us gave the typical line about it being broken and to not use it. Upon further discussion, it became more clear that this idea was not broken due to huge issues in Mediawiki itself, but rather that's what the docs said so we just treated it as fact.
The idea is broken not due to technical problems, but due to conceptual problems, malely namespace pollution. mixing two different things (files and wiki pages) in the same namespace is a bad thing. it can be done, but it often leads to problems. This is why the documentation recommends against it. But the documentation also tells you how to do it.
-- daniel