Re: New Doc Volunteer

[Jean Weber]

AOO does not allow CC licensed material. That’s a major part of the problem
of reuse. However, the body of documentation is also licensed under GPL,
which is sort-of allowed, with restrictions.

Jean

On Fri, 22 Jan 2021 at 15:52 F Campos Costero  wrote:

> Hello Robert,
>
> Thank you very much for volunteering!  I'll keep this message very brief
> because I am at the end of a long work day and not feeling very coherent.
> Regarding your question, it is probably best to consider what the likely
> situation will be rather than all possible licensing scenarios. There is a
> body of documentation licensed under the Creative Commons Attribution
> License (CC-BY) (http://creativecommons.org/licenses/by/3.0/ ) that would
> provide a rich resource for documenting the current version of OpenOffice.
> The current plan, I believe, is to work under the permissions of that
> license. You would have a copyright to what you write but you would license
> many of those rights to anyone who has a copy of your work. Please take a
> look at the web page I linked and perhaps the license itself. I'm sure
> people here would be happy to discuss any questions you have, though I
> don't think we have any lawyers on this list.
> Regards,
> Francis
>
> On Thu, Jan 21, 2021 at 8:53 PM Robert Farrell <
> robertfarr...@embarqmail.com>
> wrote:
>
> > Hi all,
> >
> > I’m a technical writer who has worked on documentation for medical
> devices
> > and software. I have been using OpenOffice for several years for other
> > projects, and have always appreciated the open source nature of the
> > software.
> >
> > I have never worked on a project where documentation is licensed.
> > Everything I’ve worked on has been work-for-hire and copyrighted (which
> > means, of course, no attributions) as opposed to licensing. What do I
> need
> > to take into consideration when creating documentation for this project?
> >
> > Thanks
> >
> >
> > Robert Farrell
> > robertfarr...@embarqmail.com
> >
> >
>

Re: New Doc Volunteer

[F Campos Costero]

Hello Robert,

Thank you very much for volunteering!  I'll keep this message very brief
because I am at the end of a long work day and not feeling very coherent.
Regarding your question, it is probably best to consider what the likely
situation will be rather than all possible licensing scenarios. There is a
body of documentation licensed under the Creative Commons Attribution
License (CC-BY) (http://creativecommons.org/licenses/by/3.0/ ) that would
provide a rich resource for documenting the current version of OpenOffice.
The current plan, I believe, is to work under the permissions of that
license. You would have a copyright to what you write but you would license
many of those rights to anyone who has a copy of your work. Please take a
look at the web page I linked and perhaps the license itself. I'm sure
people here would be happy to discuss any questions you have, though I
don't think we have any lawyers on this list.
Regards,
Francis

On Thu, Jan 21, 2021 at 8:53 PM Robert Farrell 
wrote:

> Hi all,
>
> I’m a technical writer who has worked on documentation for medical devices
> and software. I have been using OpenOffice for several years for other
> projects, and have always appreciated the open source nature of the
> software.
>
> I have never worked on a project where documentation is licensed.
> Everything I’ve worked on has been work-for-hire and copyrighted (which
> means, of course, no attributions) as opposed to licensing. What do I need
> to take into consideration when creating documentation for this project?
>
> Thanks
>
>
> Robert Farrell
> robertfarr...@embarqmail.com
>
>
>
>
> -
> To unsubscribe, e-mail: doc-unsubscr...@openoffice.apache.org
> For additional commands, e-mail: doc-h...@openoffice.apache.org
>
>

Re: New Doc volunteer

[Keith N. McKenna]

On 2/2/2018 5:36 PM, Chris Johnson wrote:
> Hi listmembers!
> Please allow me to introduce myself...my name is Chris Johnson and I'm a
> tech writer with over 10 years of experience. (I also have a decent amount
> of QA experience.) I've been out of the TW field since 2011 but
> am currently veering back into the field and would love to contribute in
> any way I can to this effort! I live in Massachusetts and am enjoying a
> nice winter day here. Thanks for reading this and hope I can help out soon.
> Chris Johnson
> 
Welcome Chris;

Unfortunately the documentation effort has been stalled for quite a
while now for a number of reasons. Hopefully having a volunteer with
extensive technical writing experience can help jump start this effort.

The original intent was to Redo the 4.X user documentation from scratch
on our MediaWiki site under the ALV2 License. Because of the difference
in License from the OpenOffice.org documentation we can not just update
the older documentation for version 4.

The current version 4 User documentation is linked  at
https://wiki.openoffice.org/wiki/Documentation/UserGuide there is also a
status document at
https://wiki.openoffice.org/wiki/Documentation/UserGuide/Status.

Your thoughts on what can be improved and your contributions to the
documentation as it stands would be greatly appreciated.

I am also in Massachusetts. I live in Palmer, just east of Springfield
in Western MA.

Regards
Keith McKenna




signature.asc
Description: OpenPGP digital signature

Re: New Doc Volunteer

[Keith N. McKenna]

On 9/14/2017 10:49 AM, Famiglietti, Andrew A wrote:
> Hi Open Office Doc Team,
> 
> 
> I'm a professor in the English Department at West Chester University of 
> Pennsylvania, and I'm planning to use Open Source Software documentation as a 
> "real world" writing task for my Technical Writing Students this semester. I 
> noticed your project was looking for documentation help and thought I would 
> reach out. Some things you should know:
> 
> 
> - I'm not going to swamp you with student contributions. Students will file 
> their drafts with me, first, and then I will pass them on to you only if I 
> think they have a reasonably good end product, and I have an ok from the 
> project?
> 
> 
> I was wondering:
> 
> 
> - If you would be interested in seeing the documentation drafts students 
> produce
> 
> - If there was any particular area of documentation you were particularly in 
> need of
> 
> 
> Thanks so much for your time!
> 
> 
> 
> 
> ---
> Andy Famiglietti, PhD
> Assistant Professor of English, West Chester University
> http://copyvillain.org
> 
Professor Famiglietti;

First let me apologize for taking so long to reply to your message.
Things in my personal life have been such that I have not had as much
time as I would like to spend with Apache OpenOffice.

The current state of the documentation effort is that it is at a
standstill. A decision was made around the end of 2012, beginning of
2013 that new documentation would be started on the Apache OpenOffice
Media-Wiki under the Apache License, Version 2.0. This effort has
stalled due to the lack of experienced technical writers to guide and
mentor new volunteers.

The idea was to have documentation structured for on-line viewing using
liberal hyper-links to guide people from the generic to the specific
rather than separate detailed guides for each separate Application
within the suite. This structure does not lend itself well to the flow
that you describe but I would be willing to take the output from
students that you approve and format it for inclusion into the wiki.

I would also be interested in discussing further with you any other
insights or ideas that you might have to move the documentation effort
forward again.

Regards
Keith N. McKenna




signature.asc
Description: OpenPGP digital signature

Re: New Doc Volunteer

[Keith N. McKenna]

On 8/9/2017 7:17 PM, Steve Stepan Kehayan wrote:
> Dear Sir/Madam,
> 
> I've been writing and editing reports, documents, articles and publications 
> for the last 25 years. I’m originally from Singapore but I’ve been living and 
> working in Europe and Asia for the last 20 years. I’ve just relocated with my 
> family to California and would like to do volunteer my time to gain 
> experience in technical writing and to learn more about the software 
> industry. I have a PhD in Applied Linguistics and a strong background in 
> authoring and editing complex documents. I’m confident that I’ll be able to 
> hone my skills in authoring, reviewing and editing draft documents for you. 
> I’m familiar with the AP and Chicago Writing Styles but I’ll be able to adopt 
> your house style if you have one. Though I have little knowledge of 
> OpenOffice, I’m a keen and quick learner.
> 
> 
> Please get back to me if there is a opportunity for me to contribute.
> 
> Thank you.
> Best wishes,
> 
> Annette
> 
Annette;

As you have probably noticed this mailing list is very inactive.
Currently our User Guide effort is is housed on our Media Wiki (mwiki)
at the following
url:https://wiki.openoffice.org/wiki/Documentation/UserGuide. There is a
status document at
https://wiki.openoffice.org/wiki/Documentation/UserGuide/Status that
shows the current status of effort.
Please understand that the project does not have the resources to mentor
contributors in the intricacies of the discipline of Technical Writing.
You need to be a self starter that can see what needs to be done and
then go do it. If you have questions this is the place to ask them. It
is also the place to let people know what you are doing and what your
progress is.

The following links will give you a broad overview of the effort and
the minimal style requirements.

https://wiki.openoffice.org/wiki/Documentation/Contribute
https://wiki.openoffice.org/wiki/Documentation/Dashboard/Help_Style_Guide
https://wiki.openoffice.org/wiki/Documentation/Dashboard/Styles#Styles_used_in_the_Documentation_Project_Wiki
The following link is an indispensable reference on the style used on
the documentation wiki and a reference of the many different shortcut
templates that are used for such things as notes, warnings, etc.
https://wiki.openoffice.org/wiki/Documentation/Dashboard/Wiki_Editing_Policy

Regards
Keith






signature.asc
Description: OpenPGP digital signature

Re: New Doc Volunteer

[Dave]

Dear Andrew,

over a period of seven years (14 university terms) I developed a
documentation specially aimed at students, though not students in science
courses. It is available in five languages so far, I myself did the German,
English and French versions. It includes an online exercise, though I
myself did a live introductory course (in my last batch it was altogether
14 groups of around 20 to 30 students, two or three per pc). In the first
hour or so I did just a little bit of theory (what is a book?), then
demonstrated the parallels between between book production without
computers and that with computers. In the second hour they would repeat the
exercise two or three or even four students together round one pc, and I
would just stand around in the background in case they got stuck somewhere.
The exercise was over time so explicit though, that mostly they got along
without my help. Would be pleased, if you might take a look at it:

http://openoffice-uni.org/

Yours
Dave

On 14 September 2017 at 15:49, Famiglietti, Andrew A  wrote:

> Hi Open Office Doc Team,
>
>
> I'm a professor in the English Department at West Chester University of
> Pennsylvania, and I'm planning to use Open Source Software documentation as
> a "real world" writing task for my Technical Writing Students this
> semester. I noticed your project was looking for documentation help and
> thought I would reach out. Some things you should know:
>
>
> - I'm not going to swamp you with student contributions. Students will
> file their drafts with me, first, and then I will pass them on to you only
> if I think they have a reasonably good end product, and I have an ok from
> the project?
>
>
> I was wondering:
>
>
> - If you would be interested in seeing the documentation drafts students
> produce
>
> - If there was any particular area of documentation you were particularly
> in need of
>
>
> Thanks so much for your time!
>
>
>
>
> ---
> Andy Famiglietti, PhD
> Assistant Professor of English, West Chester University
> http://copyvillain.org
>

Re: New Doc Volunteer

[Keith N. McKenna]

Chris Sirrs wrote:
> Hello,
> 
> My name is Chris. I am a recent university grad interested in
> getting my feet wet in the world of technical writing by volunteering
> to create and edit documentation for open source projects such as
> Open Office. If there is anything I can help with in this regard,
> feel free to let me know.
> 
> -Chris
> 

Welcome to the AOO Documentation team. First of all let me apologize for
taking so long to reply. Things have been very hectic in my personal
life the last month or so.

Currently the major thrust has been to get the introductory materials
and the Writer Guide Finished on
the M-wiki at https://wiki.openoffice.org/wiki/Documentation/UserGuide.
We also have a status page at
https://wiki.openoffice.org/wiki/Documentation/UserGuide/Status which
shows a broad overview of what still needs to be done.

The AOO context sensitive help is a somewhat convoluted process. I will
have to dig into the materials that I have to point you to further
information.

Feel free to jump in look around and work on anything that you think
could use some help. This mailing list is the main means of
communication for the team so please if you have any questions feel free
to ask and given your experience any insights that you may have are most
welcome.

Regards
Keith



signature.asc
Description: OpenPGP digital signature

RE: New Doc Volunteer

[Dennis E. Hamilton]

Hello, Rishabha Singh,

The doc@openoffice.apache.org list is for those who want to work on 
documentation for Apache OpenOffice.  The current documentation work is at 
 under "What's New".  The main 
documentation is all in English.

With your Java experience, you might be interested in the UnoTools work.  To 
find out about that, please introduce yourself on  
where development is discussed.

 - Dennis

> -Original Message-
> From: RISHABHA SINGH [mailto:rishabha.sing...@gmail.com]
> Sent: Monday, March 14, 2016 23:25
> To: doc@openoffice.apache.org
> Subject: New Doc Volunteer
> 
> Hi Sir
> I try to introduce in clear manner. I am Rishabha Singh. I am from UP ,
> India . I am a quite java programmer .
> And also I am interested in java Developing . Currently I am working in
> Vstacks InfoTech Noida, India as a java junior developer . I like solve
> difficulties in a opposite environment .  that’s all about me sir .
> Regards & thanks
> Rishabha Singh


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

Re: New Doc Volunteer

[Keith N. McKenna]

Elaine Morin wrote:
> Hello,
> My name is Elaine Morin, I'm from Edmonton, AB, Canada, and my background is 
> in writing. I'm hoping to work on some documentation projects for Open 
> Office. I'm working on strengthening my writing portfolio, so I'm interested 
> in writing about technical projects, which I'm sure I'll find here :)
> 
> Cheers,
> Elaine  
> 
Hi Elaine;

We certainly can use an experienced writer. The current priority is to
get the Introductory pages for the User Guide, and the detailed Writer
Guide pages completed and released. There is a status page for
everything at
https://wiki.openoffice.org/wiki/Documentation/UserGuide/Status. The
User Guide pages themselves are linked from the Status Doc and are also
found at https://wiki.openoffice.org/wiki/Documentation/UserGuide.
This mailing list is our main communication channel. All questions or
discussion should take place here so that all members of the team can
participate.

Again welcome and feel free to dive in and if you have questions or
suggestions etc. Please ask hear.

Regards
Keith N. McKenna




signature.asc
Description: OpenPGP digital signature

Re: New Doc Volunteer

[Keith N. McKenna]

Bilal Coleman wrote:
> Hi everyone,
> 
> My name is Bilal. I'm new to the doc team and I'd love to be brought up to
> speed with any current projects or assistance that I can provide.
> 
> Thanks,
> 
Bilal;

First let me apologize for the lateness of this response. The
documentation list has been very quiet and I have had personal things
that have kept me from being as active as I would like.

The documentation effort has been stalled for a while now or a myriad of
reasons. I intend to try and restart the effort with a message to the
list in the next few days.

The major project is to finish the User Guide that is currently on the
MWiki. The best starting place if you have not done it is to read the
Orientation Guide that can be found here:
http://openoffice.apache.org/orientation/intro-doc.html. Once you have
done that and have signed up for the wiki accounts, you can take a look
at where we are currently with the Guide here:
https://wiki.openoffice.org/wiki/Documentation/UserGuide

I look forward to working with you on this important piece of Apache
Open Office.

Regards
Keith N. McKenna




signature.asc
Description: OpenPGP digital signature

Re: New Doc Volunteer

[Amy Mason]

Hi Keith,

Thank you for your help. I’ve had a look at the User Guide on the MWiki and 
have made a start on the Writer Guide. I noticed there are a lot of links on 
the guide to other pages on the Wiki and I’m just wondering if this is the 
layout you want to keep or if the different sections (Working with Text, 
Working with Frames and Sections, etc) should be all accessible in one place 
(the main page for Writer for example?)?

Kind regards,

Amy

> On 20 Nov 2015, at 17:36, Keith N. McKenna  wrote:
> 
> Amy Mason wrote:
>> Hello OpenOffice.org Documentation Team,
>> 
>> My name is Amy Mason and I am currently studying English Language and
>> Literature at the University of Sunderland.
>> 
>> I am sending this email as I would love to write for OpenOffice.org's
>> documentation team. As a current English student, I am constantly
>> using OpenOffice to write, edit and proofread assignments and
>> reports. I would love to use these skills by working with the
>> OpenOffice documentation team to create user guides and manuals. I
>> also want to immerse myself in technical writing and I would
>> appreciate any opportunity at OpenOffice to practice this.
>> 
>> If you need my CV or any other information, I am more than happy to
>> provide it. You can contact me at this email, mason...@icloud.com.
>> 
>> Kind regards,
>> 
>> Amy Mason
>> 
> Greetings Again Amy;
> 
> The documentation effort has been stalled for a while now or a myriad of
> reasons. I intend to try and restart the effort with a message to the
> list in the next few days.
> 
> The major project is to finish the User Guide that is currently on the
> MWiki at https://wiki.openoffice.org/wiki/Documentation/UserGuide 
> .
> 
> I look forward to working with you on this important piece of Apache
> Open Office.
> 
> Regards
> Keith N. McKenna

Re: New Doc Volunteer

[Keith N. McKenna]

Amy Mason wrote:
> Hello OpenOffice.org Documentation Team,
> 
> My name is Amy Mason and I am currently studying English Language and
> Literature at the University of Sunderland.
> 
> I am sending this email as I would love to write for OpenOffice.org's
> documentation team. As a current English student, I am constantly
> using OpenOffice to write, edit and proofread assignments and
> reports. I would love to use these skills by working with the
> OpenOffice documentation team to create user guides and manuals. I
> also want to immerse myself in technical writing and I would
> appreciate any opportunity at OpenOffice to practice this.
> 
> If you need my CV or any other information, I am more than happy to
> provide it. You can contact me at this email, mason...@icloud.com.
> 
> Kind regards,
> 
> Amy Mason
> 
Greetings Again Amy;

The documentation effort has been stalled for a while now or a myriad of
reasons. I intend to try and restart the effort with a message to the
list in the next few days.

The major project is to finish the User Guide that is currently on the
MWiki at https://wiki.openoffice.org/wiki/Documentation/UserGuide.

I look forward to working with you on this important piece of Apache
Open Office.

Regards
Keith N. McKenna



signature.asc
Description: OpenPGP digital signature

Re: New Doc Volunteer

[David Lloyd-Jones]

Heather,

Welcome.

Three things:

Read Strunk and White, maybe once a year until the cover falls off.
Read Fowler's English Usage once a decade.
Get the Chicago Manual of Style, skim it once, and use it once or twice a
week forever.

That was the three main things.  The basic things that every editor needs.
George Orwell's Why I Write, and his diaries won't do you any harm,
either.  Carol Loomis is one of my heroes, both as an editor and as an
interviewer: she's the one who demonstrated for the whole world to see what
joyful devastation you can commit simply by knowing more about banking,
say, than the poor shlub banker in the other chair.  The many books and
articles on Shawn at the New Yorker can also teach you what the standards
are...

Knock 'em all dead.

Good luck with your career.

-dlj.


On 15 November 2014 15:24, Heather Bloomer heather.e.bloo...@gmail.com
wrote:

 Hi my name is Heather.  I live in Rockland County Ny.  I have an A.S.
 degree in Internet Technology with an option in E-Commerce administration.
 I have decided that I would like to pursue the career path of Technical
 writing in the Information Technology field.  I would like to volunteer my
 time to gain experience and help the open source project Apache Open Office
 and further my skills and knowledge base.  I have experience with :
 Usage and knowledge base of HTML, XHTML, DHTML, HTML 4.0  5, CSS 2  3,
 Java, and CGI/Perl, Technical Writing

 Ability to work with Microsoft Windows, Mac OSx and Linux environments

 Knowledge of and experience with comprehensive computer skills and
 troubleshooting

 Experience in being able to research and implement solutions

 Ability to work independently, make informed decisions, ask for guidance,
 if needed and follow given instructions

 PC maintenance, build, add, replace internal components

 Installation and configuration of wireless/wired network adapters in
 Windows, Mac OSx, and Linux

 Good organizational and communication skills

 Good customer-relations background



 I look forward to becoming part of the volunteer community!


 Thank you,

 Heather Bloomer

Re: New Doc Volunteer

[Andrea Pescetti]

On 17/10/2014 Steve Wolf wrote:

I would love to volunteer my time (Which I have plenty of) learning
documentation writing. I have strong English writing skills and
technical knowledge. Thank you for the opportunity.


Plenty of time? Sounds very good, and as you can guess from the delay 
other people do not have plenty of time at the moment, so thank you for 
your patience.


I suggest that you start by reviewing our current effort:
https://wiki.openoffice.org/wiki/Documentation/UserGuide
You will find a lot of pages to fix and complete. Please take a look and 
then come back to the doc list with some ideas on what you would fix or 
extend (many pages are yet to be written).


You will need a MWiki account to edit pages: just ask for it here on 
list and we can create one for you.


Regards,
  Andrea.

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

Re: New Doc Volunteer

[Keith N. McKenna]

Andrea Pescetti wrote:
 On 17/10/2014 Steve Wolf wrote:
 I would love to volunteer my time (Which I have plenty of) learning
 documentation writing. I have strong English writing skills and
 technical knowledge. Thank you for the opportunity.
 
 Plenty of time? Sounds very good, and as you can guess from the delay
 other people do not have plenty of time at the moment, so thank you for
 your patience.
 
 I suggest that you start by reviewing our current effort:
 https://wiki.openoffice.org/wiki/Documentation/UserGuide
 You will find a lot of pages to fix and complete. Please take a look and
 then come back to the doc list with some ideas on what you would fix or
 extend (many pages are yet to be written).
 
 You will need a MWiki account to edit pages: just ask for it here on
 list and we can create one for you.
 
 Regards,
   Andrea.
Forwarding to steve who is not subscribed yet



signature.asc
Description: OpenPGP digital signature

Re: New Doc Volunteer

[Andrea Pescetti]

On 23/06/2014 Shyam Sindha wrote:

I'm looking to help with technical writing, copy-editing, proof reading
etc. I have a bachelors degree in Physics, with some experience of coding.
However my biggest strengths are definitely spelling and grammar.


Thanks! You will receive credentials for our documentation wiki in a few 
minutes. Please tell us if you don't receive it.


We have a list of pages that need proofreading right now, sent by Keith 
to this mailing list. So you could help with proofreading this page:

https://wiki.openoffice.org/wiki/Documentation/UserGuide/UI

Please do your edits directly on the page, and let us know if you need 
help or you have any doubts. And when you are ready for another task, 
just tell us.


If you don't want to miss announcements you should subscribe to this 
mailing list: send an empty e-mail message to 
doc-subscr...@openoffice.apache.org and respond to the confirmation 
request you will receive.


Regards,
  Andrea.

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

RE: New Doc Volunteer

[Yuko Imai]

Thank you for your welcome message, Keith.

One question--as the Introduction to Contributing to Apache OpenOffice page, 
do I need to introduce myself to d...@openoffice.apache.org even after I 
already did to doc@openoffice.apache.org?

Kind regards,
Yuko


-Original Message-
From: Keith N. McKenna [mailto:keith.mcke...@comcast.net] 
Sent: Tuesday, June 03, 2014 5:18 AM
To: doc@openoffice.apache.org
Subject: Re: New Doc Volunteer

Yuko Imai wrote:
 Hi,
 
  
 
 I've just joined the Documentation mailing list. My name is Yuko, a 
 technical writer living in Australia.
 
 My specialised area for writing is software, hardware, general topics, etc.
 
  
 
 I have not learned much about this volunteer activities, but I would 
 be interested in:
 
  
 
 .  Write or update documentation
 
 .  Maintain the website and develop new materials
 
  
 
 Since I'm new,  I would be grateful if I could receive some advice to 
 get started.
 
  
 
 Warm regards,
 
 Yuko
 
 
Yuko;

Welcome to the Apache OpenOffice documentation list. I would direct you to the 
following page for more information on volunteering and areas available. 
http://openoffice.apache.org/orientation/index.html.

The level 1 and level 2 pages will give you a good overview of how Apache works 
and the various technical infrastructure we have. The level
3 page http://openoffice.apache.org/orientation/intro-doc.html will give you 
more information on the documentation team and the areas that we cover.

This list is where questions and discussion on all things documentation happen 
so please come back often and ask questions or let us know what you would like 
to work on.

For more information on website maintenance and development I would suggest 
that you subscribe send an inquiry to the development mailing list as most of 
the volunteers that do that work are most likely to be found there. Many of 
them do monitor this list, but you will probably get a quicker response from 
the dev list. To subscribe send a blank e-mail to 
mailto:dev-subscr...@openoffice.apache.org and follow the instructions in the 
follow-up e-mail you will receive. To post to the list use the following 
address:mailto:d...@openoffice.apache.org.

Again welcome and I look forward to working with you.

Regards
Keith N. McKenna







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

Re: New Doc Volunteer

[Keith N. McKenna]

Yuko Imai wrote:
 Thank you for your welcome message, Keith.
 
 One question--as the Introduction to Contributing to Apache OpenOffice 
 page, do I need to introduce myself to 
 dev-jnqqrfibojosbzieg410zs0vgnn6c...@public.gmane.org even after I already 
 did to doc-jnqqrfibojosbzieg410zs0vgnn6c...@public.gmane.org?
 
 Kind regards,
 Yuko
 
 
 -Original Message-
 From: Keith N. McKenna 
 [mailto:keith.mckenna-wuw85uim5zdr7s880jo...@public.gmane.org] 
 Sent: Tuesday, June 03, 2014 5:18 AM
 To: doc@openoffice.apache.org
 Subject: Re: New Doc Volunteer
 
 Yuko Imai wrote:
 Hi,

  

 I've just joined the Documentation mailing list. My name is Yuko, a 
 technical writer living in Australia.

 My specialised area for writing is software, hardware, general topics, etc.

  

 I have not learned much about this volunteer activities, but I would 
 be interested in:

  

 .  Write or update documentation

 .  Maintain the website and develop new materials

  

 Since I'm new,  I would be grateful if I could receive some advice to 
 get started.

  

 Warm regards,

 Yuko


 Yuko;
 
 Welcome to the Apache OpenOffice documentation list. I would direct you to 
 the following page for more information on volunteering and areas available. 
 http://openoffice.apache.org/orientation/index.html.
 
 The level 1 and level 2 pages will give you a good overview of how Apache 
 works and the various technical infrastructure we have. The level
 3 page http://openoffice.apache.org/orientation/intro-doc.html will give you 
 more information on the documentation team and the areas that we cover.
 
 This list is where questions and discussion on all things documentation 
 happen so please come back often and ask questions or let us know what you 
 would like to work on.
 
 For more information on website maintenance and development I would suggest 
 that you subscribe send an inquiry to the development mailing list as most of 
 the volunteers that do that work are most likely to be found there. Many of 
 them do monitor this list, but you will probably get a quicker response from 
 the dev list. To subscribe send a blank e-mail to 
 mailto:dev-subscr...@openoffice.apache.org and follow the instructions in the 
 follow-up e-mail you will receive. To post to the list use the following 
 address:mailto:dev-jnqqrfibojosbzieg410zuyczh3rj...@public.gmane.org
 
 Again welcome and I look forward to working with you.
 
 Regards
 Keith N. McKenna
 
You are entirely welcome Yuko. It would be a good idea to just forward
the intro you sent to the dev list here. Though many of us are members
of both lists, many also are not. We very much need the skills of
someone who has done technical writing. I am a manufacturing engineer by
profession who happens to have done standards writing and editing for
the company I worked for. I am by no means an experienced technical writer.

Regards
Keith



signature.asc
Description: OpenPGP digital signature

Re: New doc volunteer

[Keith N. McKenna]

Ben Hunt wrote:
 Hi, I am a third year IT student from Australia. Both myself and
 another IT student have a project to help contribute to an open
 source project (due in June) so we decided to try and help out with
 open office. We have no particular set of skills, we have done some
 Java and C# but are in no way experts. We are interested in helping
 out with the documentation for open office in anyway we can and look
 forward to participating in the community. Any advice you can offer
 will be great. Thanks. Ben.
 

Ben;

Andrea's suggestion was a good one. Due to ant-spam measures put in
place on the m-wike self registration has had to be suspended. If you
send your preferred user name to the list one of the admins will set up
an account for you.

The User Guide is being built at
http://wiki.openoffice.org/wiki/Documentation/UserGuide, a link to the
status page we use to track work is at the bottom of the page.

As you work on sections let the list know and add the status to the
status page.

Regards
Keith



signature.asc
Description: OpenPGP digital signature

Re: New doc volunteer

[Keith N. McKenna]

Ben Hunt wrote:
 Hi,
 I am a third year IT student from Australia. Both myself and another IT 
 student have a project to help contribute to an open source project (due in 
 June) so we decided to try and help out with open office. We have no 
 particular set of skills, we have done some Java and C# but are in no way 
 experts. We are interested in helping out with the documentation for open 
 office in anyway we can and look forward to participating in the community.
 Any advice you can offer will be great.
 Thanks.
 Ben.
 
Hi Ben;

Welcome to the documentation list. If you haven't already, the best
place to start is by reading the documentation orientation page at
http://openoffice.apache.org/orientation/intro-doc.html. I also strongly
suggest reading the level one and 2 pages at
http://openoffice.apache.org/orientation/index.html. They will give you
a good overview of how decisions are made in the project and the
technical infrastructure that we utilize.

Any questions should be directed to the mailing list. Again welcome and
we look forward to working with you.

Regards
Keith N. McKenna





signature.asc
Description: OpenPGP digital signature

Re: New doc volunteer

[Andrea Pescetti]

On 01/05/2014 Ben Hunt wrote:

I am a third year IT student from Australia. Both myself and another
IT student have a project to help contribute to an open source
project (due in June) so we decided to try and help out with open
office. We have no particular set of skills, we have done some Java
and C# but are in no way experts. We are interested in helping out
with the documentation for open office


Welcome, both of you! I assume you are both subscribed to this mailing 
list and you have read 
http://openoffice.apache.org/orientation/intro-doc.html , if not please 
do so.


As for priorities, Keith may have more precise suggestions, but if you 
need something done by June the best topic is probably this user guide 
we are developing (all contributions are under the Apache License, 
version 2; the same license used by OpenOffice):

https://wiki.openoffice.org/wiki/Documentation/UserGuide

You could tackle the Writer and Calc guide respectively, for example. 
This would be the appropriate load for a project and would enormously 
help our effort. Of course, we'll be happy to answer all your questions.


Regards,
  Andrea.

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

Re: New Doc Volunteer

[Andrea Pescetti]

On 13/04/2014 Luca Ceccarini wrote:

My name is Luca and I’m a tech enthusiast and overall digital geek
from Italy. I’m a self-employed web and print designer, my main
occupation for almost 10 years now. But I’m looking for a new
challenge and I’m particularly interested in technical writing.


Welcome, Luca! You are subscribed to the list, right? You already 
received other answers.


We have really everything for your set of skills, just choose what you 
would like to exercise:


- Doc writing: 
https://wiki.openoffice.org/wiki/Documentation/UserGuide/Writer is the 
project under discussion at the moment.


- Translation: you can translate into Italian the above guide, or 
complete the translation of the Release Notes for OpenOffice 4.1 
https://cwiki.apache.org/confluence/display/OOOUSERS/Informazioni+su+Apache+OpenOffice+4.1+-+IT


- Design: we have a new set of icons under discussion at 
https://cwiki.apache.org/confluence/display/OOOUSERS/AOO4.1+-+Desktop+Icons 
or you can design a simple Apache OpenOffice inside logo much like the 
Get it here logo http://openoffice.apache.org/get-it-here.html - we 
need it for bundles like OpenOffice + selected templates


- Web: the horrible mess that is http://www.openoffice.org/it/ should be 
turned into a more faithful copy of the slightly-less-horrible mess that 
is http://www.openoffice.org/ and we welcome suggestions for an overall 
redesign.


So, documentation or not, you have plenty of ways to contribute, just 
pick one! You will need wiki accounts and such. Ask here, say what you 
need and we will create accounts for you.


Regards,
  Andrea.

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

Re: New Doc Volunteer

[Alexandro Colorado]

There is some efforts updating the migration guide at the moment, please
take a look at it and see if there are areas where they can be improved.


On Tue, Feb 11, 2014 at 12:09 PM, Julian Spiro jdsp...@gmail.com wrote:

 Hi all,

 I'm a tech writer from Cleveland, OH, interested in helping out with
 OpenOffice projects.  Please let me know how I can get involved!

 Skills:
 Writing/Editing
 Photoshop and Graphic Design


 Thank you,

 Julian Spiro




-- 
Alexandro Colorado
Apache OpenOffice Contributor
http://www.openoffice.org
882C 4389 3C27 E8DF 41B9  5C4C 1DB7 9D1C 7F4C 2614

Re: New Doc Volunteer

[Keith N. McKenna]

-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Marcia K Wilbur wrote:
 Hi Everyone,
 
 My name is Marcia Wilbur. -- Who I am
 
 
 I am located in the US, Arizona more specifically.   Where I
 live I am from New England  Where I am from
 
 For over a decade my writing focus was copyright and the Digital 
 Millennium Copyright Act. I have an AAS in computer science. A BS
 in Technical Communications and a MS in IT from Arizona State
 University. For many years, I taught technical communications to
 college freshmen as well as other foundation courses (Welcome to
 the university, goal setting, etc.) Recently, I have found myself
 with spare time. I know... can you imagine??? I have always been a
 contributing member of this community:
 
 2000 - present Free speech/free software advocate joining LUGs in 
 protest of the DMCA 2001 - 2003 DMOZ (ODP) editor 2002-2003 Free
 Software Foundation intern 2003  Volunteer Electronic Frontier
 Foundation - DMCA FAQs for the DMCA Blog 2003  Volunteer IP Justice
 - Created boilerplate documentation for grants 2003-2004 Author
 Linux Essentials (Aries in cooperation with CompTia Linux +)
 
 The rest of the time I spent volunteering here and there as well
 as working as a Senior technical writer with some Programming and
 QA tasks in semiconductor, education and finance. . . . ^ | | What
 my background is, etc.
 
 I don't know what I can offer, but I am hoping I can put my skills
 to good use and be of value to the community.
 
 Thanks! Marcia
Marcia;

Welcome to the OpenOffice documentation list. We certainly can use the
skills that you posses as we move forward with with task of creating
documentation for Version 4.x.x of the product.

If you have not looked at the orientation pages at
http://openoffice.apache.org/orientation/index.html that is a good
place to start. The level one and two pages give a good background of
how the project functions and the infrastructure available. The third
level pages give more information on individuals areas you could
contribute to. Of course as part of the documentation team I highly
recommend http://openoffice.apache.org/orientation/intro-doc.html.

We need all level of help in this effort from writers to create the
initial pages, to editors, to testers to be sure that the information
given matches what the program actually does.

This list is the main communication vehicle for all things related to
documentation so please direct any questions you might have as to how
best you might contribute here.

Regards
Keith N. McKenna


-BEGIN PGP SIGNATURE-
Version: GnuPG v2.0.22 (MingW32)
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBAgAGBQJS1Zj8AAoJEH0fu5UhGmBCZxMIALVnsC2dk6ZAbKdDmE4FZanB
yacf/2KbsdB0tz5EnD2sqbJC9y0qoFyU84tdH1JkxJO2uBBNNUkZLfpwnBgbjGY9
2mKc1IsJSjWXZmInz4oMoEkNwor2thy24WZ2x/SfDgzCXFW/RBA7UqeEo1gIndZx
HXdE4KyCn7euNiK0oPVCzMh8GZpl/ZblYXv6O1F4j83kT/1ru67/42imp4X0HPJ5
KQU90acAtLfAXvV43diBbLL1xIVhUmhn4hnhJeG06u99JxKZ48bZ5RLVe4q2g+Q8
bboZOWR2kT4JZSbbJwqHuHWTEGgakC/FgqOVfOXcph22TX9IRHIwj/3mBKnZso0=
=F0RR
-END PGP SIGNATURE-


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

Re: New Doc Volunteer

[Marcia K Wilbur]

Thank you! This seems like a great starting point. I would very much  
enjoy working on an alternative to proprietary expensive approach. I  
am also very interested in education and statistics.


Thanks!

Quoting Dave davepo...@gmail.com:


Hi Marcia,

My tentative suggestion might well be completely off the mark But something
completely new and possibly lacking would be some documentation for
students doing or having to do statistics. Possibly the opensource PSPP (as
an alternative to the much too expensive SPSS) would be a nice thing to
help propagate.

The reason for me would be the too uncritical approach which seems to
dominate universities (my impression), especially the belief that
statistics can be automatically validated by some obscure mathematical
formulas. A classic criticism was written some years ago by Stephen Jay
Gould: The Mismeasure of Man. I think students need to know how to use
statistical programms without becoming blind believers, or, the opposite,
be so distrustful they don't want to have anything to do with it.

Anyway, hit me if the idea is too stupid.

Yours
Dave


On 28 December 2013 14:03, Marcia K Wilbur ai...@faqlinux.com wrote:


Hi Everyone,

My name is Marcia Wilbur. -- Who I am


I am located in the US, Arizona more specifically.   Where I live
I am from New England  Where I am from

For over a decade my writing focus was copyright and the Digital
Millennium Copyright Act. I have an AAS in computer science. A BS in
Technical Communications and a MS in IT from Arizona State University. For
many years, I taught technical communications to college freshmen as well
as other foundation courses (Welcome to the university, goal setting, etc.)
Recently, I have found myself with spare time. I know... can you imagine???
I have always been a contributing member of this community:

2000 - present Free speech/free software advocate joining LUGs in protest
of the DMCA
2001 - 2003 DMOZ (ODP) editor
2002-2003 Free Software Foundation intern
2003  Volunteer Electronic Frontier Foundation - DMCA FAQs for the DMCA
Blog
2003  Volunteer IP Justice - Created boilerplate documentation for grants
2003-2004 Author Linux Essentials (Aries in cooperation with CompTia Linux
+)

The rest of the time I spent volunteering here and there as well as
working as a Senior technical writer with some Programming and QA tasks in
semiconductor, education and finance.
.
.
.
^
|
|
What my background is, etc.

I don't know what I can offer, but I am hoping I can put my skills to good
use and be of value to the community.

Thanks!
Marcia


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









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

Re: New Doc Volunteer

[Alexandro Colorado]

I have tried to start a wikibook on both, education and accounting,
unfortunately havent had time to really develop it. If you have time and
interest I could give you the information I have gathered and we can get
this project back on top form.


On Mon, Dec 30, 2013 at 2:20 AM, Marcia K Wilbur ai...@faqlinux.com wrote:

 Thank you! This seems like a great starting point. I would very much enjoy
 working on an alternative to proprietary expensive approach. I am also very
 interested in education and statistics.

 Thanks!


 Quoting Dave davepo...@gmail.com:

  Hi Marcia,

 My tentative suggestion might well be completely off the mark But
 something
 completely new and possibly lacking would be some documentation for
 students doing or having to do statistics. Possibly the opensource PSPP
 (as
 an alternative to the much too expensive SPSS) would be a nice thing to
 help propagate.

 The reason for me would be the too uncritical approach which seems to
 dominate universities (my impression), especially the belief that
 statistics can be automatically validated by some obscure mathematical
 formulas. A classic criticism was written some years ago by Stephen Jay
 Gould: The Mismeasure of Man. I think students need to know how to use
 statistical programms without becoming blind believers, or, the opposite,
 be so distrustful they don't want to have anything to do with it.

 Anyway, hit me if the idea is too stupid.

 Yours
 Dave


 On 28 December 2013 14:03, Marcia K Wilbur ai...@faqlinux.com wrote:

  Hi Everyone,

 My name is Marcia Wilbur. -- Who I am


 I am located in the US, Arizona more specifically.   Where I live
 I am from New England  Where I am from

 For over a decade my writing focus was copyright and the Digital
 Millennium Copyright Act. I have an AAS in computer science. A BS in
 Technical Communications and a MS in IT from Arizona State University.
 For
 many years, I taught technical communications to college freshmen as well
 as other foundation courses (Welcome to the university, goal setting,
 etc.)
 Recently, I have found myself with spare time. I know... can you
 imagine???
 I have always been a contributing member of this community:

 2000 - present Free speech/free software advocate joining LUGs in protest
 of the DMCA
 2001 - 2003 DMOZ (ODP) editor
 2002-2003 Free Software Foundation intern
 2003  Volunteer Electronic Frontier Foundation - DMCA FAQs for the DMCA
 Blog
 2003  Volunteer IP Justice - Created boilerplate documentation for grants
 2003-2004 Author Linux Essentials (Aries in cooperation with CompTia
 Linux
 +)

 The rest of the time I spent volunteering here and there as well as
 working as a Senior technical writer with some Programming and QA tasks
 in
 semiconductor, education and finance.
 .
 .
 .
 ^
 |
 |
 What my background is, etc.

 I don't know what I can offer, but I am hoping I can put my skills to
 good
 use and be of value to the community.

 Thanks!
 Marcia


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







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




-- 
Alexandro Colorado
Apache OpenOffice Contributor
http://www.openoffice.org
882C 4389 3C27 E8DF 41B9  5C4C 1DB7 9D1C 7F4C 2614

Re: New Doc Volunteer

[Dave]

Hi Marcia,

My tentative suggestion might well be completely off the mark But something
completely new and possibly lacking would be some documentation for
students doing or having to do statistics. Possibly the opensource PSPP (as
an alternative to the much too expensive SPSS) would be a nice thing to
help propagate.

The reason for me would be the too uncritical approach which seems to
dominate universities (my impression), especially the belief that
statistics can be automatically validated by some obscure mathematical
formulas. A classic criticism was written some years ago by Stephen Jay
Gould: The Mismeasure of Man. I think students need to know how to use
statistical programms without becoming blind believers, or, the opposite,
be so distrustful they don't want to have anything to do with it.

Anyway, hit me if the idea is too stupid.

Yours
Dave


On 28 December 2013 14:03, Marcia K Wilbur ai...@faqlinux.com wrote:

 Hi Everyone,

 My name is Marcia Wilbur. -- Who I am


 I am located in the US, Arizona more specifically.   Where I live
 I am from New England  Where I am from

 For over a decade my writing focus was copyright and the Digital
 Millennium Copyright Act. I have an AAS in computer science. A BS in
 Technical Communications and a MS in IT from Arizona State University. For
 many years, I taught technical communications to college freshmen as well
 as other foundation courses (Welcome to the university, goal setting, etc.)
 Recently, I have found myself with spare time. I know... can you imagine???
 I have always been a contributing member of this community:

 2000 - present Free speech/free software advocate joining LUGs in protest
 of the DMCA
 2001 - 2003 DMOZ (ODP) editor
 2002-2003 Free Software Foundation intern
 2003  Volunteer Electronic Frontier Foundation - DMCA FAQs for the DMCA
 Blog
 2003  Volunteer IP Justice - Created boilerplate documentation for grants
 2003-2004 Author Linux Essentials (Aries in cooperation with CompTia Linux
 +)

 The rest of the time I spent volunteering here and there as well as
 working as a Senior technical writer with some Programming and QA tasks in
 semiconductor, education and finance.
 .
 .
 .
 ^
 |
 |
 What my background is, etc.

 I don't know what I can offer, but I am hoping I can put my skills to good
 use and be of value to the community.

 Thanks!
 Marcia


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

Re: New Doc Volunteer

[Ricardo Berlasso]

2013/9/23 Andy Walton proje...@andywalton.net

 Hi, Mailing List!

 I've just signed up for the documentation mailing list / added my name to
 the wiki lists and I wanted to introduce myself. I'm Andy and I'm a
 freelance technical writer based in Leicester, UK. My background is in
 user-facing documentation such as manuals and how-to content, but I'm
 looking to gain some more experience of creating developer docs and working
 on big projects (such as this one!) I'm very much looking forward to
 working on OpenOffice.


Welcome!

Your experience will be a great help for the project!

The user documentation is being worked on the wiki, so you need to get an
account. For more  details, see this page

http://openoffice.apache.org/orientation/intro-doc.html

The draft for the 4.0 user guide is growing here:

http://wiki.openoffice.org/wiki/Documentation/UserGuide

(there is a link to the status page at the end). There are several
missing pages and holes on the existing ones, but an easy start would be to
proofread the existing pages and check the information for accuracy.

Note that this guide is aimed to AOO 4.0, so you need the last version to
check the guide.

Clearly, writing an user guide implies not only writing skills but also
knowledge of the software: if you have any doubt about how Apache
OpenOffice works, just ask!

So the tasks available are many, some of them already mentioned:

* Check spelling and grammar for existing pages (proofreading)
* Check if it is possible to reproduce what the guide suggest, i.e., if
topics are clearly explained (accuracy and understandability)
* Write new material

It is also possible to add

* User Guide design: to make the user guide more visually appealing to
the readers.

We use this mailing list to discuss the changes. In general we can say that
the approach is

* small changes like fixing typos and formatting errors: just do it!
* new material: just announce it! Both at the beginning of your work and
when you are done.
* big changes like moving sections or rewriting existing material: discuss
first on the list!

Tester, editor or writer? You choose :)

