Hello, dear wikitech-ians,
For the Hackathon, I (with some help!) prepared a laptop setup guide for getting MediaWiki installed, from start to finish, on Windows, Mac, and Linux. http://www.mediawiki.org/wiki/Hackathon/Laptop_setup
It is somewhat unique in the world of MediaWiki install instructions in that:
* It uses sqlite.
* It is quite prescriptive -- it tells you what to do, rather than giving you many options. (This helps us avoid danger points -- for example, some people accidentally download Apache/PHP bundles with 5.3.1 still. To avoid that, we advise a specific bundle.)
* It is targeted at people without any command line experience.
* It is targeted at people without necessarily any experience with a text editor.
I originally wrote it for the Wikimania Hackathon's newbie track, and it worked reasonably well there. Therefore, unlike most sets of "install MediaWiki", it's been 'play-tested'.
I've copied it to here: http://www.mediawiki.org/wiki/Hackathon/Laptop_setup
My own quibbles ---------------
One of the big problems we experienced with this Laptop setup page was that it's not a great thing to do *first* -- it took some people way more than one hour.
For some of the "Tasks" we put together for the Hackathon, you didn't need a local development environment for MediaWiki, and for others, you did but could live without getting git/gerrit going. Therefore, if a person wants to set up MediaWiki on their own machine without requesting Git/Gerrit access, then they don't have to go through all these steps.
Also, there were a handful of problems we worked out in the Mac OS version of the documentation -- those are fixed now, though.
By and large, I'm pretty happy with it.
Next steps ----------
Here's my question for y'all: where do docs like this fit into the mediawiki.org install guides?
Is there a person I should contact who maintains the main install guide, or should I just be some combination of 'bold' and respectful and try to weave it into the main documentation? (Doing that would be a pretty massive undertaking.)
What I would like to see, honestly, is the following:
https://www.mediawiki.org/wiki/Manual:Installation_guide has a few giant buttons:
"Want to install MediaWiki on your web hosting?" which takes you to some docs that discuss PHP, SFTP, etc.
"Want to install MediaWiki on your personal computer?" which takes you to something like Hackathon/Laptop_setup
(Maybe other giant nav buttons?)
Alternatively, we could just let my Hackathon/Laptop_setup guide sit where it is, and future Hackathons will just reference those, but the official install docs won't ever link there. (I think this would not be as good, but am curious to hear what y'all think.)
-- Asheesh.