On Thu, Jul 26, 2012 at 7:41 PM, Asheesh Laroia <[email protected]> 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 _______________________________________________ Wikitech-l mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/wikitech-l
