On Thu, Jul 26, 2012 at 7:41 PM, Asheesh Laroia lists@asheesh.org wrote:
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.)
Yes, please be bold. Nobody "owns" that documentation :)
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.)
Really, the installation guides are awful, confusing, outdated, and have been forked for every platform imaginable (has someone written one for z/OS yet?). They never got the love & attention they needed after the new-installer rewrite.
What I want to see is a single installation page that covers all the basics, without explaining 115 extra steps that probably don't apply to you (like the current install docs). Platform-specific information should be included as a subpage, and kept to bare-minimum info about that platform.
Now would be an *excellent* time to finally do this.
-Chad