On Thu, Jun 14, 2012 at 2:31 PM, Gary Schnabl <[email protected]> wrote:
> On 6/14/2012 12:19 AM, Gary Schnabl wrote:
>>
>> On 6/13/2012 8:18 PM, Tom Davies wrote:
>>>
>>> Hi :)
>>> Is the 3.6.x usable enough to completely skip all the remaining 3.5.x
>>> guides and go straight to the 3.6.x guides instead?
>>> Regards from
>>> Tom :)
>>
>>
>> My dos centavos...
>>
>> Due to the very small number of writers available, LO should always
>> rewrite its current material at the beta version level, at least. Better
>> yet, write for the pre-release alpha stage and update the chapters
>> accordingly, as needed.
>>
>> Otherwise, when the LO docs project attempts to complete an incremental
>> edition, it will likely keep remaining an incremental version or three
>> behind--and possibly contain deprecated or even worse, obsolete, material in
>> addition to being untimely.
>>
>> Gary
>
>
> I forgot to add...
>
> The writings should be done much like the technical editing and rewriting we
> performed for Motorla/Freescale Semiconductor: using conditional text for
> the various material that differs. After a reasonable amount of time, the
> obsolete or deprecated material can be permanently deleted.
>
> Gary


Gary, you know perfectly well that very few volunteers are able to
cope with conditional text or any of the other professional methods of
maintaining documentation. Otherwise, I would agree.

As for working with beta software, this is also a problem for many
volunteers. We've seen that over and over again at OOo and here.
However, I'm far more willing to tackle that problem. Of course, some
of our regular contributors have no problem with using upcoming
releases, so that's not a showstopper.

See my other note about my conclusions from studying the features
lists for v3.5 and v3.6.

--Jean

-- 
Unsubscribe instructions: E-mail to [email protected]
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

Reply via email to