[libreoffice-documentation] Re: User guides are not the only choice
Hello In my opinion, the user guides and Help are the starting point for any other documentation/information about using LibreOffice. So, anybody who works on other documentation should check the user guides and Help so that the information is the same across all documentation. When writing the Impress and Draw Guides, I did check the Help of each module to make sure that information was reasonably consistent. It is not perfect and could be improved. Regards PeterS On 26 Aug 2014, at 03:19, Jean Weber [via Document Foundation Mail Archive] wrote: > For those people who find working on the user guides a bit daunting, > for whatever reasons, there are other possibilities for user > documentation: how-to's and tutorials (both written and video), "tip > of the day/week/month" type blog posts (yes, we have a blog), material > on the wiki instead of or in addition to ODT/PDF/print, and I'm sure > you can think of others. Some of these may overlap with what's being > discussed and worked on through the Marketing list. > > If you're interested in doing something, let us know. Just because the > small active group has time and topic priorities, that doesn't mean > you must fit in with those, no matter what the opinion of some > individuals who post to this list. > > --Jean > > -- > To unsubscribe e-mail to: [hidden email] > Problems? > http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ > Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette > List archive: http://listarchives.libreoffice.org/global/documentation/ > All messages sent to this list will be publicly archived and cannot be > deleted > > > If you reply to this email, your message will be added to the discussion > below: > http://nabble.documentfoundation.org/User-guides-are-not-the-only-choice-tp4120242.html > To start a new topic under Documentation, email > ml-node+s969070n1645240...@n3.nabble.com > To unsubscribe from Documentation, click here. > NAML - Peter Schofield psaut...@libreoffice.org -- View this message in context: http://nabble.documentfoundation.org/User-guides-are-not-the-only-choice-tp4120242p4120260.html Sent from the Documentation mailing list archive at Nabble.com. -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
[libreoffice-documentation] User guides are not the only choice
For those people who find working on the user guides a bit daunting, for whatever reasons, there are other possibilities for user documentation: how-to's and tutorials (both written and video), "tip of the day/week/month" type blog posts (yes, we have a blog), material on the wiki instead of or in addition to ODT/PDF/print, and I'm sure you can think of others. Some of these may overlap with what's being discussed and worked on through the Marketing list. If you're interested in doing something, let us know. Just because the small active group has time and topic priorities, that doesn't mean you must fit in with those, no matter what the opinion of some individuals who post to this list. --Jean -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
[libreoffice-documentation] Coordination, mentoring, etc
IF people in this group think some coordination and/or mentoring is needed or at least would be useful, the group needs to find someone or several people to do that, do it consistently, and do it well. I do a bit now and then, but I have not been doing it consistently, have no intention of doing it consistently, and will probably be doing even less in future. I've been saying this for months, but is anyone listening? If we can't find one or more volunteers to take on this sort of responsibility, perhaps we should make a case for TDF to fund someone, at least part time? IMO we would need to hire someone with experience in technical communication, project management, and mentoring new team members. Preferably someone with experience coordinating volunteers, so they don't have inappropriate expectations of giving people assignments and getting the work done to a schedule. (No, I'm not looking for a job.) I'm not at all sure that would help enough, because we would still need people who have both the time and knowledge to do the actual work. Our problem, AFAICT, has not been in attracting volunteers. The problem is attracting -- and keeping -- the right volunteers: that is, people with the time and knowledge. BTW, I find it both encouraging and discouraging to note that the AOO Docs group appears to have the same problems that we do. --Jean -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: Fwd: [libreoffice-documentation] Impress Guide Version 4.2
On Mon, Aug 25, 2014 at 10:27 PM, Tom Davies wrote: > Hi :) > Ahh, so a list of "suggested things to work on" might be helpful? It might be helpful, but someone has to do it and keep it up to date; sometimes the list would change rapidly. And I'm not the someone to take care of such a list (I am capable, but I don't). Also, Hazel said 'I feel more comfortable if someone drops me a line saying "This needs doing now and you are the obvious one to do it."' -- that is not the same thing as having a list. I often, though not consistently, do write to her about things to do. > I keep being told that such a thing is impossible and that people would > reject any such manipulation anyway and just go off and do their own > thing. Having a list is not "manipulation" but people will do their own thing and/or not choose the most urgent items on the list. Example: I choose not to create and update a list, no matter how important others may think it might be. > Wrt the Calc chapters done by Jean there does, of course, need to be > someone quite knowledgeable about the Guide's topic involved at some > point(s) in the process. However there also needs to be non-experts > involved, preferably noobs to the topic, because otherwise the guides run > the risk of being too geeky and unhelpful to non-experts. Of course now > that Jean has worked so intensely on those Calc chapters it makes he more > of an expert than she had been previously so it's difficult to make sure > the team keeps getting the fresh perspective. I thought the review process > was were fairly expert people checked the technical accuracy? Part of the review process is supposed to be checking for technical accuracy. However, if no one does it, then it doesn't get done. Either someone (not me) spends time trying to find appropriate people to do reviews, or the chapters and books are delayed indefinitely, or chapters and books get published without needed review. --Jean -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: Fwd: [libreoffice-documentation] Impress Guide Version 4.2
Hi :) Ahh, so a list of "suggested things to work on" might be helpful? I keep being told that such a thing is impossible and that people would reject any such manipulation anyway and just go off and do their own thing. Wrt the Calc chapters done by Jean there does, of course, need to be someone quite knowledgeable about the Guide's topic involved at some point(s) in the process. However there also needs to be non-experts involved, preferably noobs to the topic, because otherwise the guides run the risk of being too geeky and unhelpful to non-experts. Of course now that Jean has worked so intensely on those Calc chapters it makes he more of an expert than she had been previously so it's difficult to make sure the team keeps getting the fresh perspective. I thought the review process was were fairly expert people checked the technical accuracy? Regards from Tom :) On 25 August 2014 12:08, Hazel Russman wrote: > On Mon, 25 Aug 2014 07:51:28 +1000 > Jean Weber wrote: > > > Tom, > > > > Hazel cannot proofread the remaining chapters of the Writer Guide > > until someone updates them, so suggesting that she skip proofing the > > Impress Guide in favour of Writer is irrelevant. > > > > You seem to be perpetually of the erroneous opinion that all the work > > that needs to be done on the various books is interchangeable: that > > any volunteer can do whatever needs doing next, if only they knew what > > it is. This is wrong and unhelpful. > > I would like to add that I feel more comfortable if someone drops me a > line saying "This needs doing now and you are the obvious one to do it." > You know my strengths and weaknesses by now. I have an eagle eye for > spelling mistakes, bad grammar, repetitive sentences, misnumbered lists and > so on. I can also translate from German and French. I am not so good at > actually working through a chapter and seeing how far it matches the > behaviour of the software, so I don't volunteer for that. > > -- > Hazel Russman > > -- > To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org > Problems? > http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ > Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette > List archive: http://listarchives.libreoffice.org/global/documentation/ > All messages sent to this list will be publicly archived and cannot be > deleted > > -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: Fwd: [libreoffice-documentation] Impress Guide Version 4.2
On Mon, 25 Aug 2014 07:51:28 +1000 Jean Weber wrote: > Tom, > > Hazel cannot proofread the remaining chapters of the Writer Guide > until someone updates them, so suggesting that she skip proofing the > Impress Guide in favour of Writer is irrelevant. > > You seem to be perpetually of the erroneous opinion that all the work > that needs to be done on the various books is interchangeable: that > any volunteer can do whatever needs doing next, if only they knew what > it is. This is wrong and unhelpful. I would like to add that I feel more comfortable if someone drops me a line saying "This needs doing now and you are the obvious one to do it." You know my strengths and weaknesses by now. I have an eagle eye for spelling mistakes, bad grammar, repetitive sentences, misnumbered lists and so on. I can also translate from German and French. I am not so good at actually working through a chapter and seeing how far it matches the behaviour of the software, so I don't volunteer for that. -- Hazel Russman -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted