Re: [libreoffice-documentation] Updating user guides to LibO 3.4.2

Hi :)
Lol, phew.  I thought you were on a wrong track but wasn't completely sure.  

The longer gaps between series 3.3.x releases (and it's generally better 
stability) made me think it was stable branch and 3.4.x was development as 
various other OpenSource projects do.  But i think that's not the way the devs 
see it. 

Regards from
Tom :)




________________________________
From: Jean Hollis Weber <jeanweber@gmail.com>
To: documentation@global.libreoffice.org
Sent: Wed, 3 August, 2011 5:19:25
Subject: Re: [libreoffice-documentation] Updating user guides to LibO 3.4.2

Thanks for that clarification, Tom. I'm sure I once knew that but had
totally forgotten. That makes a lot of my recent assumptions and
thinking obsolete. 

I need to re-think the arguments for one set of files (like Nino
suggested) or two -- not an archived set vs a live set, but separate
sets for the 3.3.x series and the 3.4.x series. And I see why we might
need two sets of Draft-Reviewed-Proofread-Published spaces... 

My initial reaction is two sets of files, but that really increases the
need for reusable material (the majority of info that is the same for
both series)... done in a way that doesn't confuse the contributors. I
WILL dig up my notes on how to do this, as mentioned in an earlier
message to this list.

Further comments welcome. Might help me sort out my thinking... if it
doesn't further confuse me. <chuckles />

--Jean

On Wed, 2011-08-03 at 04:55 +0100, Tom Davies wrote:
> Hi :)
> I'm sure there is some confusion somewhere.  The 3.3.x series is not "older" 
> and 
>
> the 3.4.x "new".  Both series are being developed alongside each other.  
>
>
> The next release of LO is due to be the 
> 3.3.4 due out on Aug 17th give or take a day or 2.  Then the 
> 3.4.3 on Aug 31st and 
> 3.4.4 on Oct 5th followed by 
> 3.3.5 on Oct 19th.
> Regards from
> Tom :)
>
>
>
>
> ________________________________
> From: Jean Hollis Weber <jeanweber@gmail.com>
> To: documentation@global.libreoffice.org
> Sent: Wed, 3 August, 2011 4:33:50
> Subject: Re: [libreoffice-documentation] Updating user guides to LibO 3.4.2
>
> On Tue, 2011-08-02 at 13:05 +0200, Nino Novak wrote:
>
> > For end users the file name should be kept as simple as possible but not 
> > missing *important* info. If you really intend to offer a complete set 
> > of new documents for each minor version step, the version info should go 
> > into the file name.
> >
> > If only major versions are to be fully reflected in the documentation, 
> > there is no need to put version info into the file name (as there are 
> > several years in between them). Minor versions should then be reflected 
> > by e.g. in-chapter-icons ("available since LibO 3.4" or similar).
> >
> > In my eyes, the latter seems more reasonable, but I'm not involved in 
> > the (English) Doc team work.
>
>
> I have been thinking about the pros and cons of a new doc set vs "new in
> 3.4" info in the same chapter, but I have not had time to read up on
> just what has changed from 3.3.x to 3.4.x. Sometimes relatively minor
> functional differences mean that fields are moved from one dialog box to
> another, or the names of things change, or other changes are made that
> are difficult to handle clearly in a single file. Other times, what you
> suggest works well.
>
> When I've had time to look at the changes, I'll have something less
> vague to say on the subject.
>
> --Jean
>
>
> -- 
> 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




-- 
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

-- 
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