Bug 5086 - Wrong help for several screens during install
Summary: Wrong help for several screens during install
Status: RESOLVED FIXED
Alias: None
Product: Mageia
Classification: Unclassified
Component: Installer (show other bugs)
Version: Cauldron
Hardware: All Linux
Priority: High major
Target Milestone: ---
Assignee: Documentation Team
QA Contact:
URL:
Whiteboard: 3alpha1 3alpha2
Keywords:
Depends on:
Blocks:
 
Reported: 2012-03-25 11:36 CEST by Barry Jackson
Modified: 2012-12-06 17:54 CET (History)
6 users (show)

See Also:
Source RPM: drakx-installer-stage2
CVE:
Status comment:


Attachments

Description Barry Jackson 2012-03-25 11:36:18 CEST
Description of problem:
The Help in the bootloader configuration page of the installer is incorrect.
It appears to be a directory structure from somewhere - totally meaningless to anyone trying to install a bootloader ;)

Version-Release number of selected component (if applicable):
Net install today (25/3/2012)

How reproducible:


Steps to Reproduce:
1.
2.
3.
Barry Jackson 2012-03-25 11:36:48 CEST

Priority: Normal => release_blocker

Comment 1 Marja Van Waes 2012-03-25 11:55:56 CEST
Yep, you're right.

I doubt this should be a release blocker, though. Mageia 1 didn't even have any help files.

Priority: release_blocker => High
CC: (none) => marja11
Assignee: bugsquad => doc-bugs

Comment 2 Feth Arezki 2012-04-05 17:17:13 CEST
Same when pressing "help" on Xorg module selection.

CC: (none) => feth+mageia

Comment 3 Marja Van Waes 2012-04-05 20:29:34 CEST
(In reply to comment #2)
> Same when pressing "help" on Xorg module selection.

That is true, some things went wrong while generating and converting the the help files.

We are working on it.

Status: NEW => ASSIGNED
Assignee: doc-bugs => marja11
Summary: Wrong help in bootloader configuration during install => Wrong help for several screens during install

Comment 4 Marja Van Waes 2012-04-06 15:29:43 CEST
@ Thierry

It seems the problem is somewhere else than I thought.

setupX.html and setupBootloaderBeginner.html are both where they should be, in /usr/share/doc/installer-help/

I don't think something went wrong when generating those files anymore.

The filenames are exactly what they were in Mandriva 2010.1

Is it possible that in Mdv those two help files were retrieved from somewhere else, even though they were also available in /usr/share/doc/installer-help/ ?

Another weird thing is, that we have a help for the Sound Configuration, although it isn't in /usr/share/doc/installer-help/ and although we never wrote it.

CC: (none) => thierry.vignaud

Comment 5 Thierry Vignaud 2012-04-06 16:32:04 CEST
No.
sound doc came from drakx code :-)
Comment 6 Marek Laane 2012-04-06 17:14:39 CEST
It may be ... As translator also in Mandriva I remember to have been told there is no sense to translate install-help, such as it was in SVN, because it will be retrieved from somewhere else - I don't remember exactly but it was documentation project (Camilla and NeoDoc are the keywords I can remember).
Comment 7 Thierry Vignaud 2012-04-06 17:37:21 CEST
install-help is pretty dead indead but sound help doesn't came from here but from harddrake::sound
Comment 8 Marja Van Waes 2012-04-06 22:24:38 CEST
(In reply to comment #6)
> I don't remember exactly but it was
> documentation project (Camilla and NeoDoc are the keywords I can remember).

You have a very good memory: Camille and NeoDoc

We just started with new help files that are also written with help of NeoDoc and Camille.

But as soon as they are found to be correct and in the correct place, they need to be translated. Your help is very welcome then :)

@ Thierry

Assigning to you, because I don't think there is anything I can do.

Can you please change the anchors in drakx-installer-stage2 so that setupX.html and setupBootloaderBeginner.html do work?

Status: ASSIGNED => NEW
Assignee: marja11 => thierry.vignaud
Source RPM: (none) => drakx-installer-stage2

