When this launched I posted Will Documentation duplicate effort and waste resources? but my fears became naught: instead of sucking away the already scarce documentation efforts it became a wasteland. It looks like an MVP that a summer intern typed some examples into, some of it right, some of it wrong, shallow and useless. If Shog9 is right and it's about experimenting, well, the experiment ran its course and it's pretty much dead.
Drupal documentation, by and large simply doesn't exist onYou need to ask the platformwhy.
Looking atWhy do we answer on StackOverflow? There's the PHP topics popular topics are such hard to find"pay it forward" mechanism: today it's me who shares his knowledge, complicated information as "Getting started with PHP" and "Outputting the Value of a Variable"tomorrow it'll be you. There is a "functional programming" topic Also, often I do it for myself -- I figure out some obscure stuff that I do not need every day so I won't memorize but I might need it is a) extremely littlelater and what there is of laughable quality b)so I need to put it somewhere and even what's correct doesn't even scratch the surfacewhere better than SO? Even if I write both halves of the real challenges of doing FP in PHP (objects are passed around by handle so immutable objects need special careQ-A pair, array functionscommenters will force me to make it better. If I write an answer, I do not accept Traversable objects etc) -- ostensibly this platform was supposedneed to be actually solving real problemswrite the question but still I need to provide a legible answer. A month or two later, or even a few years later as I search for real developersthe info, wellI find my own. Awesome. Anyways, we have clear goals: an understandable question, an understandable, to the point answer and a well oiled machinery to refine it does none of thatall.
SoIn documentation -- basic information can be found elsewhere and complex information is simply a much better fit for Q&A. I would say, noone cares aboutcan't find a reason to write docs here as it is not the official docs. I can find a reason to refine the official docs for sure -- we want better docs. But creating new, it looks like an MVPparallel comprehensive docs from ground up? Ain't nobody got time for that a summer intern typed some examples into. Documentation lacks motivation, somegoals and refinery mechanism all of it right, somewhich has been ingeniously provided by the existing Q&A site. The lack of it wrongmotivation is a big problem for primary docs, shallow and uselessdouble, triple so for secondary like this.