Regards,
Ricardo




 Thanks,

 Andy

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

Re: New Doc Volunteer

[Keith N. McKenna]

dbclinton wrote:

Hi,
I've been using open source software (including OpenOffice) for just
about ten years now, and exclusively Linux for about six. Since I am a
writer and editor with some enterprise software documentation experience
(especially using Confluence), I figured it's about time I tried to give
a little back.
My primary OO experience is with Draw and Writer - I've used these tools
to create the layouts for dozens of full-length books and event journals
- among hundreds of other projects. Anyone have any ideas for a good
place where I can start?
As an aside, I recently created a Udemy course called Zero Budget
Typesetting based on OO (well ok, it was LibreOffice, but no one has to
know). If any list members would like, you can access it free using this
link:
https://www.udemy.com/zero-budget-typesetting/?couponCode=OO_free_access
Hope I can work with you soon,
David Clinton
Ottawa, Canada

HI David;
Your writng and editing experience will be a very valuable asset to the 
group. The user documentation is being worked on at the the mediawiki 
(mwiki), so you need to get an account. For more details, see this page 
http://openoffice.apache.org/orientation/intro-doc.html.


The Writer guide could greatly benefit from attention from an 
experienced editor and your knowledge of Draw would make you the ideal 
person to take up the writing task for that guide.