Comment 9 Marek Laane 2012-04-06 22:58:32 CEST
Well, the thing in times of Mandriva was that the system NeoDoc applied (at first Borges, later it was something else) was at least for me as translator uncomprehensible - and I guess fo others, too, because translations of Mandriva docs just dried off after that ... Hopefully Mageia will use some system more translator-friendly for their documentation, be it install-help or user manuals or whatever (e.g. something like KDE does: written in docbook, converted for translators to gettext po-files and then back to docbook for end-users).
Comment 10 Marja Van Waes 2012-04-21 22:27:38 CEST
(In reply to comment #9)
@ Marek

Our documentation is in fact written in docbook5.0 files and then converted to html, pdf or whatever is needed.

@ Thierry

In Mga2b3  setupX.html and setupBootloaderBeginner.html are still not there, but I do see a help file for the Resolution screen  - Choose the resolution and the color depth (Graphics Card: intel 810 and later)

Where does that come from?
Comment 11 claire robinson 2012-04-27 15:41:04 CEST
This is still the case in RC pre-release.
Comment 12 Marja Van Waes 2012-04-27 18:03:58 CEST
I'm now checking with a network install, both missing pages are displayed fine when clicking on the links to them in the help page for the summary, misc-params.html

That is at least something
Comment 13 Marja Van Waes 2012-04-27 18:11:10 CEST
(In reply to comment #12)
> I'm now checking with a network install, both missing pages are displayed fine
> when clicking on the links to them in the help page for the summary,
> misc-params.html
> 
> That is at least something

Because someone just misunderstood:

Clicking on help in the "bootloader main options" screen doesn't display the help text. However, after clicking on "Help" in the Summary and seeing misc-params.html displayed, the link to setupBootloaderBeginner in it works fine, it displays that page. 
The same is true for setupX.html, you can only see that page when using the link in the general help for the summary page.
Comment 14 Claire Revillet 2012-05-07 14:22:41 CEST
The problem i can see with the way it works with X setup is that you have to setup X before the summary, so it's really weird to have a browser here :\

CC: (none) => grenoya

Comment 15 Marja Van Waes 2012-05-15 13:52:37 CEST
Installing Mdv 2010.1 PP, in the first choose a monitor screen, right after adding a user and giving the root password, hitting the help  button gives a white empty screen.

Same for the Graphic card & monitor configuration screens (except the one for resolution, which works for Mageia, too)

The same happens in the Bootloader Main Options screen: all you get is an empty, white screen.

I seemed we inherited this  bug from Mdv, as well.


The only difference is getting a white screen instead of a few of directories
Comment 16 Marja Van Waes 2012-05-15 13:52:57 CEST
s/seemed/seems/
Comment 17 Marja Van Waes 2012-05-18 15:42:12 CEST
https://qa.mandriva.com/show_bug.cgi?id=52121
https://qa.mandriva.com/show_bug.cgi?id=47318

Looks like the same bug, except for us having a help for the mouse choice screen, now.

Could whatever fixed #47318, help us?
Comment 18 Thierry Vignaud 2012-05-18 15:55:38 CEST
No.
papoteur 2012-05-20 09:31:59 CEST

CC: (none) => yves.brungard_mageia

Comment 19 papoteur 2012-05-20 10:03:44 CEST
(In reply to comment #14)
> The problem i can see with the way it works with X setup is that you have to
> setup X before the summary, so it's really weird to have a browser here :\

No, what I see during installation is that X is configured automatically, and we get the possibility to configure X only in Summary. Perhaps it depends of videocard.
Comment 20 Marja Van Waes 2012-05-20 13:04:06 CEST
It depends on your hardware, indeed, but even then it can happen that on the same system one time you get the screen before the summary page and the other time you don't and it was correctly detected. Or you don't get the screen and it wasn't correctly detected, but you see a red word on the "Graphical interface" line in the summary page that draws your attention to the missed setting.
Comment 21 Marja Van Waes 2012-05-26 13:04:24 CEST
Hi,

This bug was filed against cauldron, but we do not have cauldron at the moment.

Please report whether this bug is still valid for Mageia 2.

Thanks :)

Cheers,
marja

Keywords: (none) => NEEDINFO

Comment 22 Marja Van Waes 2012-06-04 22:53:05 CEST
yes, still valid  of course :/

Keywords: NEEDINFO => (none)

Comment 23 Marja Van Waes 2012-07-06 15:05:26 CEST
Please look at the bottom of this mail to see whether you're the assignee of this  bug, if you don't already know whether you are.


If you're the assignee:

We'd like to know for sure whether this bug was assigned correctly. Please change status to ASSIGNED if it is, or put OK on the whiteboard instead.

If you don't have a clue and don't see a way to find out, then please put NEEDHELP on the whiteboard.

Please assign back to Bug Squad or to the correct person to solve this bug if we were wrong to assign it to you, and explain why.

Thanks :)

**************************** 

@ the reporter and persons in the cc of this bug:

If you have any new information that wasn't given before (like this bug being valid for another version of Mageia, too, or it being solved) please tell us.

@ the reporter of this bug

If you didn't reply yet to a request for more information, please do so within two weeks from now.

Thanks all :-D
Comment 24 Marja Van Waes 2012-08-04 23:50:30 CEST
Just did a test upgrade with the test drakx-installer-help

At least 5 of the file names papoteur found are correct (of the bold ones in this list https://wiki.mageia.org/en/Help_buttons_in_DrakX-installer#Installer_File_Names )

I tested with an upgrade install, so maybe there is more.

In the summary step, I found
* configureX_chooser for the Graphic Card & Monitor Configuration
* configureX_card_list for Choose an X server
* configureX_monitor for Choose a monitor
* setupBootloader for Bootloader Main Options
* setupBootloaderAddEntry for after you choose to add and/or modify an entry in Bootloader Configuration

@ Thierry

There are no help buttons for Network & Internet Configuration (again when going there in the summary), but papoteur found a file name "configureNetwork". Is the help button hidden? If so, can it be made visible?
Comment 25 Marja Van Waes 2012-08-04 23:58:22 CEST
re-assigning to doc team, we are going to fill those 5 files with real help texts so that this bug can be closed :-D

Assignee: thierry.vignaud => doc-bugs

Marja Van Waes 2012-08-05 18:47:44 CEST

Status: NEW => ASSIGNED

Comment 26 Marja Van Waes 2012-08-30 13:28:57 CEST
committed for En and Uk are:

* configureX_chooser.html
* setupBootloader.html

they are written for French too, but not committed yet
configureX_chooser was written for Spanish, but I think the entire Es help still needs to be committed (no time to check now)

The other 3 files are expected to be committed for En this week.

All other translations still need to be done
claire robinson 2012-08-30 15:44:46 CEST

Whiteboard: (none) => 3alpha1

Comment 27 Marja Van Waes 2012-08-30 16:32:13 CEST
French
* configureX_chooser.html
* setupBootloader.html
are in SVN too, now

But I'm too late, it is improbable the new files will be in alpha 1, sorry.
Comment 28 Marja Van Waes 2012-08-31 21:20:43 CEST
configureX_chooser and setupBootloader are now committed (not submitted) for all languages, for the new language Spanish the Bootloader help files are still in English, though.

The other 3 working new help files are filled with help texts but might need improvement, they are only available in English, now.
Comment 29 claire robinson 2012-09-29 13:29:14 CEST
Some pages are still using marja's links, Desktop Selection and some other links, so valid still for 3alpha2.

Whiteboard: 3alpha1 => 3alpha1 3alpha2

Comment 30 Marja Van Waes 2012-09-29 14:24:28 CEST
(In reply to comment #29)
> Some pages are still using marja's links, Desktop Selection and some other
> links, so valid still for 3alpha2.

That is correct, nothing changed since comment 28, no new commits or submits.

I'll try to commit all changed files asap.

CC: (none) => n54

Comment 31 Marja Van Waes 2012-12-06 17:54:22 CET
Forgot to  close this bug, it is fixed, but for translations that still need to be done the English text will show instead of a translated one.

Status: ASSIGNED => RESOLVED
Resolution: (none) => FIXED


Note You need to log in before you can comment on or make changes to this bug.