MediaWiki/Homepage improvements 2018

This page is about potential improvements to the mediawiki.org front page as per October 01, 2018. It is both about content and presentation changes. No intention of a complete redesign, but improvements to allow audiences to better find the relevant information that they are likely looking for. We might not be able to make everything perfect but we can certainly try to make it better.

Please discuss and provide input on the discussion page, based on the time line below. --AKlapper (WMF) (talk) 22:19, 30 September 2018 (UTC)

Scope

 * Content on the mediawiki.org front page itself.
 * Out of scope: Discussing whether mediawiki.org is a place purely for MediaWiki core and extensions and skins versus also a place for "other Wikimedia software". Feel free to start a separate thread or initiative about that.
 * Out of scope: Discussing the site-wide side bar content on mediawiki.org. Feel free to start a separate thread or initiative about that later.

Current problems

 * Duplication of content
 * Example: Three links to download MediaWiki (if you include side bar content), "Current version" duplicates what's already listed under "News".
 * Unclear link targets; links spread over a good number of navigation areas
 * Names of links should be more goal oriented when possible: Why should I click "Contribute"? Why should I "Use our APIs?"
 * Example: "support desk" under "Welcome to MediaWiki.org" vs "Help and support" under "Welcome to MediaWiki.org" vs "Get more help" under "Using MediaWiki". Does that imply that I will find a manual (read)? Or a place for questions and answers (ask)?
 * "Developing & Extending": Extending is currently listed in a more development oriented box, but I might want to "extend" my installation as a sysadmin?
 * Missing or hard-to-find content for some audiences
 * Example: "Translate content" (for translators) is only somewhere down in the side bar
 * Example: Where do testers go? To Selenium probably nowadays?
 * Example: Manual:FAQ is only linked from the side bar; Manual:Errors and symptoms is not linked at all so people repeat common questions on the Support Desk. Pages are not among the top 100 page views. Currently there is some fragmentation of answers and knowledge, and hence likely lost energy.
 * Example: As a sysadmin, will MediaWiki solve my problem? I'm supposed to read "Manual:What is MediaWiki?" hidden behind "About MediaWiki" but there is also a link "What is a wiki" to enwp under "Using MediaWiki". I still won't know its features (probably https://www.mediawiki.org/wiki/Principles comes closest as high-level overview, https://www.mediawiki.org/wiki/Manual:MediaWiki_feature_list exists and is long and partially outdated). Manual:Deciding whether to use a wiki as your website type might be worth to link? Professional development and consulting might be worth to link?
 * Also define who is not a main audience of this site (Tool developers? Researchers?) and redirect to more appropriate resources. The scope between "MediaWiki core and extensions" vs "other Wikimedia software" is already blurry as some other Wikimedia software projects also have pages on mediawiki.org, the front page should focus on MediaWiki and its extensions and skins mostly.
 * Content for same audience spread in differentoPPolaces
 * Example The "News" box recently only listed new MW releases, only relevant for administrators. (That might change if News was updated by more parties (who to feel co-responsible?) to also include for example conferences/events (SMWCon, Hackathons, etc₦) or if the section also linked to Tech/News)
 * Irrelevant content.
 * Example: How many people care about the exact numbers and release dates of the latest MediaWiki tarball versions on the front page, and what does it mean that my version is not listed here? If people want to download MediaWiki they should go to the Download page. If administrators think for some reason they should upgrade MediaWiki they shoulto Manual:Upgrading. I doubt anyone inorms themselves about a need for an upgrade oftheir installation byvisiting the front page and then manually comparing with their version.
 * Example: "For general questions about MediaWiki see the communication page": How that page help me exactly if some venues are already recommended on this very page?
 * Misleading content.
 * Example: "Add features with third-party extensions" - The listed extensions are not all "third-party".
 * Page does not tell you that there is also a community that in theory anyone can join, and not only software project(s).
 * Visually looks a bit more dated than needed. (This is highly subjective though and I might be proven wrong.)

== Step

Define the main target audiences. Provide paths for audiences based on which actions they intend to perform / which goals they have in mind. Must cover both new people that have not been exposed to MediaWiki/Wikimedia before, and current users.

Time frame: Oct 01 – Oct 22 (✅)

Announcements / call for comments
 * Project:Current issues: https://www.mediawiki.org/wiki/Topic:Ulqmczfellxvgrul
 * wikitech-l mailing list: https://lists.wikimedia.org/pipermail/wikitech-l/2018-September/090886.html
 * mediawiki-l mailing list: https://lists.wikimedia.org/pipermail/mediawiki-l/2018-September/047631.html
 * Semediawiki-user mailing list: https://sourceforge.net/p/semediawiki/mailman/message/36431583/
 * mediawiki-enterprise mailing list: (sent on 2018-10-03, but not in the archives?)
 * Is there another important place that I have forgotten?

Regarding prior research, is high-level (audiences of mediawiki.org can be found "Build", "Use" and to some extent "Distribute"); meta:Research:Growth and diversity of Technology team audiences/Report is only per software project; semantic-mediawiki.org offers "General | Users | Administrators | Developers".

Proposal for main audiences to target


 * General (high-level info, across actions/audiences, mostly to inform potential new adopters/contributors)
 * Edit and use (users/editors of MediaWiki and extensions)
 * Administrate (potential and existing maintainers of a MediaWiki installation)
 * Develop (potential and existing volunteers and professionals who code)
 * More (Translators, Tech Ambassadors, Documentation writers, Testers, Researchers, etc)

Must cover both new people that have not been exposed to MediaWiki/Wikimedia before, and current users.

Results
Feedback showed general agreement on the major audiences (though with different opinions how to name the audiences). Hence the audiences are described by summarizing their actions, instead of trying to find names for audiences. It was also pointed out that other audiences should be pointed to better suited locations.


 * Edit and use MediaWiki (Users)
 * Set up and run MediaWiki (Administrators)
 * Develop and work on code (Developers)
 * (People visiting mediawiki.org for the first time)
 * Contribute and join our community (covering further audiences, such as Translators, Tech Ambassadors, Documentation writers, Testers, Researchers, etc)

Content
Define content to present to each audience defined in the previous step, based on most common actions each audience performs. Decide which recommended links and information should be exposed on the frontpage. Some links are better suited for being listed on pages linked from the frontpage. Some linked pages might also require cleanup, further or better content, or cover several audiences so they (currently?) should not be linked from the frontpage. Opinions differ – let's define a good initial version (which can always receive further iterations in the future).

Time frame: Dec 11 – Jan 01, 2019 (✅)

Announcements / call for comments:
 * Project:Current issues: https://www.mediawiki.org/wiki/Topic:Ulqmczfellxvgrul
 * wikitech-l mailing list: https://lists.wikimedia.org/pipermail/wikitech-l/2018-December/091213.html
 * mediawiki-l mailing list: https://lists.wikimedia.org/pipermail/mediawiki-l/2018-December/047735.html
 * Semediawiki-user mailing list: https://sourceforge.net/p/semediawiki/mailman/message/36491399/
 * mediawiki-enterprise mailing list: TBD
 * Is there another important place that I have forgotten?

Proposal for content (per actions/audiences defined in the previous phase):


 * About MediaWiki
 * MediaWiki is a collaboration and documentation platform, powered by a vibrant community.
 * MediaWiki by Wikipedia and thousands of other projects. - (TODO: link to Sites using MediaWiki or MediaWiki testimonials? A list of some projects powered by MediaWiki could be nice but first requires a process for adding and curation which we don't have)
 * MediaWiki is powerful, internationalized/multilingual, free and open, extensible and customizable, reliable platform of the Wikimedia movement (mostly: Principles)
 * Find out more about MediaWiki and if MediaWiki is right for you.
 * Download MediaWiki
 * Edit and use MediaWiki (Users)
 * Learn how to navigate
 * Learn how to edit a page
 * Learn more about reading, editing, customizing your experience (TODO: Though that page also lists "Wiki Administration" stuff at the bottom which should like be removed)
 * Set up and run MediaWiki (Administrators)
 * Install and configure MediaWiki
 * Add features with MediaWiki extensions
 * Get professional development and consulting
 * No own server? See Hosting services
 * Problems? See Manual:FAQ and Manual:Errors and symptoms
 * Join MediaWiki Stakeholders' Group, the third-party sysadmin user group
 * Develop and extend code (Developers)
 * New to development? Choose a software project to hack on
 * How to work on MediaWiki or extensions' code
 * Already a developer? Visit the developer hub
 * Interact with content by using our Action API or Web API
 * Read the developer docs
 * Contribute and join our community (covering further audiences)
 * Contribute as a translator, documentation writer, tester, researcher, tech ambassador, ...
 * Report a bug about wrong software behavior
 * Latest news (both developers and sysadmins, not audience specific)
 * (embed Template:MediaWiki News which covers MediaWiki software releases and major technical conferences)
 * (TODO: potentially cover social media channels but Social media does not look very welcoming currently, page seems both for channel owners and channel readers, hence probably not until that is solved)
 * Not finding the answer to a problem with MediaWiki? Ask your question on the Project:Support desk.

Further comments on the proposal above:

mediawiki.org offers lots of pages whose content partially overlaps or is outdated or mixes different audiences (though we have Help and Manual namespaces).

While data on the most popular pages on mediawiki.org is available, it does not offer yearly data, counts separately when a page was accessed via a "Special:MyLanguage" URL, and does not allow summarizing all translated versions of a specific page. Cleaned data could potentially be used to identify both popular pages that should be on the frontpage and pages which are less popular but are considered important or helpful and hence should receive more exposure.

For the records, some links were considered but not used in the proposal above (this list is not necessarily complete):
 * Project:About is about the website scope itself, it is already in the page footer. It is not listed either in the page views for 2018.
 * Project:Help is confusing, includes both basic info ("what is a wiki") but also mediawiki.org site maintenance stuff (like Project:Tasks and partially duplicates what was on the front page already.
 * User hub - not much content, mixes some helpful links to be better named ("Public domain help pages") with some out of scope non-user admin stuff ("Professional support and development")
 * Documentation covers users, developers and system administrators with a lot of details. Users don't search for (generic) "documentation" itself but "how can i do / achieve XYZ?".
 * Cannot link to any Wikimedia technology blog feed anymore as there is no such category on the new WMF site plus it lacks RSS anyway.

Results
No feedback apart from Topic:Uq7iqcshpshmf8pa asking to remove Tech News and proposing to make the first section an About section.

Layout and layout implementation
Time frame: Mar 19 – Apr 02, 2019 (✅)

Proposal for page content and layout (per items defined in the previous phases):


 * See MediaWiki/Homepage improvements 2018/Proposal

Announcements / call for comments:
 * Project:Current issues: https://www.mediawiki.org/wiki/Topic:Ulqmczfellxvgrul
 * wikitech-l mailing list: https://lists.wikimedia.org/pipermail/wikitech-l/2019-March/091814.html
 * mediawiki-l mailing list: https://lists.wikimedia.org/pipermail/mediawiki-l/2019-March/047910.html
 * Semediawiki-user mailing list: TBD under https://sourceforge.net/p/semediawiki/mailman/semediawiki-user/?viewmonth=201903
 * mediawiki-enterprise mailing list: https://lists.wikimedia.org/pipermail/mediawiki-enterprise/2019-March/000488.html
 * design mailing list: https://lists.wikimedia.org/pipermail/design/2019-March/thread.html
 * Is there another important place that I have forgotten?

Further comments on the proposal above:


 * Clearer in both content and layout.
 * Limited number of links to more specific information to relevant pages, without duplication. Also make clear we are a community.
 * Only some minor rephrasing has taken place, compared to what was proposed under above.
 * Tested desktop version on smaller screen widths and with the six deployed skins.
 * The CSS flex layout is well enough supported as per https://caniuse.com/#feat=flexbox and Compatibility.

Potential followups left to do:


 * Do not embed unneeded "Recent News" header from Template:MediaWiki News. (Fixed by bd808)

Results

 * Helpful feedback and comments on Talk:MediaWiki/Homepage improvements 2018 and Talk:MediaWiki/Homepage improvements 2018/Proposal got implemented in the proposal
 * A list of potential future work on problems with related pages was collected in MediaWiki/Homepage improvements 2018
 * The new content and layout went live on April 13th, 2019 (permanent link).
 * Announcements: mediawiki-l, wikitech-l, mediawiki-enterprise, translators-l, Project:Current issues

Previous attempts

 * https://www.mediawiki.org/wiki/MediaWiki/Homepage_redesign
 * https://www.mediawiki.org/wiki/Requests_for_comment/MediaWiki.org_Main_Page_tweaks

Potential follow-up work
This section lists further related topics which could be potential follow-up items but are currently out of scope for this very project.


 * Clean up unneeded pages in mw:Project:Main page templates. This (ancient) manual subpage-translation system predates the newer Translate extension.
 * Add  attributes to Template:Main page once T204618 is fixed (as proposed in Topic:Ux7qq58kyhlvgqew).
 * Help:Contents lists "Wiki Administration" stuff at the bottom which should be (re)moved
 * Manual:Errors and symptoms and Manual:FAQ are linked under "Set up and run MediaWiki" but some FAQ sections cover very generic non-technical topics, and content wise both pages partially interfere and could be better 'split'.
 * The social media channels under "News" are not the best solution but the Social media page does not look welcoming and seems to mix both channel owners and channel readers audience
 * Potentially add a row of logos of organizations and companies using MediaWiki (as proposed in Topic:Uwkuuujcniict2ln and ).
 * MediaWiki:Sidebar might also welcome a lot of cleanup [moved to talk]