Elliott feels that he has had a bad experience on the WordPress codex and is troubled by the way it is being run. He feels that the codex has become
an unfriendly playground and that he no longer wants to play.
It truth what happened was he arrived at the codex with his own preconceptions about how the site was run and how he should behave. He ran straight in without finding out what was going on and how new content was being authored.
The codex has a set of guidelines about contributing and in particular “Creating a new Page”. These state specifically that the recommended process is to create a Temporary page under your user page and work on the drafting process. Then when you feel the page is ready you move out of your User Pages and into the main content of the codex.
… I went to my user page, which sadly is public there, and noticed that an uber-excited admin Lorelle decided to yank my page and leave me a nice message something along the lines of:
Welcome to the WordPress Codex!! Blah blah blahâ€¦
Youâ€™ve created a nice new page, but no one can get to it. You should blah blah blahâ€¦
Come on. Iâ€™m still in the middle of editing it, of course no one can get to it. Iâ€™m a highly paid software engineer. When Iâ€™m done writing the article, Iâ€™ll link from the relevant page. Still, our overeager admin sees a new article and immediately trounces it.
Firstly the welcome message you saw is standard, this is part of the process by which the community of documentation volunteers welcomes new members. Lorelle was only welcoming your as is normal on the codex and pointing out that your in draft page would be better suited elsewhere.
Yes you may be a highly paid software engineer – good for you – this doesn’t mean that you don’t have to play by the rules does it? We are a community, we work together, some of us have jobs, some don’t. This doesn’t mean that we can’t work together.
The current codex content is only there because of the hard work the the volunteers like Carthik, Kafkaesqui, Lorelle, MDAWaffe, NuclearMoose, Podz and many other have put it to authoring it.
In the comments Elliott says:
When you present as a wiki, you put out the impression that you are soliciting contributions, not forcing people down an artificial pipelining process. Instead of abusing admins with babysitting the assembly chain, the Codex should use software designed for your peculiar needs and stop lying about being a wiki in anything more than the software.
What he is forgetting here is that the codex is as stated at the top of the front page “The Online Manual” for WordPress. It is a manual first and a wiki second. The large number of volunteers who have contributed to the codex has worked together to create a process whereby new content can be authored by the community for the community without it appearing as part of the main body of the codex until it is ready for all comers.
The codex documentation effort is all about soliciting contributions, but like any community it has it’s rules, and if you wish to join in you need to play by the rules.
You would not expect a library / bookshop to be happy if you were to walking with you half written draft and place in on there shelves coming back every few minutes/hours/days to update it until it was finished. No there is a process for getting your work into that posistion much like the codex has a process for writing and adding documentation.
The process as a development of best practise probably exists for a reason!
To conclude the WordPress community openly welcomes Elliott or anyone else’s contributions to the Online documentation for WordPress. They just ask nicely that where they have developed guidelines and best practise that they are followed the same as you would for any other situation.