Page MenuHomePhabricator

MediaWiki:Config-welcome seems misleading, make clearer user should provide debug output etc. when asking for help
Closed, ResolvedPublic

Description

I believe, the last sentence in MediaWiki:Config-welcome,
"You should provide the results of these checks if you need help during installation."
should not ask the user to provide results of checks to the installer, but rather vice versa:
"This process should provide the results of these checks if you need help during installation."
or something the like.

a) The user would likely not know the results of checks.
b) Even if told what they are, unexperienced and novice users may not be able to understand and reproduce them correctly.
c) The installer knows them anyways, so why ask back?
d) The installer should not ask unnecessary questions, based upon its findings, but should inform the user of unavailable options, such as:
"Mediawiki is going to use a MySQL 4.0 data base. You could as well use PostgreSQL, if a PostgreSQL server was installed and running on this system, but none was detected. Proceed? (YES/no)"
The "no" choice could then give a quick hint as to how to get PostgreSQL.


Version: 1.22.0
Severity: minor
URL: http://translatewiki.net/wiki/MediaWiki:Config-welcome/en

Details

Reference
bz24751

Related Objects

View Standalone Graph
This task is connected to more than 200 other tasks. Only direct parents and subtasks are shown here. Use View Standalone Graph to show more of the graph.

Event Timeline

bzimport raised the priority of this task from to Low.Nov 21 2014, 11:06 PM
bzimport set Reference to bz24751.

(In reply to comment #0)

I believe, the last sentence in MediaWiki:Config-welcome,
"You should provide the results of these checks if you need help during
installation."
should not ask the user to provide results of checks to the installer, but
rather vice versa:
"This process should provide the results of these checks if you need help
during installation."
or something the like.

The wording is poor here, yes. But I believe you're misunderstanding what it means. It's trying to say "If you have problems while installing--and you go looking for support--provide these results (to the person who is helping you) so that they can help you better"

It has nothing to do with inputting the results back into the installer. That wouldn't make any sense (things like the diff3, ImageMagick results are stored and used later as appropriate).

But yes, I'm open to suggestions on better wording here.

Change 78375 had a related patch set uploaded by Nemo bis:
Rephrase the installer's config-welcome message

https://gerrit.wikimedia.org/r/78375

Change 78375 merged by jenkins-bot:
Rephrase the installer's config-welcome message

https://gerrit.wikimedia.org/r/78375