Re: [documentation-dev] Editing
On 02/12/10 17:50, Claire Wood wrote: I don't mind looking at the Impress Guide tonight and this weekend if it is urgent and needs updating. I have loads of time on my hands being unemployed at the mo. Otherwise I can concentrate on the Getting Started Guide on the Wiki. Just let me know which you'd prefer. Any help you can provide is going to be very welcome! If you want to look at the Impress Guide, then the best place to work on that doc is on the ODT version you will find in the oooauthors.org website - this is the most current version and will be the doc used to publish the final Guide. There are instructions here: http://www.oooauthors.org/english/userguide3/res3/howto_review explaining how to check out a chapter for review. If there are any probs along the way, just ask. There are quite a few experienced people here who know the process very well :-) 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] Editing
Jean There are a number of graphics and text mismatches, unless I've got the meanings of dialog and dialogue confused. I always thought dialogue was the UK version of dialog. On the following pages either the text says dialog and the graphic says dialogue or, certainly on one, I've changed dialog to dialogue as in the style guide it says to replicate the screen options, but I'd advise that something be standardised or else a kindly reminder goes out to keep dialog/dialogue spelt in a certain way, because it could be confusing to someone who has English as a second language or doesn't have very good English. I've marked the pages with the Need Help marker and given a brief description in the marker to save time. I've also listed the pages below: The first Graphic has had the text changed to replicate what the image says. http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Getting_Started/Open_and_Save_As_dialogs In the first graphic dialogue mentioned and if you scroll down to General Options, that graphic also has dialogue in it. http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Getting_Started/Choosing_options_for_all_of_OOo With the next graphic, I don't have a graphics package, just a screen capture tool, so I couldn't add the numbers. Can anyone help please? http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Getting_Started/Parts_of_a_dialog I need help with the templates because I couldn't get the template message to come up when you edit a template. So the accuracy needs checking and I've flagged it as I couldn't check whether the macro was still relevant. http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Getting_Started/Editing_a_template I found that a large amount of my time was spent putting in links and amending references to the Guides - real pain. I've just been working through the Getting Started Wiki Guide and tonight I've got as far as the Getting Started with Impress and will start that tomorrow as I'm too tired now. I'm on a course from Monday to Thursday so if no-one else can do the rest of the Getting Started wiki I'll pick it up again on Friday. Claire On 12 February 2010 14:48, Jean Weber jeanwe...@gmail.com wrote: If you can update the wiki version of Getting Started to match the odt that would be best. I think chs1 2 are mostly updated but some of the others have major changes including changed pix. I can't check my list but if you can find the spreadsheet I made on GoogleDocs I think the GS page is up to date. It may be linked from our websIte or someone can tell you. Thanks! Jean On Saturday, February 13, 2010, Claire Wood clairedw...@googlemail.com wrote: I don't mind looking at the Impress Guide tonight and this weekend if it is urgent and needs updating. I have loads of time on my hands being unemployed at the mo. Otherwise I can concentrate on the Getting Started Guide on the Wiki. Just let me know which you'd prefer. Claire On 12 February 2010 01:23, Clayton ccorn...@openoffice.org wrote: 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 -- Best wishes Claire Wood -- Best wishes Claire Wood - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Editing
On 2/13/2010 6:29 PM, Claire Wood wrote: Jean There are a number of graphics and text mismatches, unless I've got the meanings of dialog and dialogue confused. I always thought dialogue was the UK version of dialog. On the following pages either the text says dialog and the graphic says dialogue or, certainly on one, I've changed dialog to dialogue as in the style guide it says to replicate the screen options, but I'd advise that something be standardised or else a kindly reminder goes out to keep dialog/dialogue spelt in a certain way, because it could be confusing to someone who has English as a second language or doesn't have very good English. I've marked the pages with the Need Help marker and given a brief description in the marker to save time. I've also listed the pages below: The first Graphic has had the text changed to replicate what the image says. http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Getting_Started/Open_and_Save_As_dialogs In the first graphic dialogue mentioned and if you scroll down to General Options, that graphic also has dialogue in it. http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Getting_Started/Choosing_options_for_all_of_OOo With the next graphic, I don't have a graphics package, just a screen capture tool, so I couldn't add the numbers. Can anyone help please? http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Getting_Started/Parts_of_a_dialog I need help with the templates because I couldn't get the template message to come up when you edit a template. So the accuracy needs checking and I've flagged it as I couldn't check whether the macro was still relevant. http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Getting_Started/Editing_a_template I found that a large amount of my time was spent putting in links and amending references to the Guides - real pain. I've just been working through the Getting Started Wiki Guide and tonight I've got as far as the Getting Started with Impress and will start that tomorrow as I'm too tired now. I'm on a course from Monday to Thursday so if no-one else can do the rest of the Getting Started wiki I'll pick it up again on Friday. Claire Jean can give her own account, so I am not speaking for her... I must profess ignorance about any style guide other than the ones used by OOoAuthors. But for their user guides, most or all of the spelling follows US English, where there are differences between US and UK English. The punctuation used is mostly US English, similar to The Chicago Manual of Style and others like it. But the only major difference lies in the close quotation mark usage. For that reason, I avoid using quotation marks in general and have altered the former See to in the older user guides that contained quotation marks to parentheses--to avoid this issue. In addition, in copyediting the user guides, I note the distinction in US usage pertaining to that/which--an issue that is relatively unimportant in much UK usage. However, since the that/which distinction is taught in practically all US schools (and the Brits generally do not care...), I follow the US custom so as not to differ from US practice, in that regard. As to dialog box: If dialogue pops up, I simply change them to dialog. I always use the term dialog box whenever referring to the dialog box GUI component and always name the particular dialog box instead of simply stating that a dialog box opens. Also, with all GUI components, I try to use the exact terms and not abbreviate them to, say, dialog without the box. Some writers use the term drop-down (or dropdown) by itself when referring to a drop-down list. Again, the Wikipedia uses the two-word version drop-down list. Most style guides used by most (all?) of the major software developers are very consistent among themselves in strict GUI-component usage and mandate dialog box over dialog whenever referring to the GUI component, but may occasionally use dialog (by itself) when referring to a dialog (a two-way conversation). The Wikipedia has a decent account for dialog (or dialogue) box: http://en.wikipedia.org/wiki/Dialog_box From Wikipedia, the free encyclopedia In graphical user interfaces /wiki/Graphical_user_interface, a *dialog* (or *dialogue*) *box* is a special window /wiki/Window_%28computing%29, used in user interfaces to display information /wiki/Information to the user, or to get a response if needed. They are so-called because they form a dialog between the computer and the user---either informing the user of something, or requesting input from the user, or both. It provides controls that allow you to specify how to carry out an action. Dialog boxes are classified as modal /wiki/Mode_%28computer_interface%29 or modeless, depending on whether they block interaction on the application /wiki/Application_software that triggered the dialog.
Re: [documentation-dev] Editing
I don't mind looking at the Impress Guide tonight and this weekend if it is urgent and needs updating. I have loads of time on my hands being unemployed at the mo. Otherwise I can concentrate on the Getting Started Guide on the Wiki. Just let me know which you'd prefer. Claire On 12 February 2010 01:23, Clayton ccorn...@openoffice.org wrote: 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 -- Best wishes Claire Wood - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Editing
Hi Can anyone help me please? It's 9.25pm UK time and I'd like to locate the spreadsheet Jean is talking about (below) so I can make a start on this bright and early tomorrow. I've done a search on Google but it keeps defaulting to my own Docs account and when I do a wider search on Google I can only bring up Jean's input from 2007 and a search on the OpenOffice website doesn't yield anything either. If not I'll just have to use the pdfs as a guideline but your help would be appreciated. Thank you in anticipation of a positive response. Claire On 12 February 2010 14:48, Jean Weber jeanwe...@gmail.com wrote: If you can update the wiki version of Getting Started to match the odt that would be best. I think chs1 2 are mostly updated but some of the others have major changes including changed pix. I can't check my list but if you can find the spreadsheet I made on GoogleDocs I think the GS page is up to date. It may be linked from our websIte or someone can tell you. Thanks! Jean On Saturday, February 13, 2010, Claire Wood clairedw...@googlemail.com wrote: I don't mind looking at the Impress Guide tonight and this weekend if it is urgent and needs updating. I have loads of time on my hands being unemployed at the mo. Otherwise I can concentrate on the Getting Started Guide on the Wiki. Just let me know which you'd prefer. Claire On 12 February 2010 01:23, Clayton ccorn...@openoffice.org wrote: 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 -- Best wishes Claire Wood -- Best wishes Claire Wood - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Editing
On Friday 12 February 2010 22:24, Claire Wood wrote: Can anyone help me please? It's 9.25pm UK time and I'd like to locate the spreadsheet Jean is talking about (below) so I can make a start on this bright and early tomorrow. The only spreadsheet I know of is http://spreadsheets.google.com/ccc?key=0Asjap9kyrWy_cEpMNl84S3NpVElHTUNDaWZkNlB6V2chl=en HTH Nino - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Editing
Thank you Nino, unless I hear differently I'll assume this is the one. Claire On 12 February 2010 15:36, Nino Novak nn...@openoffice.org wrote: On Friday 12 February 2010 22:24, Claire Wood wrote: Can anyone help me please? It's 9.25pm UK time and I'd like to locate the spreadsheet Jean is talking about (below) so I can make a start on this bright and early tomorrow. The only spreadsheet I know of is http://spreadsheets.google.com/ccc?key=0Asjap9kyrWy_cEpMNl84S3NpVElHTUNDaWZkNlB6V2chl=en HTH Nino - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org -- Best wishes Claire Wood - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Editing
I think that's the one. Thanks, Nino. --Jean On Saturday, February 13, 2010, Claire Wood clairedw...@googlemail.com wrote: Thank you Nino, unless I hear differently I'll assume this is the one. Claire On 12 February 2010 15:36, Nino Novak nn...@openoffice.org wrote: On Friday 12 February 2010 22:24, Claire Wood wrote: Can anyone help me please? It's 9.25pm UK time and I'd like to locate the spreadsheet Jean is talking about (below) so I can make a start on this bright and early tomorrow. The only spreadsheet I know of is OOo_3_Status_of_chapters http://spreadsheets.google.com/ccc?key=0Asjap9kyrWy_cEpMNl84S3NpVElHTUNDaWZkNlB6V2chl=en HTH Nino - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org -- Best wishes Claire Wood - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Editing
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 On Friday, February 12, 2010, Clayton ccorn...@openoffice.org wrote: 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 - 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 the DevGuide. May I?
Hi Guiseppe, that is because some code templates are still wrong. Feel free to correct these bugs. Juergen Giuseppe Castagno wrote: Hi all, while I was reading it (and looking at the wiki source code to grab it for my wiki, to have the DevGuide local on my notebook :-) ), I noted that on the two chapters I'm currently studying (namely 'Professional UNO' and 'Writing UNO Components') not all the example source code is syntax highlighted and some of the link to IDL classes are not using the tags from IDLTagExtension.php. May I help in this area? I mean, editing the wiki whenever I come across one of the two small editor issues pointed out above? Last, I think that a small intro of myself is in order: I'm an OOo developer, community contributor mainly in the area of PDF export code. Lately, I contributed a small addition to Writer index generation for 3.x code line. I have wiki editor access already, since 2006, IIRC. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]