Both of these tasks are needed, please write back to the list and let us 
know which one you would like to start with.


Welcome to the Apache Open Office Documentation team, I looked forward 
to working with you.


Regards
Keith McKenna



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

Re: New Doc Volunteer

[Keith N. McKenna]

Brandon Youngdale wrote:

Hi,

My name is Brandon Youngdale and I just joined the volunteer documentation
team today. I love OpenOffice and I have appreciated it so much as I have
gone through my Bachelors and Masters degree in Writing that I wanted to
start giving back to the community however I could. I am so glad that I can
help even though I am not a programmer/engineer. I have 3 years of
experience editing, proofreading, and writing in various fields (both
business related and educational). I am excited to help and begin
contributing!

Thanks for the opportunity,


Hi Brandon;

Your experience will be a great help for the project!

The user documentation is being worked on the wiki, so you need to get 
an account. For more details, see this page 
http://openoffice.apache.org/orientation/intro-doc.html


The draft for the 4.0 user guide is growing here: 
http://wiki.openoffice.org/wiki/Documentation/UserGuide (there is a link 
to the status page at the end).


There are several missing pages and holes on the existing ones, but an 
easy start would be to proofread the existing pages and check the 
information for accuracy. Note that this guide is aimed to AOO 4.0, so 
you need the latest version to check the guide.


