Forwarding this to a more appropriate discussion list. --Jean

---------- Forwarded message ----------
From: Roger Caws <[email protected]>
Date: Tue, Apr 19, 2016 at 8:32 AM
Subject: [odfauthors-discuss] user guide for large complex
documentation with Writer
To: [email protected]


Hello,
This is me
1 Experienced documentation author and project manager
2 background is large complex documentation using Word Perfect and
Microsoft office in a windows environment
3 disenchanted with Microsoft quality and direction.
4 recently switched to Linux Mint with zero knowledge of Linux
5 used lots of tutorials, on-line manuals etc with mixed results
6 Most of what is out there assumes a) a knowledge of Linux and its
quirks; b) that the reader wants to know just enough for simple
documents.
6 decided that best way to learn how to use LibreOffice is by writing
a manual for Writer (complex projects)
7 Have firmed up on design which has three components
a) A manual which covers "how to" of ALL the facilities in Writer (and
actually uses as many of them as possible)
b) A construction history which details how this particular manual was
developed and how to use it as a start point for other documents which
use a lot of the facilities of Writer (and assumes that the reader has
limited experience of manual development)
c) A section showing alternative settings and results for design so
that the reader is not restricted to choices made for THIS manual

This is my Questions
1 Would the existing authors organisation welcome such a project or
regard it as an impertinence.
2 This will be a non-trivial document and I would welcome more
knowledgeable input given my own weakness in this area.  Could this
happen and how would it work?
3 It is going to take some time so how would new releases be
incorporated so that it was up-to-date when released

The project still has a primary purpose of ramping up my learning
curve to the point where I can undertake other similar complexity
projects with confidence.

I am not aware of anyone actually publicly documenting a documentation
project previously so it should be quite an interesting thing to do.

I look forward to your comments

Kind Regards
Roger Caws

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