Proposed Revision of Writer Guide

Hi :slight_smile:
I do like the way you all have set the documentation up so that people can
download chunks of around 30 pages quite quickly to help them learn about a
specific issue or deal with 1 problem.

Having the option to download or buy an entire guide such as Writer is great. I
don't see the advantage in splitting those large guides into smaller chunks
until the guides reach the size of MS Office's vast tomes. I think it would
just make things confusing especially when some people think macros are very
basic but others don't. Could the intended effect be achieved just by putting
"(Advanced)" in the chapters' titles?

Regards from
Tom :slight_smile:

Hi :slight_smile:
I do like the way you all have set the documentation up so that people can
download chunks of around 30 pages quite quickly to help them learn about a
specific issue or deal with 1 problem.

Having the option to download or buy an entire guide such as Writer is great. I
don't see the advantage in splitting those large guides into smaller chunks
until the guides reach the size of MS Office's vast tomes. I think it would
just make things confusing especially when some people think macros are very
basic but others don't. Could the intended effect be achieved just by putting
"(Advanced)" in the chapters' titles?

As I said to David earlier in this thread, one book could have two
"parts"; that's another variation on my proposal

My main reason for proposing two books is that many people may be more
likely to download or buy a shorter, less expensive, and less
formidable-seeming book.

Of course, given that most people won't read a book anyway, I suppose it
doesn't really matter. :wink:

--Jean

Hi :slight_smile:
I think the price is very reasonable given that competitors guides probably cost
a huge amount more. If people are really bothered about price then downloading
is free. We can't get much lower than that! Also i don't think the price would
be reduced by very much except, perhaps, for the Advanced one.

Perhaps offering an Advanced Users guide might be good? But i think those same
chapters should also be in the basic users guide rather than excluded from it.
Perhaps it could pull in chapters from some of the other guides? Perhaps 1
"Advanced Users - Getting Started Guide" which might be a tiny pamphlet and then
a separate "Advanced Users in Depth"?
Regards from
Tom :slight_smile:

Hi,

My main reason for proposing two books is that many people may be more
likely to download or buy a shorter, less expensive, and less
formidable-seeming book.

I see the downloaders and the book buyers as being different targets,
probably with different habits.

Speaking about myself when I download documentation. I prefer to get
one large PDF containing all the info and being easily navigable with
links in the TOC and cross-references in the text, where appropriate.
I don't particularly want to download and open several docs when
researching the same subject.

My perception of the book buyer market is that they'd be likely to be
tempted either by very advanced reference works containing material
that might not get into the normal user's guide.

Alternatively, they'd perhaps be up for things like printed memory
joggers and "quick reference material" to have at hand or on a wall
nearby. You can probably image the kind of material I'm thinking of -
the kind of stuff it's really most convenient to have on paper rather
than on-screen.

Or perhaps tackle the real beginners market with kind-of "Dummy's
Guide" type books or text books suitable for children and students?

But, for me at least, it would fall into a niche apart from our
standard documentation such as we're working up at the moment.

Anyway, those were just a few additional reflections...

Of course, given that most people won't read a book anyway, I suppose it
doesn't really matter. :wink:

Well, I'm not sure that's necessarily entirely true... as I said
above, perhaps it's more a question of identifying user bases who
prefer to work with printed material, and material that is more
meaningful, practical and useful when it's on paper, on your wall,
etc...

Carrying on my train of thought...

For instance, in our guides, we provide very generic information
targeting a general user base. So how about special guides targeting
particular user bases?

A guide, covering all the LibO components for students writing a
thesis? For a small business or SOHO looking to its admin and
accounting needs? For engineers working on a design project? For a
school's course needs? Etc... The books would be backed-up by
downloadable or CD-ROM-based accompanying templates, spreadsheets,
databases, presentations, etc.

I think this is the kind of stuff that might well sell well in book
form. And imagine if we had school and university text books to
offer... that might notch up a bit more in sales, too...

HTH...

I totally agree with you about the desirability of targeted guides or
tutorials; I've been advocating them for years, both here and at OOo.
Again, the problem is finding people with the combination of background
knowledge, writing skills, and time to put together suitable work.

http://wiki.services.openoffice.org/wiki/Documentation/Dashboard/Tutorials/Targeted

--Jean

Just to make clear to everyone what I mean by "background knowledge":
when writing for a specific audience, knowing what that audience's
actual needs are (what specific tasks they may wish to perform), and
knowing the terminology used by that audience, is very helpful for
creating relevant information at the right level... and in many cases
much more important than simply knowing how to use the software.

I have seen a lot of answers on the OOo forums from people who clearly
did not understand the question they were answering, because the
question is on a topic outside their background knowledge; so the answer
may be "correct" (in terms of how the software works) but irrelevant
because it does not actually answer the question. I've also seen this
problem frequently in third-party books.

Of course, a team of people can often do the job better than one person:
some members of the team may know the questions (and possibly the
answers), while others may know how to achieve the necessary results
using the software but not be skilled in writing in English, and yet
others might be better able to do the writing once they have the
necessary information.

--Jean

Hi :slight_smile:
+1
Also work that is "too obvious" (low level) or goes off in a 'wrong' direction
is likely to be useful in other guides or short pamphlets aimed at other
specific groups.

Regards from
Tom :slight_smile:

Hi everyone,

Just wanted to let you all know that I do have a draft copy of my Conceptual Guides ported for LibreOffice and is just about ready for uploading. It will include a number of hands-on lessons that can be used by either individual users or in an academic environment for learning to use LibreOffice. There are lessons for use with Writer, Calc, Impress and Base. I am also in the process of writing several more lessons to accompany what I have already written.

David - what do I need to do to setup myself up with a user account for Alfresco so that I can begin to upload the drafts? If you need to set me up with an account, you can use ggurley as my username. Moreover, if you need to, feel free to contact me offlist for any additional information.

Once I have a draft of these hands-on lessons uploaded, I will give everyone a status report of the work, including the other lessons I am working on, as well as provide information regarding some ancillary resources I am developing that will accompany these lessons.

Best regards,
Gabriel Gurley

Hi Gabriel,

David - what do I need to do to setup myself up with a user account for Alfresco so that I can begin to upload the drafts?  If you need to set me up with an account, you can use ggurley as my username.  Moreover, if you need to, feel free to contact me offlist for any additional information.

I created your account, you're good to go. I'm mailing you the
credentials now. Thanks for your work.

Hello,

Please give the list a link after loading the files?

Thanks,

Will do. I hope to have the draft of the lessons uploaded within the next couple of days or so. Once I have completed doing so, I'll send out a link.

Thanks,
Gabriel