Re: FW: About ODFAuthors (was RE: Can we get this started again?)

[Keith N. McKenna]

Dennis E. Hamilton wrote:
> Jean Weber had an after-thought that might be useful to know.
> 
> I am forwarding it to the list with her permission.
> 
>  - Dennis
> 
>> -Original Message-
>> From: Jean Weber [mailto:jeanwe...@gmail.com]
>> Sent: Friday, January 22, 2016 17:10
>> To: orc...@apache.org
>> Subject: Re: Can we get this started again?
>>
>> Dennis,
>> More info, which may be relevant to any discussions on the AOO-Docs
>> list, which I am not following. You may forward this message if you
>> wish. I'm sure I've made these points on the list before, but people
>> may need reminding.
>>
>> Many people have the mistaken impression that "ODFAuthors" is a group
>> of people who produce documentation. It is not, although its
>> predecessor OOoAuthors was a group of people. ODFAuthors is a
>> *website* that provides space for groups of people to store files
>> during the documentation production process. The only group that has
>> been using the ODFAuthors website for several years is the LibreOffice
>> Documentation team. However, there is no reason why AOO docs people
>> can't use it too, if they wish; in fact, there has been a folder for
>> AOO set up there from the beginning.
>>
>> However, when talking about sharing files, there are licensing issues
>> that get in the way. I'm not going to go into the details, which are
>> fairly well known. But that is a separate matter from the possible or
>> potential use of the website.
>>
>> Lastly, the ODFAuthors website is not intended to be a distribution
>> point for published documentation. LibreOffice docs, for example, are
>> distributed through the TDF wiki and the LO website.
>>
>> Regards, Jean
Dennis;

Just checked the ODFAuthors site again. All the reference material
pointed to still specifies hat one of the following licenses are used by
them.

Creative Commons Attribution License, version 3.0 or later
http://creativecommons.org/licenses/by/3.0/
GNU General Public License, version 3 or later
http://www.gnu.org/licenses/gpl.html

Though I see some advantages to using the ODFAuthors site We just get
back into the age old argument over License, which is one reason the
initial effort to do Version 3.4 documentation there died.

Regards
Keith



signature.asc
Description: OpenPGP digital signature

FW: About ODFAuthors (was RE: Can we get this started again?)

[Dennis E. Hamilton]

Jean Weber had an after-thought that might be useful to know.

I am forwarding it to the list with her permission.

 - Dennis

> -Original Message-
> From: Jean Weber [mailto:jeanwe...@gmail.com]
> Sent: Friday, January 22, 2016 17:10
> To: orc...@apache.org
> Subject: Re: Can we get this started again?
> 
> Dennis,
> More info, which may be relevant to any discussions on the AOO-Docs
> list, which I am not following. You may forward this message if you
> wish. I'm sure I've made these points on the list before, but people
> may need reminding.
> 
> Many people have the mistaken impression that "ODFAuthors" is a group
> of people who produce documentation. It is not, although its
> predecessor OOoAuthors was a group of people. ODFAuthors is a
> *website* that provides space for groups of people to store files
> during the documentation production process. The only group that has
> been using the ODFAuthors website for several years is the LibreOffice
> Documentation team. However, there is no reason why AOO docs people
> can't use it too, if they wish; in fact, there has been a folder for
> AOO set up there from the beginning.
> 
> However, when talking about sharing files, there are licensing issues
> that get in the way. I'm not going to go into the details, which are
> fairly well known. But that is a separate matter from the possible or
> potential use of the website.
> 
> Lastly, the ODFAuthors website is not intended to be a distribution
> point for published documentation. LibreOffice docs, for example, are
> distributed through the TDF wiki and the LO website.
> 
> Regards, Jean


-
To unsubscribe, e-mail: doc-unsubscr...@openoffice.apache.org
For additional commands, e-mail: doc-h...@openoffice.apache.org

Re: Can we get this started again?

[archana nagarajan]

Thanks for the details, Keith. I will get started right away.

Regards
Archana

On Thu, Dec 10, 2015 at 1:23 PM, Keith N. McKenna  wrote:

