Jean,
    Thanks for your explanation.  You have made the system a bit clearer
for me.  I realize that in a world consisting of volunteers, some things
get done right away, and some have to wait.  Goodness knows, I am a
prime example of that criticism myself.
    These projects will only fly if we all participate.  I promise to do
better in the future, but I still think the revision of the contribution
page under documentation should be done by someone who has a better
understanding of the whole picture than I do. 
Bill Marchant

Jean Hollis Weber wrote:

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

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to