Bill Marchant wrote:
My problem is not with the Contribution Page, which has recently
been significantly improved, and looks just fine.
You apparently started with the Contribution Page on the main OOo
website, not the one at the Documentation Project. Not that it
matters; by following a link from either page to the Task List,
you end up in the same place.
Many of the items here appear to be quite trivial, for example:
Issue 27989 - Common, Editing text formats, Undo. (It is near the top of
the list, and is therefore an easy choice).
Question: Is it really as simple as describing Undo in terms of the
menu, toolbar and Keyboard?
Observation: Until someone writes this piece, presumably it is not put
in the manual;
Many (perhaps most) of the items on the task list (especially
those preceded by "Common:", "Writer:" etc) were intended to be
how-to's (short, stand-alone items) or tutorials (longer, more
detailed, but also stand-alone items), rather than parts of the
User Manual... although of course the information could be in the
User Manual as well. (When you open a task, you'll see under
"Subcomponent" in the upper left a term like "How To", so you
know what it is intended to be.)
The Task List needs a good clean-out to remove items that have
been superceded by other documentation. I believe Scott Carr was
planning to do this clean-out, but apparently he has not got
around to it. There was some discussion on this list in recent
months, but I don't recall the detail. I think one suggestion was
for people to pick some items on the task list and decide whether
those items are still needed, or if the topics are adequately
covered elsewhere, for example by an FAQ entry or the User Manual.
but I notice that it is already in an early version of
the User Manual 2 in at least twelve places.
Most of the tasks are dated around April 2004 and were probably
created before GRS put together the User Manual.
So how does a writer decide what is needed to complete this item?
Use your own judgement and make a recommendation on this list
(also in a comment on the Task itself). If items should be
removed from the Task List, one of the project members with the
authority to do that can mark them Closed. (I do not have the
needed authority to change the Status of these tasks.)
I have picked only one task to illustrate, but looking at the list, I
assume that there are many others of similar characteristics.
Yes, most of the items are like that, I think.
Incidentally, your suggestion that I work on the Contribution page was
well meant no doubt, but I have no expertise in Web Pages, and I must
therefore decline.
GRS and I were talking about the Documentation Project's
Contributing page,
http://documentation.openoffice.org/contributing.html
Rewriting the content of the Doc Project's page (if needed) could
be done without knowing anything about web pages or HTML, and one
of us (such as myself) could turn it into HTML and upload it.
Regards, Jean
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