> archana nagarajan wrote:
> > Hi,
> >
> > I am Archana. I used to work as an Assoc. Operations Manager/Middleware
> > Admin until I quit recently to raise my baby. I would like to work on
> your
> > documentation project. I have completed the orientation module.
> >
> > Please let me know what are the next steps
> >
> > Regards
> > Archana
> >
> >
> >
> Greetings Archana;
>
> The next steps are dependent on where you feel most comfortable. All of
> the Introductory material and the Writer Guide need to be accuracy
> checked against Version 4.1.2 of the OpenOffice software. This entails
> opening AOO 4.1.2 and then following the steps in the wiki page to make
> sure they indeed get the result proper result; eg. if the wiki says
> click file->save as to save a new document, does doing that in v4.1.2
> bring up the Save as Dialog for you to name the document and decide
> where to save it.
>
> If you are more interested in writing than there are numerous pages that
> either need to be written or sections expanded. If this is where your
> interest lies than check the status document and pick one that needs
> doing and start working on it. Just remember to add your signature to
> the Authors line and let the list know what you are going to work on and
> when you start and end.
>
> Lastly there is proof reading and editing a document. This entails
> reading the document for accuracy, and also for use of proper grammar
> and spelling etc. and then making those changes to the document.
>
> All of these roles need to be done for each separate wiki page. Rule of
> thumb is if you Author it someone else needs to proofread and Accuracy
> check it.
>
> The status document at
> https://wiki.openoffice.org/wiki/Documentation/UserGuide/Status is where
> we document what has been done and what still needs done for each page
> in the User Guides. Take a look at that and see what you feel
> comfortable attempting and go for it. Just remember to let the list know
> what you are working on and when you finish and to sign the status doc
> by entering 4 tildes next to what you did.
>
> Any questions you have or suggestions on how to make this process easier
> bring them to the list. *All* communication around the documentation
> should take place on this list so that all members of the team are aware
> of what is going on.
>
> Regards
> Keith
>
> 
>
>

Re: Can we get this started again?

[Keith N. McKenna]

archana nagarajan wrote:
> Thanks for the details, Keith. I will get started right away.
> 
> Regards
> Archana
> 
Fantastic. I look forward to seeing your work.

Regards
Keith

> On Thu, Dec 10, 2015 at 1:23 PM, Keith N. McKenna > wrote:
> 
>> archana nagarajan wrote:
>>> Hi,
>>>
>>> I am Archana. I used to work as an Assoc. Operations Manager/Middleware
>>> Admin until I quit recently to raise my baby. I would like to work on
>> your
>>> documentation project. I have completed the orientation module.
>>>
>>> Please let me know what are the next steps
>>>
>>> Regards
>>> Archana
>>>
>>>
>>>
>> Greetings Archana;
>>
>> The next steps are dependent on where you feel most comfortable. All of
>> the Introductory material and the Writer Guide need to be accuracy
>> checked against Version 4.1.2 of the OpenOffice software. This entails
>> opening AOO 4.1.2 and then following the steps in the wiki page to make
>> sure they indeed get the result proper result; eg. if the wiki says
>> click file->save as to save a new document, does doing that in v4.1.2
>> bring up the Save as Dialog for you to name the document and decide
>> where to save it.
>>
>> If you are more interested in writing than there are numerous pages that
>> either need to be written or sections expanded. If this is where your
>> interest lies than check the status document and pick one that needs
>> doing and start working on it. Just remember to add your signature to
>> the Authors line and let the list know what you are going to work on and
>> when you start and end.
>>
>> Lastly there is proof reading and editing a document. This entails
>> reading the document for accuracy, and also for use of proper grammar
>> and spelling etc. and then making those changes to the document.
>>
>> All of these roles need to be done for each separate wiki page. Rule of
>> thumb is if you Author it someone else needs to proofread and Accuracy
>> check it.
>>
>> The status document at
>> https://wiki.openoffice.org/wiki/Documentation/UserGuide/Status is where
>> we document what has been done and what still needs done for each page
>> in the User Guides. Take a look at that and see what you feel
>> comfortable attempting and go for it. Just remember to let the list know
>> what you are working on and when you finish and to sign the status doc
>> by entering 4 tildes next to what you did.
>>
>> Any questions you have or suggestions on how to make this process easier
>> bring them to the list. *All* communication around the documentation
>> should take place on this list so that all members of the team are aware
>> of what is going on.
>>
>> Regards
>> Keith
>>
>> 
>>
>>
> 




