[libreoffice-documentation] QA considerations [was: Re: Calc Guide corrections]

[Nino Novak <nn.libo@kflog.org>]

On Friday 27 April 2012, 07:24:14 Jean Weber wrote:

> As an aside, it's really getting to the point where we will have to do
> something drastic about these buggered-up x-refs.

How exactly does it happen?

What steps are you performing to produce the final document? (It's a global 
document, right?) 

The way I'd suggest to try to narrow down the cause of the problem should not 
be pragmatic in the sense of "what can we do to avoid/work around the 
problem?". 
I'd rather suggest to "think QA", what's just the opposite: "What can we do to 
make it break? - What is the minimum set of essential steps to reproduce the 
failure?". (It's not natural thinking, it's rather some kind of devil's 
advocating.)

Therefore: could you try to save increasing intermediate parts of the growing 
document after each single step you perform? And examine them carefully to 
find out, which step breaks the references? 
A next step could be: Is it reproducible if you strip almost all text from the 
documents in question and just leave the refs and the pictures in place?

> I keep avoiding
> this, because I'm sure it will require starting from scratch, with a
> totally new and clean template (not modified from an existing
> template) and files, pasting in everything in unformatted text,
> reformatting, the works... just to find out if it's a bug in our files
> (which I'm convinced it is) or a bug in LO itself.

IMHO it'd be rather interesting to find out if it's really a LO (or OOo/AOO) 
bug or some kind of broken document template.

(Just some suggestions)

Nino

-- 
Unsubscribe instructions: E-mail to documentation+help@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted