openoffice-doc mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Kay Schenk <kay.sch...@gmail.com>
Subject Re: Is it time to re-evaluate the viability of internal documentation?
Date Fri, 28 Mar 2014 21:19:17 GMT
On Fri, Mar 28, 2014 at 5:06 AM, HP <thecarpy@aim.com> wrote:

> Hi Guyz,
>
> I hope you are OK with me intervening here, I am "pretty new" to this
> thing.
>
> I think we need to, as a team, focus on one specific guide or per chapter.
> Split the work by chapter, once you have finished yours, ask if others need
> help.
> Maybe we could have someone check the Writer guide, for a start. I am not
> even sure where all this stuff is located in wiki.


The "new" guides are here:
https://wiki.openoffice.org/wiki/Documentation/UserGuide



> I have only just started and made very minor edits because I am trying to
> get used to the style and stuff.
>
> I am an experienced tech writer, with a consultant background. I do not
> have tons of time, but can help out here and there.
>

My primary interest at the moment is with the "internal" help. Like you, I
am just getting started with that.  When I get a bit further along, I hope
to share some ideas.

Out of curiosity, what documentation tools have you worked with or prefer?


>
>
> I think we need some structure somewhere, what do you think ? Just me two
> cents ;-)
>
> Regards,
>
> HP
>
>
>
> On 03/22/2014 11:01 PM, Kay Schenk wrote:
>
>> On Sat, Mar 22, 2014 at 12:53 PM, Dave <davepolit@gmail.com> wrote:
>>
>>  I'm not sure, but possibly the first step would be to have a list of all
>>> the best documentation so far. I personally don't use documentation much,
>>> just google around. I do use the internal Help of OpenOffice though. What
>>> are the average user's habits? If I were to use documentation, I guess it
>>> wouldn't be general documentation, but ratther documentation on how to
>>> solve specific tasks.
>>>
>>>  Good points. Maybe the topic of another survey?
>>
>>
>>
>>  On 22 March 2014 17:54, Keith N. McKenna <keith.mckenna@comcast.net>
>>> wrote:
>>>
>>>  Andrea Pescetti wrote:
>>>>
>>>>> On 19/03/2014 Keith N. McKenna wrote:
>>>>>
>>>> <snip>
>>>>
>>>>> In other fields we notice that it is important to involve and empower
>>>>> new volunteers quickly and easily. For example, a new documentation
>>>>> volunteer would now have the problem that he needs a wiki account
>>>>> created (and he needs someone to do it, since registration is currently
>>>>> disabled) and then a welcome message on what to do, and then a list of
>>>>> tasks...
>>>>>
>>>>> If the more active people here could have all necessary privileges to
>>>>> answer prospective volunteers with a "Welcome, we created a wiki
>>>>>
>>>> account
>>>
>>>> for you, a couple of small tasks that you can do to start are X and Y",
>>>>> this would be much more effective.
>>>>>
>>>>>  I should have all the necessary privileges, at last on the mwiki. The
>>>> problem I see is that I am just about the only person active right now
>>>> and I am tired of putting fourth the effort to draw people in and in
>>>> better than 80% of cases nothing comes of it. I am willing to try again,
>>>> but I can not do it alone. We need to be able to attract experienced
>>>> technical writers that can guide volunteers.
>>>>
>>>>  Should you wish to try it, let us know and we'll look into what's
>>>>>
>>>> needed
>>>
>>>> to give you (Keith, or other active volunteers who want to take care of
>>>>> this) the necessary privileges.
>>>>>
>>>>> Regards,
>>>>>    Andrea.
>>>>>
>>>>
>>>>
>>>>
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: doc-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: doc-help@openoffice.apache.org
>
>


-- 
-------------------------------------------------------------------------------------------------
MzK

"Cats do not have to be shown how to have a good time,
 for they are unfailing ingenious in that respect."
                                       -- James Mason

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message