signature.asc
Description: OpenPGP digital signature

Re: Can we get this started again?

[Keith N. McKenna]

toki wrote:
> On 09/12/2015 03:09, Keith N. McKenna wrote:
> 
>> There are ways to document the differences where they exist.
> 
> This gets into what qualifies as a difference that is significant enough
> to mention:

Those are editorial decisions that would be have to be made out
collaboratively.

> # How many people realize that:
> *  different versions of Java behave differently. Doesn't matter if
> LibO, AOo, or EU are being used;
> * there are differences in LibO when using Windows, Mac OS X, Linux, and
> BSD;
> # User-installed extensions that alter built-in functionality, as a
> side-effect of what they are supposed to do;
> 
> All that said, with the appropriate use of styles --- roughly 40 of them
> --- one can visually indicate which version of which program on which OS
> a specific note refers to.

Notes are not the only way that it could be done.
> 
>> If all you are suggesting is that we just en mass move to LO I am not
> as sanguine.
> 
> In theory, ODFAuthors is program agnostic.
> 
In theory that is correct, however ODFAuthors as it is currently
constituted does have constraints that would need to be worked out.
> jonathon

Regards
Keith
> 




signature.asc
Description: OpenPGP digital signature

Re: Can we get this started again?

[archana nagarajan]

Hi,

I am Archana. I used to work as an Assoc. Operations Manager/Middleware
Admin until I quit recently to raise my baby. I would like to work on your
documentation project. I have completed the orientation module.

Please let me know what are the next steps

Regards
Archana



On Wed, Dec 9, 2015 at 10:11 AM, Keith N. McKenna  wrote:

> toki wrote:
> > On 09/12/2015 03:09, Keith N. McKenna wrote:
> >
> >> There are ways to document the differences where they exist.
> >
> > This gets into what qualifies as a difference that is significant enough
> > to mention:
>
> Those are editorial decisions that would be have to be made out
> collaboratively.
>
> > # How many people realize that:
> > *  different versions of Java behave differently. Doesn't matter if
> > LibO, AOo, or EU are being used;
> > * there are differences in LibO when using Windows, Mac OS X, Linux, and
> > BSD;
> > # User-installed extensions that alter built-in functionality, as a
> > side-effect of what they are supposed to do;
> >
> > All that said, with the appropriate use of styles --- roughly 40 of them
> > --- one can visually indicate which version of which program on which OS
> > a specific note refers to.
>
> Notes are not the only way that it could be done.
> >
> >> If all you are suggesting is that we just en mass move to LO I am not
> > as sanguine.
> >
> > In theory, ODFAuthors is program agnostic.
> >
> In theory that is correct, however ODFAuthors as it is currently
> constituted does have constraints that would need to be worked out.
> > jonathon
>
> Regards
> Keith
> >
>
>
>

Re: Can we get this started again?

[Mary Beth]

I am interested but just joined. I'm a professor and it's Final Exam week.
I can discuss after exams are over if that's okay. I've been meaning to get
caught up on reading first but I am behind.

Mary Moore
Garrett College
McHenry, MD
On Dec 7, 2015 7:54 PM, "Keith N. McKenna" 
wrote:

> Keith N. McKenna wrote:
> > Greetings All;
> >
> > I have always been told I am a glutton for punishment and I am going to
> > prove it once again. I firmly believe that we as a project need to
> > provide documentation for our users. With this goal in mind I would like
> > to propose that we get this effort underway again.
> >
> > To start with I propose that we concentrate on the Writer Guide and the
> > introductory material to get it finished and announced to our user base.
> > I will volunteer to take on the role of coordinator for this effort.
> >
> > I propose concentrating on Writer because it and Calc are most likely
> > the most used of the applications and with limited resources it is best
> > to put those out first.
> >
> > This will require a lot of communication but I feel it is an effort well
> > worth undertaking.
> >
> > I look forward to hearing any and all responses.
> >
> > Regards
> > Keith
> >
> As there have been no responses to this in two (2) weeks I have to
> conclude that there is little or no interest in seeing this
> documentation finished and released. This is truly disappointing.
>
> I will continue to monitor this list in hopes that this effort can
> either be re-started or re-configured to attract more active participants.
>
> Regards
> Keith
>
>
>