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.
That's obviously not a position we wish to take on our documentation. It hinders proper support of the software and wastes everyone's time.
-Chad
On Jul 3, 2009 9:11 AM, "Thibaut DEVERAUX" thibaut.deveraux@gmail.com wrote:
Sorry for double mail; Can we imagine a search motor that can look into : 1 - The mailing lists where users can ask questions 2 - The main forums 3 - The main site with documentation (mediawiki.org and sites such as semantic-mediawiki) 4 - ...
Google can does 2 and 3, I don't know about 1.
There is also layers that goes more work than a simple personalised google.
2009/7/3 Thibaut DEVERAUX thibaut.deveraux@gmail.com
What about a search motor wich can find information into thoose mailings ? This is not a "solut...
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
wikitech-l@lists.wikimedia.org