Clearly, writing an user guide implies not only writing skills but also 
knowledge of the software: if you have any doubt about how Apache 
OpenOffice works, just ask!

So the tasks available are many, some of them already mentioned:
  ● Check spelling and grammar for existing pages (proofreading)
  ● Check if it is possible to reproduce what the  guide suggest, i.e.,
if topics are clearly explained (accuracy and understandability)
  ● Write new material It is also possible to add
  ● User Guide design: to make the user guide more visually
appealing to the readers.

We use this mailing list to discuss the changes. In general we can say 
that the approach is

  ● small changes like fixing typos and formatting errors: just do it!
  ● new material: just announce it! Both at the beginning of your work
and when you are done.
  ● big changes like moving sections or rewriting existing material:
discuss first on the list!

 Tester, editor or writer? You choose

Regards
Keith


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

Re: New Doc Volunteer

[Brandon Youngdale]

Hi Keith,

Maybe to start out I will just work as an editor. I will go through the
existing material and check it for grammar, typos, and such. Then as I get
more familiar with the material I will start working on producing original
material.

Does that sounds ok?

Thanks,
Brandon


On Tue, Aug 20, 2013 at 5:38 AM, Keith N. McKenna keith.mcke...@comcast.net
 wrote:

 Brandon Youngdale wrote:

 Hi,

 My name is Brandon Youngdale and I just joined the volunteer documentation
 team today. I love OpenOffice and I have appreciated it so much as I have
 gone through my Bachelors and Masters degree in Writing that I wanted to
 start giving back to the community however I could. I am so glad that I
 can
 help even though I am not a programmer/engineer. I have 3 years of
 experience editing, proofreading, and writing in various fields (both
 business related and educational). I am excited to help and begin
 contributing!

 Thanks for the opportunity,

  Hi Brandon;

 Your experience will be a great help for the project!

 The user documentation is being worked on the wiki, so you need to get an
 account. For more details, see this page http://openoffice.apache.org/**
 orientation/intro-doc.htmlhttp://openoffice.apache.org/orientation/intro-doc.html

 The draft for the 4.0 user guide is growing here:
 http://wiki.openoffice.org/**wiki/Documentation/UserGuidehttp://wiki.openoffice.org/wiki/Documentation/UserGuide(there
  is a link to the status page at the end).

 There are several missing pages and holes on the existing ones, but an
 easy start would be to proofread the existing pages and check the
 information for accuracy. Note that this guide is aimed to AOO 4.0, so
 you need the latest version to check the guide.

 Clearly, writing an user guide implies not only writing skills but also
 knowledge of the software: if you have any doubt about how Apache
 OpenOffice works, just ask!
 So the tasks available are many, some of them already mentioned:
   ● Check spelling and grammar for existing pages (proofreading)
   ● Check if it is possible to reproduce what the  guide suggest, i.e.,
 if topics are clearly explained (accuracy and understandability)
   ● Write new material It is also possible to add
   ● User Guide design: to make the user guide more visually
 appealing to the readers.

 We use this mailing list to discuss the changes. In general we can say
 that the approach is
   ● small changes like fixing typos and formatting errors: just do it!
   ● new material: just announce it! Both at the beginning of your work
 and when you are done.
   ● big changes like moving sections or rewriting existing material:
 discuss first on the list!

  Tester, editor or writer? You choose

 Regards
 Keith


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




-- 
Brandon Youngdale

Re: New Doc Volunteer

[Keith N. McKenna]

Brandon Youngdale wrote:

Hi Keith,

Maybe to start out I will just work as an editor. I will go through the
existing material and check it for grammar, typos, and such. Then as I get
more familiar with the material I will start working on producing original
material.

Does that sounds ok?

Thanks,
Brandon



Hi Brandon,

That sounds fine. Wherever you are most comfortable at this point. I 
look forward to seeing your contributions.


Regards
Keith


On Tue, Aug 20, 2013 at 5:38 AM, Keith N. McKenna keith.mcke...@comcast.net

wrote:



Brandon Youngdale wrote:


Hi,

My name is Brandon Youngdale and I just joined the volunteer documentation
team today. I love OpenOffice and I have appreciated it so much as I have
gone through my Bachelors and Masters degree in Writing that I wanted to
start giving back to the community however I could. I am so glad that I
can
help even though I am not a programmer/engineer. I have 3 years of
experience editing, proofreading, and writing in various fields (both
business related and educational). I am excited to help and begin
contributing!

Thanks for the opportunity,

  Hi Brandon;


Your experience will be a great help for the project!

The user documentation is being worked on the wiki, so you need to get an
account. For more details, see this page http://openoffice.apache.org/**
orientation/intro-doc.htmlhttp://openoffice.apache.org/orientation/intro-doc.html

The draft for the 4.0 user guide is growing here:
http://wiki.openoffice.org/**wiki/Documentation/UserGuidehttp://wiki.openoffice.org/wiki/Documentation/UserGuide(there
 is a link to the status page at the end).

There are several missing pages and holes on the existing ones, but an
easy start would be to proofread the existing pages and check the
information for accuracy. Note that this guide is aimed to AOO 4.0, so
you need the latest version to check the guide.

Clearly, writing an user guide implies not only writing skills but also
knowledge of the software: if you have any doubt about how Apache
OpenOffice works, just ask!
So the tasks available are many, some of them already mentioned:
   ● Check spelling and grammar for existing pages (proofreading)
   ● Check if it is possible to reproduce what the  guide suggest, i.e.,
 if topics are clearly explained (accuracy and understandability)
   ● Write new material It is also possible to add
   ● User Guide design: to make the user guide more visually
 appealing to the readers.

We use this mailing list to discuss the changes. In general we can say
that the approach is
   ● small changes like fixing typos and formatting errors: just do it!
   ● new material: just announce it! Both at the beginning of your work
 and when you are done.
   ● big changes like moving sections or rewriting existing material:
 discuss first on the list!

  Tester, editor or writer? You choose

Regards
Keith


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









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

Re: New Doc Volunteer

[Ricardo Berlasso]

2013/8/4 dgcashion cashi...@gmail.com

 Hi there,

 My name is Deborah and I'm interested in volunteering with the OpenOffice
 documentation team.

 I am a web developer and I have a little experience writing technical docs.

 Please let me know how I can be of assistance.


Welcome!

Your experience will be a great help for the project!

The first step is to subscribe to this mailing list by sending an email to

doc-subscr...@openoffice.apache.org

(it seems you are not subscribed because your message was moderated)

The user documentation is being worked on the wiki, so you need to get an
account. For more  details, see this page

http://openoffice.apache.org/orientation/intro-doc.html

You can also add your info to this wiki page:

https://cwiki.apache.org/confluence/display/OOOUSERS/Documentation+Volunteers

The draft for the 4.0 user guide is growing here:

http://wiki.openoffice.org/wiki/Documentation/UserGuide

(there is a link to the status page at the end). There are several
missing pages and holes on the existing ones, but an easy start would be to
proofread the existing pages and check the information for accuracy.

Note that this guide is aimed to AOO 4.0, so you need the last version to
check the guide.

Clearly, writing an user guide implies not only writing skills but also
knowledge of the software: if you have any doubt about how Apache
OpenOffice works, just ask!

So the tasks available are many, some of them already mentioned:

* Check spelling and grammar for existing pages (proofreading)
* Check if it is possible to reproduce what the guide suggest, i.e., if
topics are clearly explained (accuracy and understandability)
* Write new material

It is also possible to add

* User Guide design: to make the user guide more visually appealing to
the readers.

We use this mailing list to discuss the changes. In general we can say that
the approach is

* small changes like fixing typos and formatting errors: just do it!
* new material: just announce it! Both at the beginning of your work and
when you are done.
* big changes like moving sections or rewriting existing material: discuss
first on the list!

Tester, editor or writer? You choose :)

Regards
Ricardo




 Thanks,
 Deborah

Re: New Doc Volunteer

[Alex Stillwell]

Hi Andrea

Thank you. I'll go ahead, but let me know if I start doing the wrong thing.

Best wishes to all

Alex

-Original Message- 
From: Andrea Pescetti

Sent: Monday, July 8, 2013 7:10 AM
To: doc@openoffice.apache.org
Subject: Re: New Doc Volunteer

On 06/07/2013 Alex Stillwell wrote:

I don't like to change anything until I know I will not cause problems,
so I have attached a couple of suggestions.


Dear Alexandra, they are OK, feel free to apply them but won't worry in
general, we have the full history of all changes made to any page so if
something is wrong it is very easy to revert it.


Is there any way I can
access the part of the actual program I am working


Here
https://cwiki.apache.org/confluence/display/OOOUSERS/Development+Snapshot+Builds#DevelopmentSnapshotBuilds-AOOSnapshotfullsets
you will find the latest 4.0 development snapshot. They are not
recommended for everyday use, but we are basing our documentation on those.

Regards,
  Andrea.

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


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

Re: New Doc Volunteer

[Alex Stillwell]

Hi Andrea

I don't like to change anything until I know I will not cause problems, so I 
have attached a couple of suggestions.  Is there any way I can access the 
part of the actual program I am working on so  I can see it as it really is 
and use the controls before commenting on how they can be described?


Best wishes

Alex



-Original Message- 
From: Andrea Pescetti

Sent: Thursday, July 4, 2013 9:34 PM
To: doc@openoffice.apache.org
Subject: Re: New Doc Volunteer

Alex Stillwell wrote:

Exactly what would you like me to do? and exactly how would you like
me to respond. I have indigestion from too much information and I
cannot see what is important at this stage and what I should do next.
Once I get a handle on how to help I will be OK. It is just taking me
time to get myself organised to your requirements.


No problem! First of all, get an account on the wiki:
http://wiki.openoffice.org/w/index.php?title=Special:UserLogintype=signup
(please let us know if you experience any problems in this step).

Then, open a chapter of the guide (Writer is OK for a start:
http://wiki.openoffice.org/wiki/Documentation/UserGuide/Writer/Intro )
and you will be able to do minor fixes (like language fixes and
clarifications) by clicking Edit on the right hand side. Then, as you
get more confidence, you'll be able to make bigger contributions, like
reorganizing materials and writing documentation on your own.

Regards,
  Andrea.

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


Suggestion01.odt
Description: application/vnd.oasis.opendocument.text

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

Re: New Doc Volunteer

[Andrea Pescetti]

Alex Stillwell wrote:

Exactly what would you like me to do? and exactly how would you like
me to respond. I have indigestion from too much information and I
cannot see what is important at this stage and what I should do next.
Once I get a handle on how to help I will be OK. It is just taking me
time to get myself organised to your requirements.


No problem! First of all, get an account on the wiki:
http://wiki.openoffice.org/w/index.php?title=Special:UserLogintype=signup 
(please let us know if you experience any problems in this step).


Then, open a chapter of the guide (Writer is OK for a start: 
http://wiki.openoffice.org/wiki/Documentation/UserGuide/Writer/Intro ) 
and you will be able to do minor fixes (like language fixes and 
clarifications) by clicking Edit on the right hand side. Then, as you 
get more confidence, you'll be able to make bigger contributions, like 
reorganizing materials and writing documentation on your own.


Regards,
  Andrea.

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

Re: New Doc Volunteer

[Keith N. McKenna]

Hello Alex and welcome to the documentation group. With your skills as
an author and in publishing you can be of great help to us. The first 
step is to subscribe to this mailing list so that you do not miss any of 
the discussion that goes on. Your initial email was sent through the 
moderator and I have explicitly CC'ed you. To subscribe send a blank 
e-mail to mailto:doc-subscr...@openoffice.apache.org then follow the 
directions in the follow-up e-mail.


I also strongly suggest that you go through our short orientation pages. 
The first ones at http://openoffice.apache.org/orientation/index.html. 
The first two levels will introduce you to Apache and the OpenOffice 
Project, and to the decision making structure and the Technical 
Infrastructure. The third one is the intro to the documentation group at 
http://openoffice.apache.org/orientation/intro-doc.html.


Our major thrust at this time is the creation of the User Guides for 
OpenOffice v4.0.0 which is our latest upcoming release. All the work is 
being on our Mediawiki site at 
http://wiki.openoffice.org/wiki/Documentation/UserGuide. At the bottom 
of that page there is also a link to the status page we use to track 
work done.


When you have reviewed the orientation modules send a note back to the 
list and we can answer any questions that you have and give you further 
assistance on the nxt steps to get you started.


Regards
Keith



Alex Stillwell wrote:

Hi

My training is in physics, I have teacher training and taught science
and maths. After starting a family I went into teaching adults
crafts, eventually specialising in lacemaking and through a series of
events and with a lot of encouragement from friends wrote a book on
lace, that’s another story.

When I started lacemaking there were very few books and very few
lacemakers passing on their knowledge so I had to research everything
I did. The lack of written information was also a spur to continue
writing books. I have just completed my ninth and it will go to print
this week, I am now self-publishing. Publishing is not the same as it
was in the 1980s when my first book came out. That one was written by
hand five times; there were no home computers. My next book was
written using an electronic typewriter with a memory and I bought one
of the first Amstrads just after starting writing a dictionary of
lacemaking terms. It took five minutes to save a file but was
wonderful for cross referencing.  A have just competed my 9th book
and have no plans for another, but who knows the future.

I am still teaching lacemaking, demonstrating and giving talks.  My
lace has been on exhibition in about 8 countries and I have taught at
lace conventions in Australia and USA as well as at home in UK. I
started the British Lace Guild Logbook Scheme and assisted the US
lace guild writing their teachers’ training program.

I am currently assisting another lacemaker by email to self-publish
her out of print book using Open Office Writer. She is not familiar
with the program and is having to convert the format to A4 with many
 diagrams and without changing the pagination; there is a large index
 that she does not wish to redo. It is proving quite a challenge.

I am a silver surfer with no plans to put my feet up and retire.

Best wishes to all the team, looking forward to being able to help.

Alex  (Alexandra Stillwell, you can see some of my lace and books on
 www.alexstillwell.wordpress.com )






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

Re: New Doc Volunteer

[RGB ES]

Hy, Caroline! Welcome on board!


2013/5/10 Caroline O'Brien caroline.obr...@gmail.com

 Hey there!

 I'm eager to learn more about working on the Doc Team for Open Office.

 Can you tell me a bit more about where I should start, outside of signing
 up for the two wikis and putting my name on the volunteer sites?

 Thank you!


Great!

The user documentation is being worked on the wiki, so after you read the
intro-doc page linked by Alexandro, please look at where the draft for the
4.0 user guide is growing:

http://wiki.openoffice.org/wiki/Documentation/UserGuide

(there is a link to the status page at the end). There are several
missing pages and holes on the existing ones, but an easy start would be to
proofread the existing pages and check the information for accuracy.

Clearly, writing an user guide implies not only writing skills but also
knowledge of the software: if you have doubts about how Apache OpenOffice
works, just ask!

Note that this guide is aimed to AOO 4.0, so there are instructions on the
guide that do not completely correspond to the stable builds (like menu
Tools → Options → Apache OpenOffice: on 3.4.1 you'll find OpenOffice.org
there). You can find development builds for 4.0 here:

https://cwiki.apache.org/confluence/display/OOOUSERS/Development+Snapshot+Builds#DevelopmentSnapshotBuilds-AOOSnapshotfullsets

Regards
Ricardo



 Caroline

Re: New Doc Volunteer

[Alexandro Colorado]

Hello, please read the initial documentation that we have on our site.

http://openoffice.apache.org/orientation/intro-doc.html

This will guide you throught he initial steps into the way the
project is builted and where you can contribute best.

On 5/9/13, Caroline O'Brien caroline.obr...@gmail.com wrote:
 Hey there!

 I'm eager to learn more about working on the Doc Team for Open Office.

 Can you tell me a bit more about where I should start, outside of signing
 up for the two wikis and putting my name on the volunteer sites?

 Thank you!

 Caroline



-- 
Alexandro Colorado
Apache OpenOffice Contributor
http://es.openoffice.org

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

Re: New Doc Volunteer

[RGB ES]

2013/3/21 leah_bac...@us.ibm.com

 Hello,

 I just signed up as a documentation volunteer.  I work at IBM.  I have
 almost 20 years experience in education and support - writing user
 documentation and courses, and delivering classes in a variety of
 software.  In the past 5 years, I've worked extensively on Lotus Symphony,
 so I feel right at home in OpenOffice.

 Cheers,

 Leah Backus



Welcome!

Your experience will be a great help for the project!

The first step is to subscribe to this mailing list sending an email to

doc-subscr...@openoffice.apache.org

(it seems you are not subscribed because your message was moderated)

The user documentation is being worked on the wiki, so you need to get an
account. For more  details, see this page

http://openoffice.apache.org/orientation/intro-doc.html

You can also add your info to this wiki page:

https://cwiki.apache.org/confluence/display/OOOUSERS/Documentation+Volunteers

The draft for the 4.0 user guide is growing here:

http://wiki.openoffice.org/wiki/Documentation/UserGuide

(there is a link to the status page at the end). There are several
missing pages and holes on the existing ones, but an easy start would be to
proofread the existing pages and check the information for accuracy.

Note that this guide is aimed to AOO 4.0, so there are instructions on the
guide that do not completely correspond to the stable builds (like menu
Tools → Options → Apache OpenOffice: on 3.4.1 you'll find OpenOffice.org
there)

Regards
Ricardo

Re: New Doc Volunteer

[Rob Weir]

On Mon, Mar 4, 2013 at 12:24 PM, Stephen J. Hyland
s...@stephenhyland.com wrote:
 Hello, everyone. My name is Stephen Hyland, and I've been a long-time user of 
 Open Source software, a software engineer, a technical writer (various tools 
 but primarily FrameMaker), and am an attorney. I probably won't be of much 
 use, initially, because of my father's death on Saturday (not unexpected) and 
 because I will be somewhat distracted by the funeral arrangements and estate 
 matters. So, if no one minds, I'll be lurking but not adding much to the 
 discussions or the effort at the moment.


Hello Stephen,

I'm very sorry to hear about your father.   Mine past away just a year
ago this week, so I know how hard it is.

 I had several questions regarding the documentation project, however.

 First, is there a project lead? If I have missed that information, could 
 someone point me to it?

Not really.   The project is very non-hierarchical.  So we may have
someone taking the lead in a particular task, or group of tasks, we
don't have any anointed one in charge.  It is more of a meritocracy,
or sometimes we call it a do-ocracy. leadership by those who step up
and do things.

That said, I've been taking the lead on recruitment, and Riccardo and
Keith have been taking the lead on the 4.0 User Guide.

 Second, what is being used for document control?

We're using MediaWiki.

 Third, is there a style guide?


A little out of date, but we have this:

http://wiki.openoffice.org/wiki/Documentation/Dashboard/Help_Style_Guide

Also, by agreement we'll be using U.S. English spelling.


 I'm sure I'll think of other things as we proceed.


You can find some more information of likely interest here:

http://mail-archives.apache.org/mod_mbox/openoffice-doc/201303.mbox/%3CCAP-ksojRGjNqE5YFEFD3FrruVg6SwUZEog%2Bf3XiVz2PQQvH5oA%40mail.gmail.com%3E


Finally, it is worth mentioning that we can think broader than just
OpenOffice 4.0 User Guides.  There are other pieces of documentation
for specialized uses that would be interesting.  For example:

- OpenOffice Calc for Finance -- review financial functions of
OpenOffice, with focus on any differences from Excel

- Writing your Dissertation with OpenOffice

- OpenOffice for Legal Writing, with guidance on template adjustments
needed to achieve common legal formats.

The same basic process would apply for these:  drafting, followed by
technical and editorial review, and then publication and possible
translation.

Regards,


-Rob

 Thanks,
 Stephen

 On Mar 4, 2013, at 9:24 AM, Christopher Olsen wrote:

 Hello all,

 My name is Chris Olsen, and I'm an avid user of OpenOffice products. I've 
 been using them for almost 7 years now, and I'd love to lend my assistance 
 to the documentation project.

 I've always been a proponent of the Open Source movement, but my background 
 has left me unable to help out in a direct fashion; I have a bachelor's 
 degree in English and I'm pursuing an MFA in Creative Writing. I'm hoping 
 that with these skills I can become a part of the OpenOffice team, at least 
 in some small way.

 I'm currently in school and working part time, but I'd love to commit some 
 of my free time to helping improve OpenOffice and do something for a 
 community I strongly believe in.

 Please let me know if I could be of any use to you. Thank you!

 Chris