Bug 68103 - Draw Help for Headings outdated
Summary: Draw Help for Headings outdated
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Drawing (show other bugs)
Version: 4.1.0.4 release
Hardware: All All
: high normal
Assignee: Not Assigned
QA Contact:
URL:
Whiteboard: ProposedEasyHack
Keywords:
Depends on:
Blocks:
 
Reported: 2013-08-14 11:41 UTC by tim
Modified: 2014-07-12 20:18 UTC (History)
3 users (show)

See Also:
i915 platform:
i915 features:


Attachments

Description tim 2013-08-14 11:41:43 UTC
I tried to create a heading in a Master Slide in Draw to get a page number on each page.

The whole Help section on "Adding a Header or a Footer to All Slides" does not apply to LO 4.1 Draw.  

As just one example, the Help says:

"1. Choose View - Header and Footer.
You see a dialog with two tab pages: Slide and Notes and Handouts where you can enter contents to the predefined areas. "

However, there is no such View option.  Many of the other options mentioned, including a discussion on the types of Master, seem to be wrong.

Not having used Draw much in the past I do not know when the Help became out of date, but this entry clearly needs a refresh.

Whilst this is minor, to someone new to the application it is pretty baffling.
Comment 1 tim 2013-08-16 20:50:34 UTC
The re-naming of this post, from being 'wrong', to be 'outdated' is slightly irritating.  

For the avoidance of doubt, the current help supplied with 4.1 is wrong.

The reason it is wrong may be because it is outdated, but that is cause, not effect.

I know nothing about LO update processes.  I am well aware it's free, and we should all make enormous allowances for that.  

Nonetheless, when updates are made is there any even vaguely formal process for checking that the help is still correct, or reasonably appropriate? In this case it is completely inappropriate and misleading.
Comment 2 tim 2013-08-18 12:04:21 UTC
I posted a note about this on the LO forum, and had some helpful feedback.  

I was using the built-in Help for Draw.  This has a section "Adding a Header or a Footer to All Slides" which is actually for Impress, not Draw.  

Doing a search for online help with this title leads to https://help.libreoffice.org/Impress/Adding_a_Header_or_a_Footer_to_All_Slides

So what appears to have happened is that the Impress Help has infiltrated the Draw Help in the downloaded Help.
Comment 3 Joel Madero 2013-09-24 13:46:11 UTC
I have been able to confirm the issue on:
Version: 4.2.0.0.alpha0+ Build ID: 4547d8c42e5b0bb456ac02fbea67059a8a1cadd7
Date: Tue Sep 24 01:49:59 2013 +0300
Platform: Bodhi Linux 2.2 x64

Very interesting, so you're seeing:

https://help.libreoffice.org/Impress/Adding_a_Header_or_a_Footer_to_All_Slides

Which is clearly Impress related. The reason for this (it is a bug by the way) is that Impress and Draw are actually very similar, using a lot of the same code. Likely that someone used cross compatible code that carried the help over.

This being said, we have a team of a couple hundred volunteers (mostly), so yes we do have a check in process but when there are hundreds of thousands of things you can do with the product, it's impossible that we check it all. We rely on users (and incredibly helpful volunteers) to do quality checks.

If you're interested in helping QA, please feel free to contact me, we could surely use the help to do as much quality checking before release as possible.

I am bumping this up to "normal-high" as we want our help files functional for users. I'm also adding to MAB since we've done this in the past.
Comment 4 Björn Michaelsen 2014-01-17 09:51:49 UTC
(This is an automated message.)

Setting priority to highest as this is a 4.1 MAB. This is part of an effort to make the importance of MAB reflected in priority too.
Comment 5 tommy27 2014-05-13 05:29:42 UTC
please retest against 4.2.4.2
if bug persists please move it to mab4.2 list since 4.1.x is EOL
Comment 6 Joel Madero 2014-05-13 05:33:01 UTC
I am actually removing this from MAB - apologies, I put it there to begin with and it honestly shouldn't be on the list.
Comment 7 tim 2014-05-13 07:26:34 UTC
It's a while since I raised this, so please bear with me.

