[documentation-dev] Stepping down as co-lead of the Doc Project
Hi everyone. I've decided it's time to step down as co-lead of the Documentation project. My attention is being pulled in new directions and to different projects. I have to focus on these new things now. I'll leave it up to you guys to decide if you want to appoint/elect a replacement, or if it's best to leave things as they are. I'll be lurking in the background for a while so if there is any fallout from my departure (I doubt there will be) I will still be around to help tidy it up. It's been an interesting ride, and I've enjoyed working with everyone here. In the words of Douglas Adams, "so long, and thanks for all the fish" :-) Clayton -- - To unsubscribe send email to dev-unsubscr...@documentation.openoffice.org For additional commands send email to sy...@documentation.openoffice.org with Subject: help
[documentation-dev] Stepping away from the OOo Doc project
Hi everyone. As you may have already heard, I am stepping away from involvement in OpenOffice.org and the OOoWiki. This means I am also stepping down as Co-Lead of the Documentation Project. This is a decision that has been in process for me since the changes to OOo started in mid-April of this year (you may have noticed that my participation in the project has dropped off dramatically in recent months). This decision is not directly because of the changes to OOo... I just need to refocus my attentions on personal matters. I will be available behind the scenes for a while to support the OOoWiki transition, and the OOo Doc Project. Working with the team here on the OOo Documentation has been fun. Together, we have taken the Doc Project a long way, even going so far as refining the efforts of two independent teams into a more cohesive group. That is a real accomplishment on the part of everyone involved. There is so much more to do with the OOo Documentation - the transition to Apache OOo, docs for LibreOffice, filling in the gaps in the documentation, editing and fixing the existing documentation... lots to keep everyone busy for a long time to come :-) It's been an interesting ride, and I've enjoyed working with everyone here. In the words of Douglas Adams, "so long, and thanks for all the fish" Clayton -- - To unsubscribe send email to dev-unsubscr...@documentation.openoffice.org For additional commands send email to sy...@documentation.openoffice.org with Subject: help
[documentation-dev] Re: Status of OOo Admin Guide?
On 05/06/2011 02:23 PM, Jean Hollis Weber wrote: Clayton or anyone who's been involved with the OOo Admin Guide: How out of date is it? What topics are missing? --Jean Basically the Admin Guide was written for 1.x an 2.x. A lot has changed with the 3.x releases. A considerable part if the guide as it is now is very obsolete. - Deploy OpenOffice.org using package managers - Recently updated and accurate, needs validation - OpenOffice.org Basic Macros and Libraries - Probably wrong for version 3.x and up - OpenOffice.org Extension Manager - Recently updated and accurate, needs validation - Adding Template Files to an OpenOffice.org Installation - Probably wrong/obsolete - Adding AutoText Files to an OpenOffice.org Network Installation - Probably wrong/obsolete - Deactivating the OpenOffice.org Registration Wizard - Recently updated and accurate, needs validation - Accessing Email Clients - Needs validation - Customizing the User Interface - Out of date, needs updating/validating - Restricting Functionality in OpenOffice.org - Needs validating - Accessing OpenOffice.org User Profiles on an LDAP Server - Needs validating I don't have a lot of information - this doc was on my ToDo list, but I haven't got to it just yet. I don't have a lot of notes or research on it to work from. C. -- - To unsubscribe send email to dev-unsubscr...@documentation.openoffice.org For additional commands send email to sy...@documentation.openoffice.org with Subject: help
[documentation-dev] Re: BZ issue 20878 spammed [PING Clayton]
On 04/07/2011 11:52 AM, TJ Frazier wrote: Clayton, http://openoffice.org/bugzilla/show_bug.cgi?id=20878#c133 If user yiyigg has an account on the wiki, we might want to stop trouble before it starts. No sign of him on that user name on the Wiki. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead -- - To unsubscribe send email to dev-unsubscr...@documentation.openoffice.org For additional commands send email to sy...@documentation.openoffice.org with Subject: help
Re: [documentation-dev] Possible error in Calc Date & Time function “TODAY”?
On 02/02/2011 05:25 PM, 9li...@gmx.net wrote: First of all, since I am a total newbie here, hello to everyone on the list. Now, I would just like to report anyone in charge of the writing/editing of Documentation/How Tos/Calc page about some small (possible) error in the page below: http://wiki.services.openoffice.org/wiki/Documentation/How_Tos/Calc:_TODAY_function According to the first line of definition in the above page, “TODAY” is a function which “[r]eturns the current date and time”. However, it seems that this line should be corrected as “Returns the current date”. It is because that the same explanation is applied to another Calc function “NOW”. http://wiki.services.openoffice.org/wiki/Documentation/How_Tos/Calc:_NOW_function In addition, it differs from a description in TODAY’s “Syntax” which reads “[TODAY] returns the current date (as a date-time serial number)”. The latter clearly has a consistency with the rest of TODAY’s description including operation examples. I know it might not be a big problem, but, if possible, please modify it in case you would regard it as a seed of confusion. Thank you very much for your kind understanding and contribution in advance. syranzi (Sayuri Anzai) Japan 9li...@gmx.net Hi syranzi. Thanks for you investigation into the HowTo for Calc. There is no one specific person in charge of the HowTos on the Wiki that's why they are on the Wiki :-) Any community member can tweak and correct the information. All you need is a Wiki ID and a few seconds of your time. I've removed "and time" from the description. Please feel free to make these adjustments when you discover them. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Problems trying to print a wiki-book.
On 10/12/10 10:02, Giuseppe Castagno wrote: I've looked into this a bit more, and it seems to be a timeout issue. Short books (less than 50 rendered pages) generate OK, but longer books fail with this error. I've raised a help ticket with PediaPress... so hopefully a solution can be found. In the mean time, you could try generating the book you want in smaller segments. will do. I'll post back here any results of the help request with PediaPress. many thanks ! Ok, I have received an answer. There is a 90 second timeout on mw-zip (one of the render server components) - that's the total time mw-zip is allowed to run on the external rendering server. On larger books, it takes longer than 90 seconds for mw-zip to run... so it errors out. There also seems to be some DB connection error that is being generated... but the error message is somewhat unhelpful (an "unknown error"). I don't see any obvious immediate solution on the server side other than to install and run our own rendering server. That is something I've been discussing with the IT support guys, but there are some technical limitations to the current server config that blocks us from installing the render server. It can be done, but requires a reconfiguration of the Solaris Zones to make it work. It might be possible to do this around the same time as when the Wiki engine is upgraded but don't hold your breath waiting... it will take a while before that happens. The "workaround" for now (unless the PediaPress guys come up with another suggestion) is to generate shorter books. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Problems trying to print a wiki-book.
On 10/11/10 16:20, Giuseppe Castagno wrote: Expected... No... but it can happen, and I've seen this error a few times in the past couple of weeks. The book rendering is done on an external server which we have no control over (the PediaPress rendering server which is used for testing and developing the Book extension). Sometimes it's offline, sometimes it's upgraded with the newest rendering server software which breaks things... and so on. Can you generate a PDF instead of ODT? nope, this instead: An error occured on the render server: RuntimeError: RuntimeError: command failed: ['mw-zip', '-o', u'cache/7e/7eae1c9e9b30730b/collection.zip', '-m', u'cache/7e/7eae1c9e9b30730b/metabook.json', '--status', u'qserve://localhost:14311/7eae1c9e9b30730b:makezip', '--config', u'http://wiki.services.openoffice.org/w', '--template-blacklist', u'MediaWiki:PDF Template Blacklist', '--template-exclusion-category', u'Exclude in print', '--print-template-prefix', u'Print', '--print-template-pattern', u'$1/Print'] in function system, file ./code/sandbox/nslave.py, line 36 in function qaddw, file /home/tools/local/lib/python2.6/site-packages/mwlib-0.12.13-py2.6-linux-x86_64.egg/mwlib/async/slave.py, line 64 I've looked into this a bit more, and it seems to be a timeout issue. Short books (less than 50 rendered pages) generate OK, but longer books fail with this error. I've raised a help ticket with PediaPress... so hopefully a solution can be found. In the mean time, you could try generating the book you want in smaller segments. I'll post back here any results of the help request with PediaPress. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Problems trying to print a wiki-book.
On 10/11/10 15:04, Giuseppe Castagno wrote: Hi all, I was trying to generate a book, ODF format; this one: http://wiki.services.openoffice.org/wiki/MediaWiki:Collections/Developer%27s_Guide_-_Writing_UNO_Components But all I got was this bunch of error: Render server error From OpenOffice.org Wiki Jump to: navigation, search An error occured on the render server: RuntimeError: RuntimeError: command failed: ['mw-zip', '-o', u'cache/c2/c20549d706f6e457/collection.zip', '-m', u'cache/c2/c20549d706f6e457/metabook.json', '--status', u'qserve://localhost:14311/c20549d706f6e457:makezip', '--config', u'http://wiki.services.openoffice.org/w', '--template-blacklist', u'MediaWiki:PDF Template Blacklist', '--template-exclusion-category', u'Exclude in print', '--print-template-prefix', u'Print', '--print-template-pattern', u'$1/Print'] in function system, file ./code/sandbox/nslave.py, line 36 in function qaddw, file /home/tools/local/lib/python2.6/site-packages/mwlib-0.12.13-py2.6-linux-x86_64.egg/mwlib/async/slave.py, line 64 Is it expected? Expected... No... but it can happen, and I've seen this error a few times in the past couple of weeks. The book rendering is done on an external server which we have no control over (the PediaPress rendering server which is used for testing and developing the Book extension). Sometimes it's offline, sometimes it's upgraded with the newest rendering server software which breaks things... and so on. Can you generate a PDF instead of ODT? If the error continues, we can open a ticket with PediaPress and see if we can resolve the problem. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Who's who in the Doc project?
Hey everyone.. I've started a "Who is Who" page on the Doc Wiki. http://wiki.services.openoffice.org/wiki/Documentation/Dashboard/Who_is_Who Filling in your info is *not* mandatory by any means, but... if you're up to it, please head over to the page and let us know who you are, what part of the planet you're in, and what you see your role as in the Doc Project. This info will really help us do some doc planning, amongst other things. If we have an idea of time zones for example, we might be able to organize a Skype conference call just for the team to say hello to each other. I'm hoping this will be a step in adding a more personal face to the team so we can get to know each other a bit better... it's easier to work with people when you think of them as a real person rather than just an email address. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Developer Bounty re Add-Ons - PING Carsten & Clayton
On 09/20/10 13:35, Claire Wood wrote: Hi Clayton Is there a particular place on the wiki you'd like me to upload it to? If so, can you send me instructions on how to do that please. I've only opened and edited wiki docs. I'm familiar with booking into CVS but wasn't sure if there is a designated folder for the Bounty work. I know how to link to another wiki page so I'm assuming that's what you mean by linking to my user page. I've got the questions in text files at present so I'll copy them into ODT format so it's easier to annotate when I get home this evening. Actually... now that I think of it, we can use the Documentation folders feature of the Doc Project web pages. (this gets used so little that I forgot about it). It's much better to use this than cluttering up the Wiki. Log into the OO.o website http://documentation.openoffice.org and then go to the Documents & files section of the project pages: http://documentation.openoffice.org/servlets/ProjectDocumentList I've added a Bounties folder to the list of available folders. Click the Bounties link and you should see a message to the right of the list that says Documents related to the various Documentation Bounties There are no files in this folder. Now click the Add a new file link at the top of the folder list. Fill in the form and upload the document. This should place it into the Bounties folder. If you can't see the links I describe, I may need to bump up your access rights. Let me know if it doesn't work for you. No CVS needed, and we can add the direct link for the documents in any emails we send around. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Developer Bounty re Add-Ons - PING Carsten & Clayton
On 09/19/10 19:01, Claire Wood wrote: Hello Carsten & Clayton I've produced an outline of the document/information on wiki in ODT format and I have some text files that cover questions from the pages on the wiki you've highlighted need to be merged. Where should I upload them too? Do you have a particular place on CVS? Hi Claire. You can either send them to me directly or upload the doc to the Wiki and link it on your User page. The advantage of sending to me direct is that.. it's easier :-) If you link it on the Wiki, it's easier to find, harder to lose, we maintain a document history, etc. Up to you which you prefer. I'm good with either one. I'll try to manage the question side of things and chase own the various developers for you. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Introduction
On 09/09/10 10:02, Wanda Phillips wrote: Hello, I signed on a couple of weeks ago and although I've tried to follow the threads, I've had nothing to contribute. I am in the midst of moving, having lost my job and therefore my pretty much everything as I am a resident alien (I'm going to miss that moniker). Once I'm a bit more settled, up in Canada, I will be able to take a look at what needs doing and where I can best contribute to the effort. Some background: Graduated from a 3-year diploma course on technical writing in 1989. Have been working since then. The first couple of jobs I had were documenting database management tools. Have also done contract work in telecom, but have only briefly been engaged in that domain. Spent the past 8 years working on user manuals for ultrasound systems. Have worked with various tools, but most recently have been immersed in DITA as a tool for developing complex documentation that is shared across at least 8 products (by the time I left, there are several new products coming on board and they, too, will share that collection of content). Loved DITA as much as I hated it. The hate part was mostly about the tools we didn't have to manage our content better. We didn't even use version control. Herculean effort to maintain the integrity of the content. At that last job I learned more about team work than I had in all the years previous. Oh, and I've signed up for university. ROTFL!! Can't believe it. But, I'm trying to get into 2 classes this semester and then at least 2 more next semester. No real job, and no real prospects as I'm partially disabled and working on PT to get me back to work. Anything else you want to know, please ask. I hope to be diving into the process in the next few days. I'm really looking forward to working with this group. Wanda Hi Wanda. Just wanted to say welcome :-) Sounds like things pretty busy for you right now. Big wave to my home country. It's been too long since I've been back in Canada. We're going to be working on coming up with some more clear information for people like yourself who are just getting started. Whenever you have things sorted and you feel like tackling a task, just pop in here and let the team know. One of us can point you at a document that needs reviewing, or maybe a doc/chapter/FAQ/HowTo that needs revising. There's always something to do here. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Fixed broken Wiki Widget
On 08/12/10 12:58, Claire Wood wrote: Clayton Sorry, I'm just replying to this now. Do you think the AddThis widget is causing more problems though? I'm just wondering if I should look around for an alternative. Mmmm no I don't think the widget itself is causing issues. The permissions changed on the rendering director on the webserver someone (that'd be me) was in there tinkering, and set the permissions wrong. I didn't notice... it was set so it wasn't writable by the webserver. The widget needed to be able to write some file to this directory. When it couldn't it failed... and all the user would see is a blank page. Once I fixed the permissions... it started working fine again. I don't think we need to find a new solution... at least not right now. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Fixed broken Wiki Widget
I don't know if anyone noticed this, but the http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Writer_Guide page has been broken for a while. The AddThis Wiki Widget was having permissions issues on the webserver side (wrong permissions on a directory). The result was that the AddThis Widget caused an error on the webserver, and the page would not be rendered or shown. I've fixed the webserver problem, and all works again as it's supposed to. Just a note to everyone, if you see a Wiki page that just comes up blank, let me know, or send a note to d...@website.openoffice.org A blank Wiki page (I mean completely blank, with no Wiki menus etc.) means that there is some broken coding on the Wiki page (or even worse, the Wiki server is mis-configured as was the case this time), and it needs to be looked at and fixed. Don't assume it's just your browser :-) C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Straw Poll: Active membership in the OOo Doc Project?
If someone was to ask me.. roughly how many people are active members of the OOo Documentation project I don't think I could give an answer or even a reasonable guess. If I look at: http://documentation.openoffice.org/servlets/ProjectMemberList the list goes on forever. The vast majority are not active, and never have been active members. Why has this question come up? Well, I'm working on ideas for an OOo Documentation Project presentation to be given at OOoCon 2010 in Budapest. I'm working on a few ideas (brainstorming at this point) surrounding the people who work so hard on the docs... how many there are, what we are doing (or not doing) to mentor the new members among many other ideas. So, how do we find out how many active or semi-active project members we have? Would it work to create a table on the OOoWiki and have everyone add their OOoWiki userID (and maybe pet document within the Doc Project) be a way to get a bit of a Straw Poll of active members? What do you guys think? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Bounties
Just a quick note regarding the bounties. http://wiki.services.openoffice.org/wiki/Documentation/Bounties We are still collecting up applications, so please be patient. We will get back to everyone as soon as we can. For those of you who are not already subscribed to this mailing list (I've BCCed you on this mail), please subscribe to the d...@documentation mailing list - this is where we will be doing the co-ordination and communication. To do this you just need to send a blank email to: dev-subscr...@documentation.openoffice.org and follow the instructions in the reply. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Help with documentation
On 03/31/2010 03:43 PM, Hazel Russman wrote: > I've just published a novel on Lulu using OpenWrite. If you want to do this > for free, you have to provide camera-ready copy and I wouldn't have been able > to do that without the availability of page styles and pdf export - both > things that MS Word doesn't provide. > > I feel I'd like to give something back. I don't really know enough about OOo > to actually write anything about it from scratch, but I believe that I'm a > good editor, especially when it comes to rendering contributions from foreign > writers into smooth English. > > If you can use my help, please let me know. Hi Hazel, and welcome to the OpenOffice.org Documentation Project. We have two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@documentation.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists. If you don't subscribe, you will not see any replies to your messages, and you will not be able to participate effectively with the team. To subscribe to the dev list, send a blank email to dev-subscr...@documentation.openoffice.org To subscribe to the authors list, send a blank email to authors-subscr...@documentation.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english/. Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are Wiki-based. You should set up an account on the Wiki as well. We are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the Wiki and the website are being reorganized and rewritten. If some things seem inconsistent or unclear, that's probably why. You are welcome to join in at any level you wish. Please introduce yourself to the team here, and don't be shy about asking questions on the list when things are unclear. When documents come up for copy-edit, it is usually announced on the mailing lists. The most recent that various team members have been proofreading and copy editing is the Writer Guide. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Reminder - auth...@user-faq.openoffice.org is no longer in use
I've noticed a few people using the old auth...@user-faq.openoffice.org mailing list in the past week or so. Just a reminder for all of us - the user-faq mailing lists are no longer in use. Please make sure your address book and mail filters are updated to use the new auth...@documentation.openoffice.org address. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] FAQs on the OOoWiki - a task for one of our new members
On 03/31/2010 03:07 PM, bjoern michaelsen - Sun Microsystems - Hamburg Germany wrote: > On Wed, 31 Mar 2010 15:00:01 +0200 > Clayton wrote: > >> I started looking at the OOo FAQs on the Wiki today. >> http://wiki.services.openoffice.org/wiki/Documentation/FAQ > > If those are outdated, these are likely even more so: > > http://user-faq.openoffice.org/ > > If there is no relevant content left on that site, I'd suggest to kill > the user-faq subdomain completely to prevent confusion of users, who > get lost there. That's already under-way. We're in the process of shutting down the last active mailing list on that project (in fact today - 31 March - I'm locking down all mailing lits in that project). This project is also one I want to flag as "Do Not Move" when we migrate over to the new hosting infrastructure. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] FAQs on the OOoWiki - a task for one of our new members
I started looking at the OOo FAQs on the Wiki today. http://wiki.services.openoffice.org/wiki/Documentation/FAQ The FAQs are almost ALL out of date. Many of them refer to OOo1.1, a couple refer to StarOffice 5.2. As well, the FAQs that are there, are inconsistent in language and style/layout. If anyone here is looking for a task they could jump into, this is a great one to get started with. It does not require a great deal of technical knowledge or any in-depth knowledge of OOo to help clean up this part of the Doc Wiki If you're interested in helping out, pick a section to work on (let everyone know here on the list what section you are working on), and: 1. Check each FAQ page for style. Is it set up correctly? This FAQ is a good guideline for the syntax that should be used http://wiki.services.openoffice.org/wiki/Documentation/FAQ/Writer/AutomaticFunctions/How_do_I_turn_off_automatic_word_completion%3F 2. Does the FAQ make sense? Is the question asked correctly? Is the answer well written? This FAQ for example has a very poor page title (bad grammar): http://wiki.services.openoffice.org/wiki/Documentation/FAQ/Writer/AutomaticFunctions/How_do_I_avoid_URLs_to_appear_underlined%3F 3. Does the FAQ apply to the current version of OOo? If not, should the FAQ be removed or moved to an archive subpage so it's not in the main FAQ list? For example, this FAQ applies to old Windows versions which are no longer supported with OOo, and it should be removed or archived somewhere: http://wiki.services.openoffice.org/wiki/Documentation/FAQ/General/Why_on_my_Windows_system_do_I_have_a_lot_of_General_Protection_Fault_crashes_while_I%27m_using_OpenOffice.org%3F 4. Does the FAQ have answers for multiple OOo versions? Are these clearly marked with the {{Documentation/OOoVersion|version_number}} Template? 5. Does the FAQ have answers for each supported OS? If so, are they clearly marked? For example: http://wiki.services.openoffice.org/wiki/Documentation/FAQ/General/How_can_I_add_fonts_to_OpenOffice%3F Once we get the existing FAQs cleaned up, we can then move on to finding new ones (eg from the OOoForum) that should be added. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] How Tos
On 03/31/2010 05:09 AM, chanda Gadow wrote: > Hello. My name is Chanda Gadow and I was directed to your website via > docsymmetry.com. I am interested in participating in some of the writing > projects posted on your website. I have no experience in technical writing, > but I am researching a career path and I can definitely use the experience > that your website has to offer. > > Thank you very much for your time. > > Sincerely, > Chanda > Hi Chanda, and welcome to the OpenOffice.org Documentation Project. You can definitely gain some great experience with Technical Writing by contributing to the Documentation Project. We have two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@documentation.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists. If you don't subscribe, you will not see any replies to your messages, and you will not be able to participate effectively with the team. To subscribe to the dev list, send a blank email to dev-subscr...@documentation.openoffice.org To subscribe to the authors list, send a blank email to authors-subscr...@documentation.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english/. Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are Wiki-based. You should set up an account on the Wiki as well. We are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the Wiki and the website are being reorganized and rewritten. If some things seem inconsistent or unclear, that's probably why. You are welcome to join in at any level you wish. Please introduce yourself to the team here, and don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Contributing to User Guide.
On 03/26/2010 12:51 PM, surr...@free.fr wrote: > I've recently completed a course in Proofreading and am currently doing > another in Copyediting. Previous experience is 10 years as an English > teacher abroad. In order to get some much needed practical work, could I be > of any use to you? > Thanks for your consideration. > Sharon Whiston Hello Sharon, and welcome to the OpenOffice.org Documentation Project. We have two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@documentation.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists. If you don't subscribe, you will not see any replies to your messages, and you will not be able to participate effectively with the team. To subscribe to the dev list, send a blank email to dev-subscr...@documentation.openoffice.org To subscribe to the authors list, send a blank email to authors-subscr...@documentation.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english/. Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are Wiki-based. You should set up an account on the Wiki as well. We are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the Wiki and the website are being reorganized and rewritten. If some things seem inconsistent or unclear, that's probably why. You are welcome to join in at any level you wish. Please introduce yourself to the team here, and don't be shy about asking questions on the list when things are unclear. C. - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Welcome to the OpenOffice.org Documentation Project
I'd like to welcome some of our newest members to the OpenOffice.org Documentation Project. evariste_gallois, unclenard, kristallizer, sitec, subbumca, mrgaud59, randyfred, apdobaj, lindsay100, sufanza77, cristi2, crybaby6913, cartercgas, kkblue, ristoi, santhoshnarra, ryan_fulcher, brucejager1, teresa_burnett, lucywinte, sporter, gkelley58, epdiamantopoulos The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@documentation.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. If you haven't already done so, we recommend you subscribe to each of these mailing lists - if you don't subscribe, you will not be able to participate effectively with the team. To subscribe to the dev list, send a blank email to dev-subscr...@documentation.openoffice.org To subscribe to the authors list, send a blank email to authors-subscr...@documentation.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some useful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are Wiki-based. You should set up an account on the Wiki if you have not done so already. You are welcome to join in. Please, introduce yourself to the team if you haven't done so already, and don't be shy about asking questions on the mailing list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Downloadable HOW-TOs
On 03/04/2010 09:41 AM, Nino Novak wrote: >> There is no "easy" one-click way to download any multi-page part of >> any website or Wiki - at least not from within the website/Wiki >> without some preparation. >> >> The OooWiki uses Books for this, but someone has to create the Book - >> they cannot (at this point) be auto-generated. > > but it's definitely a nice-to-have feature for the documentation wiki to > have a mechanism which - say - automatically updates existing > "official" wikibooks each time one of the underlying documents is > changed, e.g. on a daily basis. Maybe it's doable with a > script/bot/cronjob already? How would this work? I've pondered this one quite a lot, wishing it could be totally automated, and I haven't been able to come up with anything reliable or practical that could manage the whole process. The closest I've come to an idea for automating that would have a chance to work is to parse the maintained TOC file, and convert it into a Book file. The TOC file is a known and maintained part of any Wiki Book. The syntax of both the TOC file and the Book file are known... and in theory the TOC could be converted into a book via an external transform. Simple Pseudocode: - Use the MW API to extract the XML for a given TOC - Parse the TOC XML and convert/transform it to Book XML - Use API to upload the Book XML The transform is the challenge... it can be done using... Ant/XSLT/Saxon for example. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] FAQ help
On 03/03/2010 07:47 PM, Phillipdugan wrote: > Hello, my name is Phillip Pelletier and I am finishing my junior year in > Technical Writing at USF St. Petersburg. I have been a user and fan of > OpenOffice for many years. I would truely enjoy helping OpenOffice > however I can. Hi Phillip, and welcome to the OpenOffice.org Documentation Project. The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@documentation.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists - if you don't subscribe, you will not see any replies to your messages, and you will not be able to participate effectively with the team. To subscribe to the dev list, send a blank email to dev-subscr...@documentation.openoffice.org To subscribe to the authors list, send a blank email to authors-subscr...@documentation.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are Wiki-based. You should set up an account on the Wiki as well. We are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the Wiki and the website are being reorganized and rewritten. If some things seem inconsistent or unclear, that's probably why. You are welcome to join in. Introduce yourself to the team here, and don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] FAQ help
On 03/03/2010 07:47 PM, Phillipdugan wrote: > Hello, my name is Phillip Pelletier and I am finishing my junior year in > Technical Writing at USF St. Petersburg. I have been a user and fan of > OpenOffice for many years. I would truely enjoy helping OpenOffice > however I can. Hi Phillip, and welcome to the OpenOffice.org Documentation Project. The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@documentation.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists - if you don't subscribe, you will not see any replies to your messages, and you will not be able to participate effectively with the team. To subscribe to the dev list, send a blank email to dev-subscr...@documentation.openoffice.org To subscribe to the authors list, send a blank email to authors-subscr...@documentation.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are Wiki-based. You should set up an account on the Wiki as well. We are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the Wiki and the website are being reorganized and rewritten. If some things seem inconsistent or unclear, that's probably why. You are welcome to join in. Introduce yourself to the team here, and don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Writing for OpenOffice.org
On 03/03/2010 06:23 PM, Joe Schmidt wrote: > Hello. > > I would like to volunteer to do a little writing for OpenOffice.org. I > would like to start with something small, as I don't have much experience > writing. Hi Joe, and welcome to the OpenOffice.org Documentation Project. The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@documentation.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists - if you don't subscribe, you will not see any replies to your messages, and you will not be able to participate effectively with the team. To subscribe to the dev list, send a blank email to dev-subscr...@documentation.openoffice.org To subscribe to the authors list, send a blank email to authors-subscr...@documentation.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are Wiki-based. You should set up an account on the Wiki as well. We are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the Wiki and the website are being reorganized and rewritten. If some things seem inconsistent or unclear, that's probably why. You are welcome to join in. Introduce yourself to the team here, and don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Downloadable HOW-TOs
On 03/03/2010 10:18 PM, Andy Brown wrote: > Hi all. > > I have found the how-to section on the wiki, my question is there a link > that I can use to download those files without going through all the hoops? > > I am looking to add/replace the files that come with the ISO downloads. There is no "easy" one-click way to download any multi-page part of any website or Wiki - at least not from within the website/Wiki without some preparation. The OooWiki uses Books for this, but someone has to create the Book - they cannot (at this point) be auto-generated. You can create your own custom Book, ether by: - adding each individual page and generating a PDF or ODT - adding one page, saving the book, and then editing the book file adding each Wiki article in the book syntax. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] User Guide contribution
On 01-Mar-10 06:33, Kay Hedges wrote: I’m quite new to OpenOffice, but I love what I have used so far. I would like to offer my services in whatever areas of need that exist. Please let me know if you need more information. Hi Kay, and welcome to the OpenOffice.org Documentation Project. The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@documentation.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists - if you don't subscribe, you will not see any replies to your messages, and you will not be able to participate effectively with the team. To subscribe to the dev list, send a blank email to dev-subscr...@documentation.openoffice.org To subscribe to the authors list, send a blank email to authors-subscr...@documentation.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are Wiki-based. You should set up an account on the Wiki as well. We are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the Wiki and the website are being reorganized and rewritten. If some things seem inconsistent or unclear, that's probably why. You are welcome to join in. Introduce yourself to the team here, and don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] User Guide on Openoffice.org
On 03-Mar-10 06:16, Delinda Johnson wrote: Hi, my name is Delinda, and I want to be a writer! I was referred to your website as a means of getting some professional writing experience. I have done some technical writing in the past, however, I don't have examples of my work because the content was usually proprietary. I have designed and created operation manuals as well as brochures for various subject matters. I would love to get some experience with some professional writing so I can begin a career as a technical writer. Please let me know how I can get started. I would love to contribute to one of your projects. I look forward to hearing from you soon. Hi Delinda, and welcome to the OpenOffice.org Documentation Project. You can definitely get some technical writing experience with the OOo Documentation Project :-) The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@documentation.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists - if you don't subscribe, you will not see any replies to your messages, and you will not be able to participate effectively with the team. To subscribe to the dev list, send a blank email to dev-subscr...@documentation.openoffice.org To subscribe to the authors list, send a blank email to authors-subscr...@documentation.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are Wiki-based. You should set up an account on the Wiki as well. We are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the Wiki and the website are being reorganized and rewritten. If some things seem inconsistent or unclear, that's probably why. You are welcome to join in. Introduce yourself to the team here, and don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] User Guide on Openoffice.org
On 03-Mar-10 06:16, Delinda Johnson wrote: Hi, my name is Delinda, and I want to be a writer! I was referred to your website as a means of getting some professional writing experience. I have done some technical writing in the past, however, I don't have examples of my work because the content was usually proprietary. I have designed and created operation manuals as well as brochures for various subject matters. I would love to get some experience with some professional writing so I can begin a career as a technical writer. Please let me know how I can get started. I would love to contribute to one of your projects. I look forward to hearing from you soon. Hi Delinda, and welcome to the OpenOffice.org Documentation Project. You can definitely get some technical writing experience with the OOo Documentation Project :-) The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@documentation.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists - if you don't subscribe, you will not see any replies to your messages, and you will not be able to participate effectively with the team. To subscribe to the dev list, send a blank email to dev-subscr...@documentation.openoffice.org To subscribe to the authors list, send a blank email to authors-subscr...@documentation.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are Wiki-based. You should set up an account on the Wiki as well. We are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the Wiki and the website are being reorganized and rewritten. If some things seem inconsistent or unclear, that's probably why. You are welcome to join in. Introduce yourself to the team here, and don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] PING Clayton
On 01-Mar-10 22:19, Andy Brown wrote: Clayton , Is the version 3.2 copies of the Administration Guide and Developer's Guide available for download? I can not find them on the wiki. Looking to add these to a disk I am putting together for ALA. Not yet. I keep trying to get to them and getting distracted by other issues. One prob I can't seem to get around is a render server error. The ODT rendering is done outside of our control, on the PediaPress server. Whatever is going on there... well, basically it just gives me a python error dump instead of the ODT. I'll keep chasing it with PediaPress, but... I don't know when it'll be resolved. Once this is fixed, I can put together an Admin Guide in a couple hours.. the Dev Guide takes a lot longer (a couple of days) since it's so huge. I should make a few small changes to the Basic Guide too before it's included on a CD or DVD... nothing major... just little cosmetic tweaks. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Top 25 Technical Writing Blogs
On 02/26/2010 01:45 AM, tnthu...@aol.com wrote: > unsubscribe me You have to unsubscribe yourself. At the bottom of every message to this mailing list, you should see this footer. - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org Send a blank message to the unsubscribe email address from the SUBSCRIBED email address (any other email address will not work) and follow the instructions in the email you get back as a reply. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Top 25 Technical Writing Blogs
On 02/24/2010 07:07 PM, Drew Jensen wrote: > >> >> http://wiki.services.openoffice.org/wiki/Template:AddThis >> > > ...and one lttle nit-picky thing..(you know there was going to be one of > those with me..right) > > The Oracle logo...well, just look for yourself > > http://www.facebook.com/dj.son.of.gus > > I shared a wiki page and let it display the logo...yuk H. I wonder what Facebook is picking up on to display the Oracle logo instead of the main OOo logo... and why it's got a really really ugly dithered background behind the Oracle logo C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] PING: Clayton Cornell - Re: [documentation-dev] Fwd: Advice about where to start documenting API stuff
On 02/21/2010 09:26 PM, Claire Wood wrote: > Clayton > > I did the grammar check on the Calc/API page on the Wiki and had some > feedback from TJ. I read the spreadsheet link you sent me below and I > must admit it's totally over my head at this point, as I've only been > with the project since 29 January. I'd need some guidance as to what > sections should go together and how to go about merging the two > documents because I don't want to lose the accuracy because otherwise > I think developers would get a tad upset with me (lol). I am keen > though to help clean up any areas that need it as I need the > experience. > > http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/OpenOffice.org_Developers_Guide > > > http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/Spreadsheets/Spreadsheet_Documents I'm not 100% sure how to go about merging the sections either. What we can do is ask one of the developer leads (Jeurgen) and see what he thinks - he will probably be the best judge whether it's possible or practical to merge the sections, and may have some advice as well. Even if it ends up not being practical to merge the info, the work you did on cleaning up the Calc pages is great! C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Fwd: Advice about where to start documenting API stuff
On 02/21/2010 01:06 PM, Claire Wood wrote: > First of all thank you for the feedback TJ. I have updated variable to type. Hi Claire. I have to agree with TJ :-) Your edits made that section a LOT more readable. Thank you! The original authors (primarily developers) that section are not native English speakers, so the grammar of their mother tongue tends to slip into the words they write in much the same way I tend to use English grammar when I write in Dutch (a second language I sort of know). > With regard to the references to SDK versions, to save having to > update the documentation every time the development kit is updated, > would it not be better to have the reference as just "SDK", or are > different versions of SDK running simultaneously? It is technically possible to use more than one SDK at a time (although probably not that likely in practice). With OOo, the SDK has changed from one release to the next. Documenting this is... a challenge. Do we document only the latest SDK? Or do we document all possible SDK variations.. or do we document the latest method and add a Note with the differences to past releases? I'm not sure what the right answer is here. In previous releases we had a much smaller number of differences... but since the 3.x release of OOo, there is a rapidly growing number of changes, and they are quite significant in some cases. This is something we need to figure out... hopefully before 3.3 is released :-) so any ideas you have are welcome! C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Open Office Documentation
On 02/17/2010 11:25 PM, Stuart Reynolds wrote: > Hi, > > I am a very experienced spreadsheet user and will be looking at your product > and trying to put some user documentation and how to documents togther. > > Regards > > Stuart Hi Stuart. Welcome to OpenOffice.org. Are you thinking of contributing to the OpenOffice.org documentation? or just creating your own documents? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] How-Tos and Tutorials
On 02/15/2010 10:40 PM, Anne McGee wrote: > Hello, > > I'm interested in contributing documentation. I have an idea to write how-tos > on > using OO for technical writing ... ie. formatting, image management, etc. What > do I need to know to get started? > > thanks, > Anne Hi Anne. Welcome to the OpenOffice.org Documentation Project. The first thing to do is subscribe to this list, or you won't see any replies. Send a blank email to dev-subscr...@documentation.openoffice.org The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@user-faq.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists. To subscribe to the authors list, send a blank email to authors-subscr...@user-faq.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are wiki-based. So you might want to get an account on the wiki as well. BTW, we are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the wiki and the website are being reorganised and rewritten. If some things seem inconsistent or unclear, that's probably why. We also use the wiki for planning purposes. You are welcome to join in. And don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] I am a tech writer from silicon valley
On 02/14/2010 02:58 PM, sally magnin wrote: > Please send me more information, thank you, > Sally Magnin Hi Sally. Welcome to the OpenOffice.org Documentation Project. I'm not sure what information you're looking for, but I can give you a brief overview of the OpenOffice.org Documentation Project. We are always looking for more help with producing the documentation for OpenOffice.org. The first thing to do is subscribe to this list, or you won't see any replies. Send a blank email to dev-subscr...@documentation.openoffice.org The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@user-faq.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists. To subscribe to the authors list, send a blank email to authors-subscr...@user-faq.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are wiki-based. So you might want to get an account on the wiki as well. BTW, we are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the wiki and the website are being reorganized and rewritten. If some things seem inconsistent or unclear, that's probably why. We also use the wiki for planning purposes. You are welcome to join in. And don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] User Guide for OpenOffice.org
On 02/13/2010 06:56 PM, Zero Subnet wrote: > Hello, I am interested in participating in the user guide development. > Please see links below for writing samples (the blog entries since Jan. 2009 > are mine). Please let me know if I can help with writing or in other ways. > Thanks! > Greg > > http://anaphoramusic.com/blog/ > http://anaphoramusic.com/cd-dvd-duplication/faqs.htm > Hi Greg. Welcome to the OpenOffice.org Documentation Project. The first thing to do is subscribe to this list, or you won't see any replies. Send a blank email to dev-subscr...@documentation.openoffice.org The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@user-faq.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists. To subscribe to the authors list, send a blank email to authors-subscr...@user-faq.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are wiki-based. So you might want to get an account on the wiki as well. BTW, we are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the wiki and the website are being reorganised and rewritten. If some things seem inconsistent or unclear, that's probably why. We also use the wiki for planning purposes. You are welcome to join in. And don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Openoffice documentation
On 02/13/2010 12:12 PM, Mike Adams wrote: > Hi Guys > > Very much like openoffice and since I have been writing training manuals for > MS office for years I'd thought I might be ablew to help out as I am now semi > retired. I am famililiar with most aspects of the openoffice suite so > probably write on anything you may need doing > > Regards > > Mike > Hi Mike. Welcome to the OpenOffice.org Documentation Project. The first thing to do is subscribe to this list, or you won't see any replies. Send a blank email to dev-subscr...@documentation.openoffice.org The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@user-faq.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists. To subscribe to the authors list, send a blank email to authors-subscr...@user-faq.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are wiki-based. So you might want to get an account on the wiki as well. BTW, we are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the wiki and the website are being reorganised and rewritten. If some things seem inconsistent or unclear, that's probably why. We also use the wiki for planning purposes. You are welcome to join in. And don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Editing
On 02/12/2010 12:19 AM, Jean Weber wrote: > Please note that the wiki version of the Getting Started book has NOT > been updated to include the many changes made in the latest edition of > the book, so editing on the wiki is a waste of time. The odt and PDF > versions are up to date. > > In general it is best to work on the user guides in their odt versions > on the oooauthors Webster because those are much more likely to be the > latest version. > > If anyone would like to update the wiki to match the odt that would be great. > > Calc guide on wiki is also not the latest. Writer guide mostly is > latest but only because not much has been updated in odt to 3.2. > Impress guide also has not been updated to 3.2 in odt. -- Jean Ah, thanks for the correction Jean :-) C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Editing
On 02/11/2010 02:15 PM, Andy Taitt wrote: > I work as an editor and am willing to help with proofreading and > critiquing documents. > > Andy Taitt Hi Andy. Welcome to the OpenOffice.org Documentation Project. The first thing to do is subscribe to this list, or you won't see any replies. Send a blank email to dev-subscr...@documentation.openoffice.org The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@user-faq.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists. To subscribe to the authors list, send a blank email to authors-subscr...@user-faq.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are wiki-based. So you might want to get an account on the wiki as well. BTW, we are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the wiki and the website are being reorganised and rewritten. If some things seem inconsistent or unclear, that's probably why. We also use the wiki for planning purposes. You are welcome to join in. And don't be shy about asking questions on the list when things are unclear. For specific editing tasks, I would suggest picking one of the User Guides on the Wiki and having a good look at them for readbility. Let everyone on the mailing list know what you're planning to work on. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] well, here I am, trying to help
On 02/11/2010 10:39 AM, Serge Moes wrote: > > Hello Dev, > > I've been an OpenOffice user for a while now, and feel that the time > has come that I should contribute something back to the OpenOffice > Community. > > My name is Serge Moes, I'm 50, live in London (UK), native of > Luxembourg, speak fluent English, French, German (and > Lëtzebuergesch). I use Windows and Linux on my computers (sometimes > both at the same time thanks to VMware Workstation). I hold a BSc > (1999) in Maths, Stats & Computing and a Masters in Molecular > modelling & BioInformatics (2002) both from Birkbeck College, > University of London. For my sins, I run the Luxembourg Tourist > Office in London, and have been using OpenOffice since v. 1.0 (I > believe ...it's so long ago...) > > I'm hoping someone could point me to a task I might be able to do > (and show me what's required), and thus plough back some of the good > vibes I've experienced with OpenOffice. > > Here's looking forward to hearing from you. > > Cheers, > Serge Moes Hi Serge, Welcome ot the OpenOffice.org Documentation Project. The first thing to do is subscribe to this list, or you won't see any replies. Send a blank email to dev-subscr...@documentation.openoffice.org The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@user-faq.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists. To subscribe to the authors list, send a blank email to authors-subscr...@user-faq.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. The box on the top right of the Documentation Wiki, "Want To Help?" contains some helpful information to help you get started. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then made available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are wiki-based. So you might want to get an account on the wiki as well. BTW, we are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the wiki and the website are being reorganised and rewritten. If some things seem inconsistent or unclear, that's probably why. We also use the wiki for planning purposes. You are welcome to join in. And don't be shy about asking questions on the list when things are unclear. Is there some part of OpenOffice.org that you're comfortable with or that you are interested in? For example, do you know how to work with Base? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Documentation/Needs Rework - Trying to use the version control features for my word processing document, but some of the menu choices I've seen before do not appear. What's wro
On 02/11/2010 01:35 PM, Claire Wood wrote: > Hi All > > Not sure if you want us to report whether something is old or not, so here > goes. > > I read through this question and followed the procedures. I think it is old > because 3.2 doesn't have those glitches, you can clearly see the menu > options in the Edit Menu and Compare options. > > I'm not sure which version it relates to as I'm only new to the project. The page you're referring to is this one: http://wiki.services.openoffice.org/wiki/Documentation/FAQ/Writer/FormattingPagesAndDocuments/Trying_to_use_the_version_control_features_for_my_word_processing_document,_but_some_of_the_menu_choices_I%27ve_seen_before_do_not_appear._What%27s_wrong%3F Good question. I don't think we have a clear way of handling version specific info other than simply typing into the text "Applies to OpenOffice.org version x.y.z". This would be something we could maybe handle with a template? I looked through the bug reports and didn't find much related to this FAQ subject. Does anyone here have OOo2.x or OOo3.0 installed and can test this? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Documentation/Needs Rework - How can I assign a macro to a key?
On 02/11/2010 01:42 PM, Claire Wood wrote: > Hi All > > I've checked this document and it is OK. > Hi Claire. Thanks for looking over the FAQs :-) If you find one that is tagged to be checked for accuracy and style, and after you review it, you find it's OK, then you can remove the Wki code that adds that tag, plus the Category link. The page you reviewed is: http://wiki.services.openoffice.org/wiki/Documentation/FAQ/Macros/How_can_I_assign_a_macro_to_a_key%3F Generally there are two lines you need to remove on a verified page: {{Documentation/NeedsRework}} [[Category: Documentation/NeedsRework]] I've removed the Needs Rework code for this page. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] FOSDEM input update
A few days ago I asked for your input... some quotes for the FOSDEM slides. A bunch of you responded, and I picked a few to submit for the FOSDEM booth slides. You can find the slides linked from here: http://wiki.services.openoffice.org/wiki/Marketing/PresentationForAtBooth Thanks again for your help on this :-) C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Helping out
And now a copy to original poster. On 02/01/2010 10:47 PM, dalwin lewis wrote: > Hi, > > I am Dalwin and I am a big fan of the open source movement. As a result, I > would like to contribute in some way that will help make this movement even > more widespread. I have a Degree in CS, but I am day by day realizing that I > find the documentation aspect of the CS the most appealing to me. > > Dalwin > Hi Dalwin, and welcome to the Documentation Project. The first thing to do is subscribe to this list, or you won't see any replies. Send a blank email to dev-subscr...@documentation.openoffice.org The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@user-faq.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists. To subscribe to the authors list, send a blank email to authors-subscr...@user-faq.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then make available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are wiki-based. So, to work on the FAQs you'll need to get an account on the wiki. BTW, we are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the wiki and the website are being reorganised and rewritten. If some things seem inconsistent or unclear, that's probably why. We also use the wiki for planning purposes. You are welcome to join in. And don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Helping out
On 02/01/2010 10:47 PM, dalwin lewis wrote: > Hi, > > I am Dalwin and I am a big fan of the open source movement. As a result, I > would like to contribute in some way that will help make this movement even > more widespread. I have a Degree in CS, but I am day by day realizing that I > find the documentation aspect of the CS the most appealing to me. > > Dalwin > Hi Dalwin, and welcome to the Documentation Project. The first thing to do is subscribe to this list, or you won't see any replies. Send a blank email to dev-subscr...@documentation.openoffice.org The Documentation Project has two main mailing lists: dev@documentation.openoffice.org, for discussions related to project infrastructure and policy, and auth...@user-faq.openoffice.org, where writers, editors, reviewers, and others discuss documents they are working on. We recommend you subscribe to each of these mailing lists. To subscribe to the authors list, send a blank email to authors-subscr...@user-faq.openoffice.org To get an overview of the project, look at the Documentation Wiki at http://wiki.services.openoffice.org/wiki/Documentation There you will find most of the documentation that we have available for OOo. Work on the user guides mainly takes place through the OOoAuthors website, http://oooauthors.org/english Those docs are then make available through the Documentation wiki. Most of the other materials produced and maintained by the Documentation Project, including how-to's, tutorials, and FAQs, as well as documents for system admins, programmers and developers, are wiki-based. So, to work on the FAQs you'll need to get an account on the wiki. BTW, we are in the process of evaluating what the Project is doing and how it's doing it, so some parts of the wiki and the website are being reorganised and rewritten. If some things seem inconsistent or unclear, that's probably why. We also use the wiki for planning purposes. You are welcome to join in. And don't be shy about asking questions on the list when things are unclear. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Open Offic Writer Guide in Spanish
On 02/05/2010 05:19 PM, Pub Coord wrote: > I uploaded 9 chapters of the Spanish translation of the English manual > (adapted for the Spanish interface version of Writer). There has been no > activity or submissions on the Spanish Writer (Como: Writer) for about a > year. I am wondering if this page has been abandoned/superseded. > http://es.openoffice.org/servlets/ProjectDocumentList?folderID=284 > <http://es.openoffice.org/servlets/ProjectDocumentList?folderID=284&expandFo > lder=284&folderID=284> &expandFolder=284&folderID=284 Hi Bill. You are not subscribed to the Documentation mailing list, so you might be missing out on any replies. To subscribe here, send a blank email to dev-subscr...@documentation.openoffice.org I can't speak for what has been going on with the Spanish NL project and any translations they are doing. For the updated Spanish documents and translations you have, you definitely need to contact the Spanish NL team (especially about the documents you've referenced). You can find the main page of the Spanish NL project here: http://es.openoffice.org/ and the Spanish mailing lists are here: http://es.openoffice.org/servlets/ProjectMailingListList C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Introducing myself and need help with wiki
On 02/04/2010 11:40 PM, deleeuw3 wrote: > It really is unfortunate that MediaWiki tools haven't been optimized for > translation. As an information sharing medium, MediaWiki would benefit > hugely from really good translation tools! There are tools in place for localizing the MediaWiki interface, and it's these same tools thata re being adapted by some to manage Wiki page translations. MediaWiki is nto yet really designed for mass translation projects. There has been discussion abotu this on the MW mailing list.. so people are working on it.. and it's a feature that a lot of people would like to have. One thing missing is the PHP developer who's also interested in translations. Programmers always like to "scratch their own itch" and work on the things that interest them.. translations aren't always top of the cool project list for developers. :-) C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] downlading problem
On 02/04/2010 09:38 PM, Mike Williams wrote: > Hi Edward and all else, > > Yes, I just clicked the download link and get 403'd. More specifically > this message: > "You don't have permission to > access /stable/3.1.1/OOo_3.1.1_LinuxIntel_install_wJRE_en-US_deb.tar.gz > on this server." > > Will email the web master, since it's clearly a web server problem. > > Edward, please don't hold it against OpenOffice.org if someone screwed > up access permission on a web server's directory. This is an extremely > easy thing to correct and I'll cc you on the aforementioned email. Interesting. I wodner if it's a specific mirror that's having issues? When I initially replied to Edward, I tested a download here, and it was working OK. Do you still see 403 errors Mike? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Open Offic Writer Guide in Spanish
On 02/02/2010 03:21 AM, Pub Coord wrote: > Here is a first draft of chapter 1. I have the first 9 done and more to > come. Would the “community” be interested? Hi Bill. The community would love to have the documents localized into all languages :-) The Documentation project does its best to manage the documentation in English, and the NL teams handle the translations into the various languages. Since not so many of us in the core Documentation project read Spanish, it might be helpful to co-ordinate with the Spanish NL project to see what translations they also have in process. Are you in contact with the Spanish NL project? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Math chapter in Writer Guide
On 02/01/2010 12:57 AM, Jean Hollis Weber wrote: > I propose to make delete Chapter 16 (Math Objects) from the Writer Guide > and make it into a stand-alone Math Guide. We've already made a Math > Guide on the wiki, but I have not yet pulled it out of the ODT and PDF > versions of the Writer Guide. I think from a user standpoint this makes sense. A lot of people seem to have trouble finding it in its current location. > while avoiding duplication. The other choice is to have a separate Math > Guide but continue to have the chapter in the Writer Guide as well. > Comments? What are the maintenance implications? Will it be clear on the building a PDF side that the Math part included in the Writer Guide is essentially a separate document? On the Wiki, it's easy... but outside of the Wiki? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Introducing myself and need help with wiki
>> If it will help you, I can give you the next level of admin rights on >> the Wiki. You would be able to move/copy/delete pages as well as do >> some user admin (like ban Spammers). Just let me know if you want >> this, and what your Wiki ID is. > > That would be great! My OOo (wiki) username is paolopoz. OK, done. See: http://wiki.services.openoffice.org/wiki/OpenOffice.org_Wiki:Administrators for info on administrators on the OOo Wiki. See: http://en.wikibooks.org/wiki/MediaWiki_Administrator%27s_Handbook for the general Manual of what you can/cannot do as an Admin on MediaWiki. > I think the guidelines are already clear and helpful as they are. > I am a complete ignorant in matter of scripting, but I think it would be > very nice to have an automation that creates the to-be-translated page, > copy in it the content, and adds the basic links (for example the "other > languages" link in the original page). If you think this is possible > (and useful) I can provide more infos of what I have in mind. We discussed this here a while back. Basically as it stands there are no really robust translation tools for MediaWiki. There are a few MediaWiki projects that are working on some ideas for this, but nothing is really in a state that I'd consider usable on the OOoWiki just yet. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Introducing myself and need help with wiki
On 02/04/2010 02:19 PM, Paolo Pozzan wrote: > > Hello all! > I am the lead translator of italian l10n volunteers. Some days ago we started > translating the pages on wiki.services.openoffice.org into our language. > > We are following the translation guidelines whose are linked at the end of > every > "edit" page but, as some translators are not very comfortable with mediawiki, > URL and so on, one of them created a wrong page, so I'm asking here for your > help (hope this is the right place) for delete it. The page is > http://wiki.services.openoffice.org/wiki//IT/Website/Content/help/mailinglists > (note the double slash after the wiki folder). Hi Paolo It's no problem to delete that page. If it will help you, I can give you the next level of admin rights on the Wiki. You would be able to move/copy/delete pages as well as do some user admin (like ban Spammers). Just let me know if you want this, and what your Wiki ID is. Are the Translation guidelines helpful? Can they be improved? Is there anything you need from us (the Doc Team) to make things go smoother for you and the translators? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] FOSDEM input?
On 01/25/2010 03:50 PM, ccornell - OpenOffice.org wrote: > So... if you don't mind being famous for 15 seconds at this years FOSDEM > in Belgium... here's your chance. :-) What we are looking for is one or > two sentences about why you contribute to the Doc Project... what > motivates you. Nothing profound, just something that will add a human > element to the slides. Something like "I'm a part of the documentation > project because it gives me a chance to participate in OOo even though > I'm not a software developer." You know.. that sort of thing. A big thanks to everyone who sent in a quote for the FOSDEM slides! It was nice to see the replies :-) I've picked three... from Barbara, Drew and Daniel and used them on the draft submission to the FOSDEM OOo booth slides. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead Sun Microsystems, Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Translating this wiki in Dutch . pls advice
On 01/20/2010 08:39 PM, Cor Nouws wrote: > Hi *, > > Wanna translate this page > http://wiki.services.openoffice.org/wiki/Sanity_Check_Of_L10n_Builds > > I look at this page > http://wiki.services.openoffice.org/wiki/Help:Translating > and see advice for the {{DISPLAYTITLE:Page title}} ... > > Can someone pls say how to use that exactly? > I would think of the name > /wiki/NL/Sanity_Check_Of_L10n_Builds > Is that OK? > What about the {{DISPLAYTITLE:Page title}} ? The DISPLAYTITLE allows you to rename a Wiki page to any name you want. If you create a page called NL/Sanity_Check_Of_L10n_Builds, then the page title will be the same. If you add {{DISPLAYTITLE:The L10N Build Sanity Check}} then the page title when it's displayed in a browser will be "The L10N Build Sanity Check". The real page name will remain the same... "NL/Sanity_Check_Of_L10n_Builds" but will not be shown on the page when displayed in a browser. Does that make sense? As for your page name... the advice for maintaining the same page name as the source is just advice. In some places on the Wiki it's more important than in others. In the Developer's Guide, I've set it as a requirement that all translations of this book maintain the English page names, and use DISPLAYTITLE to localize the page names. On other pages and parts of the Wiki, this is not always the best choice. On the page you are working on, you could certainly localize the page name itself if you wanted, using something like NL/Valideren van de L10N Compilatie (or whatever the "right" Dutch words would be.. my Dutch is getting worse as time goes on :-) ). If you did this, you could still use the DISPLAYTITLE to remove the NL from the title displayed at the top of the page... using {{DISPLAYTITLE:Valideren van de L10N Compilatie}}. Have I explained it OK? or just further confused things? :-) C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead Sun Microsystems, Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Category:Documentation/BASIC Guide
On 12/15/2009 02:49 PM, T. J. Frazier wrote: > This category is getting quite large (400+ entries): > http://wiki.services.openoffice.org/wiki/Category:Documentation/BASIC_Guide > > Is it most useful the way it is, or do we want to do something like > subdivide it by language (a bot job)? Yes it's getting rather cluttered... in a way it's a good thing though :-) it means people are translating the doc into other languages (the most recent work is with someone setting up to translate to what appears to be Norwegian). Subdividing by language is not so difficult. The WikiBot could quickly pass over this and clean it up... well a few passes, but it shouldn't be too hard to do. There are more than this one Category that could use a clean up like this within the Documentation project. We need to put together a lits and just do it. Technically any one of us can run a bot job on the Wiki in general.. either as our own Wiki user (I can attach bot rights to a user ID) or as a general bot. Best to have bot rights added to those who can/will do some Doc area maintenance jobs since that will maintain the security (I don't like sharing around passwords for common user tools). The main WikiBot I use is pywikipediabot ( http://meta.wikimedia.org/wiki/Pywikipediabot ) which is cross platform (so it'll work in Windows too as long as you have Python installed locally). Once it's set up (it takes a little reading to get your mind around the script syntax the first few times you use it) it's pretty much a fire and forget tool. Set it up, start it on it's job.. wait until it's done. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead Sun Microsystems, Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Welcome to the OpenOffice.org Documentation project!
It's been a while, and I'd like to welcome our newest members of the OpenOffice.org documentation project. Clayton, from where do you have this member list? When soemone joins the Doc Project via the main OOo website, Jean and I get an email, and we go assign them Observer rights [1]. I collect up those emails and every once in a while I send out a short welcome email. The overall project membership list is very long, and not real informative [2]. I cannot say how many people are active, or even ever came back after joining the project. C. [1] http://www.openoffice.org/scdocs/ProjectRoles [2] http://documentation.openoffice.org/servlets/ProjectMemberList -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead Sun Microsystems, Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Welcome to the OpenOffice.org Documentation project!
It's been a while, and I'd like to welcome our newest members of the OpenOffice.org documentation project. dtulpule, stefano_negro, dimitriusathony, threesidedsquare, anandpal, vinayapai, hsulej, lucyche, tnewcomb1229, michellespink, sonigitu, nutshrink, kaprqn, ocavid, murray_abraham, m3rlin, troublegirl, mattyboy, dajo74, torstenr, mich4uonly04 If you haven't done so already, you can subscribe to the dev@documentation.openoffice.org mailing list at: http://documentation.openoffice.org/servlets/ProjectMailingListList Take a look at the OpenOffice.org Wiki to see if anything there attracts your interest: http://wiki.services.openoffice.org/wiki/Documentation Feel free to send a short message to the mailing list to introduce yourself. It would be nice to hear why you chose to join the Documentation Project. It is great to have you as part of the team. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead Sun Microsystems, Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Wikidoc: {{DISPLAYTITLE:{{SUBPAGENAME}}}} works fine
(is there anybody interested in my findings at all?) I am very interested in learning anything I can about how to do the user guides better on the wiki. I'm definitely interested too. A lot of how things are done in the OOoWiki now in the Documentation Project and other places are simply because that's the best way we knew how at the time. We're definitely not using the MediaWiki syntax and parser tools to their full extent. I think we've only brushed the surface of what is possible in MW :-) Not every discovery will be helpful in every place, but look at the improvements that have been made recently.. the changes you guys made to the Master TOC, the relative linking suggestion you had Nino... the experiments with Interwiki linking from Bjoern... It's all really interesting, and all stuff we can use. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Default Translation Links
bjoern michaelsen - Sun Microsystems - Hamburg Germany wrote: Hi List, here is a template that creates links to the translated pages, if they exist at the recommended location: http://wiki.services.openoffice.org/wiki/User:B_michaelsen/Default_Language_Links Here is a test showing how it works: http://wiki.services.openoffice.org/wiki/User:B_michaelsen/Default_Language_Links_Test http://wiki.services.openoffice.org/wiki/User:DE/B_michaelsen/Default_Language_Links_Test Maybe that should be used on pretty much all pages that have a translation? It would also encourage using the standard locations for translations. This template would only work on the english pages linking to the translated pages, but not on a translated page themselves, because to navigate from one translated page to another one needs to replace/remove the language prefix instead of prepending it. However, this is a start and a template to use on the translated pages is just a little more work. Opinions? Otherwise, feel free to copy the template into the global namespace and use it. ;-) If I follow this right.. this will only work if the PAGENAMEs are identical below the ISO lang code. That is not being done with any consistency on any Wiki docs except the Developer's, Admin and Basic Guides. Also, as you said it is not working to go from any language except the English pages. I've used a variation on this that works both ways, but requires passing a variable to get around restrictions on the PAGENAME variable. When a translation is done, the translatior has to do nothing more than copying the Template name to the translated page... then he/she automatcially will get all known translated languages. I've used one template per manual to allow for the dfferent languages the documents have been translated into. For example the Dev Guide uses: http://wiki.services.openoffice.org/wiki/Template:Documentation/DevGuideLanguages and the Admin guide uses: http://wiki.services.openoffice.org/wiki/Template:InterWiki_Languages_AdminGuide (which now that I look at it, needs to be cleaned up... different naming structure because it was done at different times) Restrictions on the PAGENAME variable... you can only have the entire page name including the ISO lang code at the beginning or the very last subpage (SUBPAGENAME). Short of fiddling with lots of parser coding, you cannot easily extract everything past the ISO Lang code. I wonder if there is some combination of the two ideas we can use? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Bot Delete Job
>>> I've just started the WikiBot on this task. It should be cleaned up >>> fairly soon. >> does the bot check "what links here" and the page history also? >> >> I mean, the present procedure with the Template:Delete does not make >> sense, if the bot "just deletes" the labeled pages ;-) >> >> (Then in my eyes, users could be given the delete right, too) > > Good point. I was thinking about that too ... No the bot does not check links and make sure that all pages are "valid" for deleting. When there are a few pages up to be deleted, and I do the actual delete steps, I do check page history etc. So far, no pages I've ever deleted were questionable.. ie they were clearly delete material. I checked a few random samples from the bot run today, and didn't see anything that stood out, so in this case, since there were so many to be deleted, I ran the bot on it... if I hadn't, I'd still be there doing the deletes. :-P There were a lot this time. One saving grace is, if a page is deleted that shouldn't have been, any admin can easily recover either by going to the deleted page ghost and undeleting, or picking the page from the delete log and undeleting. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] wiki translation naming scheme proposal
> True, especially for simple searches with the wiki internal search > tool, localized titles would help. Maybe the "best" i guess would be to > have a translation of Documentation/How_Tos/Calc:_ACOS_function at > NL/Documentation/How_Tos/Calc:_ACOS_function and a redirect from > NL/Documentation/How_Tos/Calc:_functie_BOOGCOS to that page. Really As long as we don't drown in redirects :-) There are a few tools in the wiki to manage redirects... we could experiment a bit with that concept. > cool would it be if we would have a extension that offers a "translate" > button next to "edit" on the english page that presents a form with: > - a dropdown of Languages > - a textfield for a localized title. > If I would fill that form for > "Documentation/How_Tos/Calc:_ACOS_function" with "NL" as language and > Calc:_functie_BOOGCOS as localized title, the following would happen: > - the english page is copied to > NL/Documentation/How_Tos/Calc:_ACOS_function > - the Category NL is added to the created page. > - The text "This page needs to be translated to NL" is added with a > template on top. > - a redirect from NL/Documentation/How_Tos/Calc:_BOOGCOS_function to > NL/Documentation/How_Tos/Calc:_ACOS_function is created > - the user is presented the created page and can start translating. > > Just dreamin' ;-) It might not be so much of a dream... it *would* require some work to set up.. maybe with a focus only on the Documentation subset of the Wiki There is an extension already installed in the wiki: http://wiki.services.openoffice.org/wiki/Help:InputBox and http://wiki.services.openoffice.org/wiki/Help:Preloader which can probably be used to do something very close to what you outlined here... it would require some extra setup though... such as including by Template if possible (so it could be blacklisted from the PDF/ODT book generator). Then this Template would have to be added to every page that was a candidate for translations (the Wiki Bot could probably do this once the Doc categories were cleaned up a bit more). Other questions come to mind such as localizing the tool since there is some good documentation available on the Wiki in languages other than English... but it might be possible. I know there are a few creative types here who seem to enjoy solving something like this :-) C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] wiki translation naming scheme proposal
bjoern michaelsen - Sun Microsystems - Hamburg Germany wrote: > Hi List, > > I wrote a proposal for th nameing scheme to be used for translating > expand on the text in Help:Translating. > http://wiki.services.openoffice.org/wiki/User:B_Michaelsen/Translation_Proposal > > Comments welcome. I would suggest to merge the text into > Help:Translating if nobody objects (or create a page > "Help:TranslatingAdvanced", because otherwise it might scare away > newbies). Some good points in that page. I'm thinking that in [[XX/Main Page]], the "Main Page" part should be the localized title... ie not actually "Main Page" but the translated/localized text for "Main Page" (as the Turkish, Arabic, Vietnamese etc communities have done). This also applies in some ways to the Page Name part as well. There has been some discussion about translated Page Names being in English or localized. For a Wiki document like the Developer's Guide, this is important because the translations are done page by page. It makes it somewhat easier to keep these particular Wiki manuals in sync. Outside of that opinion is split. Some people feel the page should be left with its English original name and localized using DISPLAYTITLE. Others feel that the Page Name itself needs to be localized as well. For me, from a technical maintenance standpoint, it's certainly easier if the page name is left in English and the difference between each language is just the ISO Lang code. it makes it very easy to switch between languages. On the other side is something like this example: http://wiki.services.openoffice.org/wiki/Documentation/How_Tos/Calc:_ACOS_function http://wiki.services.openoffice.org/wiki/Documentation/nl/How_Tos/Calc:_functie_BOOGCOS where a localized title was used (and needed in my opinion). I'm not sure what the right answer is here... to me.. some places need it for administrative reasons, but elsewhere, it's not so important to have the Page Name only in English... and then localized Page Names make sense. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Documentation Category cleanup
> From other wikis I'm used to expect Category Entries at the top of the > page, not at the bottom. It makes life much easier ;-) Do you mean the [[Category]] entry? I don't think there is any rule one way or the other on the OOoWiki. Somewhere along the line, people added Category coding to the bottom of the page.. I'm guessing because that's also where the Category shows up, and it seemed like a good idea at the time. :-) C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] MasterTOC changes slow down the wiki?
IIRC, something I read over on Mw said that changes to templates put the using pages in a queue for updating. This would seem to contradict what Mw says about using templates to change categories, but both may be true; it depends on what "updating" takes place. The transclusion part wouldn't actually change the page's category, until the new link was interpreted, but it would take up a lot of resources. I need to add some documentation on the "lang=" parameter. I'll be very careful about it. ;-) Ah ok, now I know what happened. You're right, a change on a single template cascades to all pages using that template. So in the case of the MasterTOC, and any of its child Templates, a change there cascades to many hundreds of pages. We don't change that Template often so it's not too much to worry about... but good to keep in the back of your mind when we are thinking of changing Templates that have such a high usage. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] MasterTOC changes slow down the wiki?
Is it my imagination, or do changes to the Master TOC template slow the whole wiki to a crawl? I remember something similar happening, when I made a change to it. If true, we might want to pick a "best time of day" to do that. Is that what was killing performance? I was wondering what was up, but hadn't poked the logs etc. yet. We're not using DPL there... and over-ambitious DPLs can kill performance. I don't see anything in that Template that should cause perfomance hits... C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Documentation Category cleanup
I've been working my way through the Documentation Category,a nd am down to just a few more pages that need a proper home. http://wiki.services.openoffice.org/wiki/Category:Documentation Nino: Would you be able to take care of correcting the categories on the orphaned DE pages? # DE/Documentation/OOo3 User Guides # DE/Documentation/OOoAuthors User Manual # Documentation/DE/Dashboard/TestPage # Documentation/DE/How Tos # Documentation/DE/How Tos/Erste Schritte in Impress2 # Documentation/DE/How Tos/Filme in Impress unter Linux ohne Java Jean: I'm not sure where we can put these: # Documentation/OOo3 User Guides # Documentation/OOo3 User Guides/Chapters # Documentation/OOoAuthors User Manual # Documentation/OOoAuthors User Manual/Base Guide # Documentation/OOoAuthors User Manual/Base Guide/Planning Maybe we need a new master category for User Guides? (that could contain the Math, Writer, Calc, Impress etc guides) Thoughts on that? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Wrong page added to FR category
>> This page has been added to the FR category: >> http://wiki.services.openoffice.org/wiki/Category:FR/TableuBord >> >> But in fact it belongs to the OC category: >> http://wiki.services.openoffice.org/wiki/Category:OC/TableuBord >> >> It is written in Catalan which is quiet near French (Tableu vs Tableau). >> >> Is it ok if I delete the FR one? If it's not correct, then it definitely can and should be fixed. A lot of the Categories are applied as a best guess by whoever added it. I've done a lot of guessing myself and had to correct a few hundred :-) > There are several related problems. I am reluctant to dive in and fix > things, because I don't speak either language. Same here. There are quite a few issues raised by TJ. Is there someone from the OC community who can assist on the cleanup? If pages need to be moved or renamed, someone with admin rights can do it (Sophie, you have admin rights), or I can assign admin rights to the OC project lead (if that makes things easier). C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Messed up DE categories
> DE/Documentation has been added only to follow wiki policy for > translated (and synced) pages. The two are concurrent ATM (which is > bad) but I don't see a solution yet, as both have advantages and if one > "wins", it's easy to change the other. > > DE/Dokumentation is kept "clean" and should not deliver irrelevant > stuff, while DE/Documentation is preliminary work still. > > In order not to lose pages, DE/Documentation is located "beneath" > DE/Documentation, which might cause even more confusion. Maybe this > could be solved by revision flagging, but I don't have the time to test > it ATM. [snip] > Yep, but the page belonged to the synced stuff (and contained just some > preliminary stuff, but no valuable info). > > If you consider this a bad practice, please suggest a better one. Ah OK.. I follow now. I don't know if there is any "good' practice for a situation like this. Hmmm.. thinking about it... if I was doing something like this, I would probably follow something like DE/Dokumentation/Übersetzt or something similar. To me I would expect that would be somewhat clearer to the German readers than DE/Documentation for the translated docs. Then you could make the DE/Dokumentation/Übersetzt Category a subCategory of DE/Dokumentation to keep the structure intact. I don't know if that would be better or not.. just an idea that popped into my head this morning. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Messed up DE categories
> Sorry, I just reverted your edit on DE/Documentation and now I don't > find the mess any more. I had the impression that a whole bunch of > pages were changed. Maybe I confused them with the (few) pages under > the Documentation/DE tree. > > Next time I will investigate more accurately. :-) No worries. Now I'm confused though... What's the difference between the DE/Documentation category and the DE/Dokumentation category? I see in the text of DE/Dcoumentation that you note there is a parallel DE/Dokumentation. Why have both? It seems to be quite redundant (looking at it from the outside). This seems to be the source of the problem after you mentioned using localized categories, and pointed at DE/Dokumentation, I went with the idea... and added a DE page to that category. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Wiki: Category:Documentation overloaded
On 11/22/2009 08:24 PM, Nino Novak wrote: > On Sunday 22 November 2009 18:30, Clayton wrote: > >> Part of the prob on the Wiki is that thousands of pages have no >> Category at all.. :-( > > (For me, this is not a problem) Finding something and just general navigating in the ever growing pile of randomly named pages, both in the Doc part, and in the rest of the Wiki is becoming more difficult for many people. I'd guess that you are one of this group :-) since you've noticed that the Documentation category is quite overcrowded. You use Categories to navigate around... so do I. Pages with no category are just as bad as all pages in one category. > Then I'd suggest to use another category (like Doc/ToDo or similar) > instead of making the existing Category unusable just for a Test. Sure... that could be done. I didn't think of it when I ran the bot on Friday. The bot can and will be passed over the Documentation again to tidy things up. The puddle of pages in the Doc root Category is not permanent. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Wiki: Category:Documentation overloaded
>> My impression is, that overloading a category impairs its >> functionality. A Category can be a good instrument for getting an >> overview but if its contents is scattered through several pages, the >> overview is lost - which is the case with the Documentation Category >> at the moment. >> Please consider consequences before moving thousands of pages into one >> category, particularly if it's a "main" category like Documentation. >> A good number is about +/- 100, I think. If a category has >> significantly more pages or subcategories, it starts to get confusing >> and - at least in my opinion - further granularization is needed. >> Nino > > You are, of course, quite right; but this is IMHO a temporary step in > the process of getting better organized. For instance, look at the > number of pages in Cat:Doc whose page names begin with Doc/HowTos/Calc. > They clearly belong in the sub-category of the same name. Unless I'm > very mistaken, Clayton intends to use a bot to do that, and to do > similar things. > > Once he has done that, the rest of us can help with the individual pages > that are left over. Personally, I suggest that Cat:Doc should not have > any pages in it at all, only sub-categories. And, we need to decide how > to categorize the translations. > > We will probably end up with a large Help:Doc/Categories page, > explaining how we want to do things. > > Sounds like great fun, to me! :-) Shuffling the Categories around is not so hard with the Bot. We just need to identify what belongs where... and I or anyone with access to the OOoWikiBot user can run the Bot over the pages. Part of the prob on the Wiki is that thousands of pages have no Category at all.. :-( Reassigning pages from the parent to the SubCategory can and should be done - I agree with both your comments... 1000s of pages in a Category makes the Category unusable... each book or topic can and should be moved to an equivalent sub category, and the Documentation Category will be slimmed down to just the subcats. The Calc: pages I moved on Friday were moved to the Doc parent category partly as a test to be sure I could successfully tinker with the Categories using the Bot (used a newly developed script for it), and partly just to start weeding my way through the thousands of uncategorized pages that are part of the Doc project (it's easier to clean up the pages once they are broken into at least the parent categories). C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] How to make localized sites
>>> 1) Move every page at >>> http://wiki.services.openoffice.org/w/index.php?title=Special:UncategorizedPages&limit=2400 >>> in a at least vaguely fitting category. Those are maily a few huge >>> groups: >>> - ~700 pages in "Documentation/How Tos/Calc:" >>> - ~100 pages of "ReleaseStatus Minutes" >>> - ~100 pages of "Log Mac"-pages >>> - ~70 pages belonging to Education >>> - ~50 pages belonging to "OOoES" >>> - ~30 pages of "Renaissance" I've started passing the WikiBot over some of these pages. So far just the How to/Calc: pages, adding the Documentation Category to them. I'm keeping a list of all pages edited, so I can send the WikiBot back over them again to add other Categories as needed... I'm not sure what other Categories need to be added though. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Wiki Mind Map on OOoWiki
> what do you get exactly? > Is the html output ok? > Or don't you even get the html? > Does the flashplayer open? > Which flashplayer do you have installed? For mine, Adobe says "You have > version 9,0,124,0 installed" This is what I see - and no matter what is typed into the search box, no results (maps) are returned, or at least none are shown. http://www.smaug42.com/snapshot2.png Flash version is 10.0.32.18 I would say that the Flash player doesn't even load in this case - although if I go to the WikiMindMap.org page and search there it works fine (searching Wikipedia and returning maps). This is the same behavior that I saw yesterday while I was testing with Solaris/Firefox and if I remember correctly Flash 10 as well. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Wiki Mind Map on OOoWiki
>>> [1] http://ninonovak.de/ooo/wikimap/ (for testing only) >> >> This is as far as I got too. If you enter a search term, you get no >> graphics back - at least I don't when I try it on your test install - >> which is the same results I got. > > But I do see the graphics - although the parser does not seem to > recognize the links of the main page - but if you try searching for > "Development" or "FR" you get nice maps - see screenshot for FR: > http://ninonovak.de/ooo/wikimap/wikimap-FR.png Hmmm... strange. I search on anything... FR, Development, Documentation etc.. I get a blank where the map should be. I see we're both on Linux (I'm using openSUSE 11.2 with KDE4.3.3 and Firefox 3.5.5) so it's not likely a Linux quirk yesterday I was testing on Solaris and getting the same blank map results. Strange. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Wiki Mind Map on OOoWiki
> I just had a little time to try it out[1], there is a small bug in > getpages.php: the first line before the " Just delete this empty line and everything should go smooth :-) > > Nino > [1] http://ninonovak.de/ooo/wikimap/ (for testing only) This is as far as I got too. If you enter a search term, you get no graphics back - at least I don't when I try it on your test install - which is the same results I got. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Wiki Mind Map on OOoWiki
On 11/19/2009 05:38 PM, Nino Novak wrote: > On Thursday 19 November 2009 15:46, ccornell - OpenOffice.org wrote: >> One of the requests I got during OOoCon this year was to install a >> Wiki Mind Map on the OOoWiki. >> >> I've been experimenting with this off and on over the past few days, >> and not really making a lot of progress. >> >> Sophie suggested this one: http://www.wikimindmap.org/ If you click >> About it will take you to pages where you can download the source and >> install on your local Wiki. I've done that, and had it working for a >> while... but it only wants to create Mind Maps of Wikipedia. In >> theory we should be able to convince it to Map any Wiki, but I've not >> managed... all I get is a blank page. Not sure where to go on this >> one. > > What does the php error log file say? M I should have been clearer... the page loads but where the map is supposed to be is just blank. All controls work etc, but you zoom in etc on nothing. So, it's not a blank page caused by a fault in the php. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Transluding more content to or from the Policy Page?
> how can an author see that some text is also readable on another page > (a.k.a. transcluded)? Does the WYSYWYG editor show this information? How > easy is it to accidentally break the link or to edit the source text in > a way that the target text becomes invalid? > Then leave the original source where it is most important, or where the > most page hits are expected. That's the point of transluded text. It's located in one place, but looks like it's part of many pages. If someone edits the text, it's edited in-line in the page they start editing from (or appears that way to the editor). If you open the original, it has a begin and end tagging around the transcluded text. Any text can be broken.. is it easy to break.. sur.. remove the {{lst}} link in the target page.. the source is no longer included. I woudln't concern myself about it... someone could go and delete any number of paragraphs in any page... same effect. Translusions are used in quite a few places.. the User Guides for example have transcluded text - as I discovered a while back :-) C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Transluding more content to or from the Policy Page?
I've been looking through the Wiki Policy page, and I think large sections of it are generic enough to become general Wiki Help pages. The best way (in my opinion) to be sure we're not loosing content or duplicating our efforts is to transclude the content... which way is better though? From the Help page into the Policy? or Policy into the Help? My thoughts the generic content could be moved to the appropriate Help:Pagename and then transluded back into the Wiki Editing Policy Page (like I've done with the Help:Translating page). This allows us to maintain the generic Help pages, and also the fine tuned Doc Proj specific guidelines without duplication. The start point for the Wiki Help pages is here: http://wiki.services.openoffice.org/wiki/Help:Contents This is the page you land on if you click Help on the left nav bar/box. Good idea? Or other ideas? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] How to make localized sites
> Yes and sometimes also translating off line. The offline translating is another bit of fun :-) This process (as it evolves) done by those of us in the Doc Project and the L10N project is nto as much of an immediate issue. It does need work and a lot of refining but the people working on this side of things are not replacing text in the original pages with translated content :-) > What we (l10n teams) would like to have his a conversion to .po or xliff > so that we can work with our translation tools and most important our > translation memory. This ensure consistency between the UI, help files > and the documentation because we use the same glossary/terminology for > them. > We have discuss this during OOoCon. But the export/import filters are > not going very well from what Rafaella told us. > It seems to be possible to export wiki content to .po, this is used for > translating offline mediawiki extensions. See the page here : > http://translatewiki.net/wiki/Translating:Offline > but I don't know how it would be manageable for us. If there is anything that we need to try out to possibly make the more formal translation process move along move efficiently, we should look into it. Installing an extension for testing is not hard... I just need to know which one, and have someone available to test it (particularly in the case of translations). C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] How to make localized sites
> There is another section in the Wiki Editing Policy about the linking of > localized pages > http://wiki.services.openoffice.org/wiki/Documentation/Dashboard/Wiki_Editing_Policy#Linking_to_localized_pages > > > Shouldn't that also be part of the Help:Translating page? If you want to > transclude this also, I would suggest to put it under the > Localizing_Content section to have two subsections there, and to delete > the Linking_to_localized_pages under General_Editing_Work. H... it might be better merged into the text here (with a little rewriting) http://wiki.services.openoffice.org/wiki/Help:InterWiki and then transcluded back into the Policy page. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] How to make localized sites
>> There are (currently) no tools or mechanisms in place in the Wiki to >> assist with translations. The process is basically: >> 1. Identify a page that is to be translated >> 2. Click Edit >> 3. Select all text and copy >> 4. Cancel the edit >> 5. Start a new page with the "right" page name for the new translated >> article >> 6. Paste in the copied original language text >> 7. Save to give a start point >> 8. Translate the text on the new page >> >> It's a bit cumbersome, but this is generally how various language >> groups are doing this (with some variations such as doing the >> translations on sub-pages of their user pages etc.). >> > Thanks Clayton. I added the process description to the Wiki Editing > Policy. As long as we have no other solution, it's at least documented > now somewhere. I've created Help:Translating, and edited the Wiki Editing Policy to transclude the text from the Help page back into the Policy page. http://wiki.services.openoffice.org/wiki/Help:Translating http://wiki.services.openoffice.org/wiki/Documentation/Dashboard/Wiki_Editing_Policy#Localizing_Content C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Clayton, what's up with the wiki?
Nino Novak wrote: > Ok, it's responding again. > > Nino > PS Sorry for thread hijacking :-( > > > On Thursday 12 November 2009 18:51, Nino Novak wrote: >> you need not answer - just in case you don't know that the wiki is >> not responding. H Can't see anything obvious that was wrong. I'll poke the logs and see if anything turns up. C. - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] doc & OOoCon
> * Others (like me) hold that ideas are plentiful, and cheap; we think of > a rough-and-tumble intellectual arena, where ideas must take their > chances--and their lumps. This is the "Roberts Rules of Order" method, > the way the U.S. Senate conducts business: roughly, "Ideas may be > debated with the utmost vigor; due courtesy must be shown to all > individuals." This is my approach. :-) I hope to encourage more of this kind of discussion in our group. I'd like to see a little mini-revolution of sorts to pull us out of our documentation rut and liven things up a bit. It's nice to see people jumping in and noting down their thoughts and ideas. As bits are hashed out, or even implemented, I'll move the bits off the Ideastorm page - eg, once I've installed the MindMap extension, I'll move that input to a "completed" page So, everyone, please feel free to keep entering your thoughts on that page... new ideas... thoughts on other ideas.. disagreements too. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] doc & OOoCon
> I first downloaded it to a 100M-Backbone connected server by wget, then > split the file into 80MB pieces and finally scp-transferred the pieces > to my local machine :-) Ouch.. > For the Ideastorm page: obviously I'm late with my suggestion to keep > the page itself free from discussion as this blocks any > "Ideastorm" (This is a well known fact among moderators and > facilitators). True, but on the upside, we're using that page as a place to collaborate on ideas... I'm Ok with it going that way... and... it's Wiki, we can easily split things up and move discussion if need be. The discussion part is healthy and a good way to hash out the ideas and get something in the end we can act upon. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] [Fwd: [webmasters] Web page dates -- Please prefer ISO 8601 standard]
Nino Novak wrote: > On Wednesday 11 November 2009 10:54, Clayton wrote: >>>> 2009-08-11 (Aug 11) > ... >> http://wiki.services.openoffice.org/wiki/Documentation/Wiki_Books > > Clayton, 3 = March, not April ;-) Ha.. ooops :-) Fixed. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] doc & OOoCon
Nino Novak wrote: > On Sunday 08 November 2009 13:40, Clayton wrote: > >> The doc team session is at the beginning of the 6 Nov morning session. > ^ > Ok, after your successful deception attempt I finally found the session > on Nov 5th morning, in the Sala Etrusca folder ;-) Note to self, re-read before clicking send. I didn't even notice the wrong day, or the fact I missed the rather important bit of letting everyone know which video to watch :-P Sorry about that. > the stream does not seem to work for me and the (huge) .ogg file does > not download completely on my slow internet (3 attempts, each about 2 > 1/2 hours, truncated after 70-90 MByte) > > Now, my repeated download attempts seem to even have broken their > server ;-) > > So I'll continue my glorious attempts tomorrow. > > If - by chance - somebody knows a better solution, I'm open to any > advice. This is a bit of an issue since they streamed and recorded the sessions essentially nonstop.. so you get a 4 or even 8 hour OGG and MPEG file. They are not small. Have you managed to stream the video yet? or download it? I'm putting together an overview email with my impressions and points that stuck out to me from the doc session - hopefully it'll spark some discussion :-) The Ideastorm page is filling up with comments now... arguments on both sides. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] [Fwd: [webmasters] Web page dates -- Please prefer ISO 8601 standard]
>> If we simply repeat some information, we could represent those dates as >> 2009-08-11 (Aug 11) >> which is unambiguous for all languages and locales. Even a non-English >> speaker should correctly note which number has been changed to a month >> name. > > That is a good idea and an easy solution to the problem. Yup, good solution... I like it :-) As a first attempt at it, I fixed up the dates on this page: http://wiki.services.openoffice.org/wiki/Documentation/Wiki_Books using the suggested format. Looks OK to me. > Clayton may correct me on this, but I believe that this page, and all > the associated PDF files, are on our list for migration to the wiki, as > part of a general rationalisation of the way documentation is provided. > That is, the user guides, like the developers' guides, will then be > available in downloadable form through the wiki... even though (at least > for the immediate future) the source docs for the UGs will continue to > be ODT files residing on the OOoAuthors website, with the the wiki > version derived from the ODT version instead of the other way around as > for the developers' guides. It is definitely easier to maintain the content via a Wiki page vs the older html page style (requiring CVS access etc.) We can upload the ODTs and PDFs to the Wiki, and/or upload them to the OOoAuthors repository (is there one?), and then link them via a master doc page - the result is the same - a single page listing downloadable docs for an OOo release family. We can do the same from the main Documentation page.. instead of a link to an html page listing the available docs, I can change that to a link to the Wiki page (once it's in place) showing the same info. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] [Fwd: [webmasters] Web page dates -- Please prefer ISO 8601 standard]
> May be it's an idea to use ISO date in the documentation written in > English ? [snip] >-MM-DD HH:MM ...which subsequently confuses people who use DD-MM instead of MM-DD. Personally, after having lived in Europe for several years, and becoming used to date conventions used here, I'd read a date written; 2009-11-08 as 11 August 2009, not 08 November 2009 as it would be according to ISO8601. This problem is illustrated by: http://www.w3.org/QA/Tips/iso-date (where it discusses both the problem of using numbers, and the issues of crossing languages and cultures). Also worth reading on this is: http://www.w3.org/International/questions/qa-date-format including the Pros and Cons of ISO8601. The Summary on this page comes to the same conclusion I've come to in the past: (quoting) "If there is likely to be any ambiguity on the part of the user, it is usually best to use explicit month names and 4-digit years for Gregorian dates, or at least indicate on the page how to read the dates." My thoughts on this... if we do switch to ISO8601 date formats, then we would need to be explicit about it - stating exactly what date format is being used. Anyone else have any thoughts on this? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] doc & OOoCon
Nino Novak wrote: > On Friday 30 October 2009 21:01, Andreas Mantke wrote: >> Hi Nino, >> >> Am Freitag 30 Oktober 2009 18:33:14 schrieb Nino Novak: >>> Is it planned (e.g. by the doc project ;-) ) to document the >>> Orvieto sessions in good quality video? >> there are some discussions about this topic on the OOoCon list. I >> hope the team can manage it. > > Any news in this matter? > > For http://media.lscube.org/oooconf I was not able to install the > appropriate plugin (and BTW did not find the doc team session at > all???) All sessions were recorded and can be streamed or downloaded on the link you provided above. I don't know what plugin or codec is required... it "just works" for me in FireFox on openSUSE Linux both on my netbook, and on my desktop I didn't have to do anything special. The doc team session is at the beginning of the 6 Nov morning session. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] OOoCon2009 has started
OOoCon2009 has started. For those of you not able to attend the conference this year, you can still take part remotely if you're interested... I will have Internet access throughout the day at the conference (I hope), and will try to monitor the Docs IRQ channel off and on throughout the day... the day being day in Italy :-) If you have questions you'd like me to relay, or want to chatter a bit on the IRC channel, stop by and say hi. If you can't be online during the conference day, then an email will work too. If you're thinking of asking questions, or "listening in" on IRC, make sure I'm in the chat room so I see your comments. C. - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Wikidoc: Licensing
Nino Novak wrote: > Finally, I'm trying to finish work but still need a little help. > Could you please be so kind and add a bot flag to user NninoBot. Done. If you need anything else, just let me know. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Chinese translation of the OOo User Guides
T. J. Frazier wrote: > T. J. Frazier wrote: >> Clayton wrote: > ... > >>> >>> I've contacted this user and asked that they join this mailing list so >>> that we can assist then, and undo the "damage" done to the English pages >>> without loosing their translations. >>> >>> C. >> Do we need a "Translators' How-To" (or Help)? >> > BTW, let's get this Guide started off right, with a TOC_ZH, and using > the MasterTOC. > Good point... I've rolled back the first page of translations this person did, and then created a Zh page to start the document: http://wiki.services.openoffice.org/wiki/Zh/Documentation/OOo3_User_Guides/Calc_Guide I'm still trying to get in contact with the person doing the translations... I'm going to post to the l10n mailing list as well... some of the Chinese community hangs out there and may be able to help sort this out and explain (in Claire's native language) what needs to be done. I've checked the new content, and what I pushed through the Google translator seems to be accurate translations of the original content. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Chinese translation of the OOo User Guides
T. J. Frazier wrote: > Clayton wrote: >> A new user popped up on the OOoWiki, and this person has been busily >> translating the OOo3 User Guides into Chinese. See: >> http://wiki.services.openoffice.org/wiki/Special:Contributions/Claire >> >> The problem is, this person is doing the edits right in the English >> pages instead of creating a Chinese page. >> >> I've contacted this user and asked that they join this mailing list so >> that we can assist then, and undo the "damage" done to the English pages >> without loosing their translations. > > Do we need a "Translators' How-To" (or Help)? There is a little bit of info available here: http://wiki.services.openoffice.org/wiki/Documentation/Dashboard/Wiki_Editing_Policy#Localizing_Content It does not cover all scenarios... and it is focused primarily on the Developer's Guide. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Chinese translation of the OOo User Guides
A new user popped up on the OOoWiki, and this person has been busily translating the OOo3 User Guides into Chinese. See: http://wiki.services.openoffice.org/wiki/Special:Contributions/Claire The problem is, this person is doing the edits right in the English pages instead of creating a Chinese page. I've contacted this user and asked that they join this mailing list so that we can assist then, and undo the "damage" done to the English pages without loosing their translations. C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Doc Project IRC channel
Hi everyone. I've registered an IRC channel for the docs project. This is a public channel, and open to anyone to join. The channel name is: #openoffice.org-docs Feel free to pop in an chatter anytime. I've added it to the IRC channel list here: http://wiki.services.openoffice.org/wiki/IRC_Communication C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Wikidoc: Licensing
Alan wrote: > (eg you can't make a blanket copyright statement for the Wiki > that affects and changes the license for existing content) > > Why not? You can if it's there from day one... but on the OOo Wiki.. it hasn't been clearly stated from day one thus the ambiguity, and the pages with content under different licenses. > There has to be a way people can get together and de-complicate things. > > Why should licensing tie knots in people who want to work together and > have common desires? > > Isn't there someone out there who is brilliant with this kind of thing > who can sort out all of these issues for us? > > Someone who is really good at finding solutions in this particular area? > > There has to be. There probably is someone who knows how to sort it out. It's not me though :-) Some time ago, I made an attempt to clarify the license that Wiki content was placed under, and it was quickly reverted. The reason being (as I understand it) is that it's almost impossible to re-license existing content without getting signoff from every contributor. There is a lot more to it than simply changing the Copyright page. It would be nice if someone with a working knowledge of the legal side of open source licensing could step up and sort it all out... I don't know anyone who can though (and who has a clear understanding of the legal ramifications). C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org