I just have tried this on 4.2.4.2 (with British help), with a recently new set of user configuration files.  

I open a new Draw document, and View, Slide Master.  I want to add a Header.  In the Help for Draw, headers and footers, slide masters, it says:

"Every type of master has some predefined areas to hold the date, footer, and slide numbers. ... "
"A predefined Header Area is available only for notes and handouts. If you want a header on all slides, you can move the Footer Area on the slide master to the top...."
"Objects that you insert on a slide master are visible on all slides that are based on that slide master.
1. Choose View - Header and Footer....."

Well, all I can say is that nowhere on the Slide Master, or the Normal Slide can I find anything to do with a header or footer.  If I add a page number to the slide master, it does appear on the normal pages, and increments for each page, but it it isn't in a 'header' object or a 'footer' object.  There is no menu item "View, Header and Footer".

May I ask, somewhat naively, whether anyone has actually just sat down and tried to follow the help for this and add a header or footer?  Or am I just being stupid?
Comment 8 Joel Madero 2014-05-13 15:01:29 UTC
Probably not - we have thousands of bugs and QA just confirms the issue (which I did) but it needs updated. Thanks for the feedback.

If you ever have some time to help QA out it would be fantastic - currently we have 1,100 unconfirmed bugs that need looked at. Send me an email if you have even a few spare cycles a month.

Thanks again
Comment 9 tim 2014-05-13 15:13:57 UTC
I do try and raise problems when I find them, however minor, and have a LibreOffice T-Shirt to prove it :).  This often takes a lot of time and energy.  For instance I spent many, many hours on a recent series of issues on Calc.  Once started I have a habit of getting rather too focused on a problem to the detriment of the rest of my life.

I'm reluctant to commit to QA partly because I don't have much in the way of environments to check specific versions or platforms.  Multiple versions on my main PC tend to give me some grief, so I try to avoid them, and I need LO to work.  I also tend to use the Ubuntu PPA releases, which follow later than the main site, since the integration is better.

So, feeling a little guilty, I won't offer to help, for now at least.  Sorry.
Comment 10 Joel Madero 2014-05-13 15:45:04 UTC
Hey,
On 05/13/2014 08:13 AM, bugzilla-daemon@freedesktop.org wrote:
> https://bugs.freedesktop.org/show_bug.cgi?id=68103
>
> --- Comment #9 from tim@tim-passingham.co.uk ---
> I do try and raise problems when I find them, however minor, and have a
> LibreOffice T-Shirt to prove it :).  This often takes a lot of time and energy.
>  For instance I spent many, many hours on a recent series of issues on Calc. 
> Once started I have a habit of getting rather too focused on a problem to the
> detriment of the rest of my life.
>
> I'm reluctant to commit to QA partly because I don't have much in the way of
> environments to check specific versions or platforms.  Multiple versions on my
> main PC tend to give me some grief, so I try to avoid them, and I need LO to
> work.  I also tend to use the Ubuntu PPA releases, which follow later than the
> main site, since the integration is better.

Well you don't need multiple platforms nor multiple versions. It's
sufficient to test on a single platform and a single version (so long as
that version is a new version) and then mark the bug as NEW with your
findings.
>
> So, feeling a little guilty, I won't offer to help, for now at least.  Sorry.
Fair enough - let me know if you change your mind (we could most
definitely use the help, right now we're just falling behind)

Best,
Joel
Comment 11 tim 2014-05-13 16:27:17 UTC
Will do.

Tim
Comment 12 Björn Michaelsen 2014-07-12 20:18:14 UTC
Priority highest is reserved for MABs, please see: https://wiki.documentfoundation.org/MAB on when a bug qualifies for that.

Thus keeping this on priority high.


Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.