Re: [documentation-dev] Project status and OOoCon
Jean Hollis Weber wrote: > Frank, I agree with all you have said in this presentation. This is > definitely the direction we need to go as a documentation project. Thanks. Too bad you won't be there. I shall suggest Australia for OOoCon2008 :-) > Kirsten Milligan wrote: >> 1) Substitution of the word "currency" for "up-to-dateness": It is >> an unconventional use of "currency," but I think it's a great word for >> the meaning. Just a personal preference. > > I disagree. Plain English is best, especially since many people in the > audience at OOoCon have English as a second (or third) language. An > unconventional use of a word could detract from the message. Hope you're getting well fast! Frank - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Project status and OOoCon
Joe Smith wrote: > Kirsten Milligan wrote: >> ... > > Sorry, I'm tacking on to Kirsten's message instead of the parent. > > The presentation does look great--nice job with the layout and > organization! Yes, and exciting to see all the changes together in context. Thanks > Very nice touch to include the picture of Gerry; sorry I never had a > chance to meet him in person. I never met him personally and just talked over the phone but he kept the doc flag up for quite a while. > I just wanted to add a comment on some of the points under > "up-to-dateness" (Slide 12). Not for the conference so much, just in > general. > > Hanging out on oooforum, there are regularly people asking questions > about 1.x and 2.0.x. IMO, it would ideal if the current documentation > retained at least some clues about the version history. E.g. if the > documentation for feature X included information like "This feature > first appeared in OOo 2.3". Good point. In the FAQ we started to add version labels to questions. Generally, I would like the docs to address the most current version only and have older docs move to some archive. For more living resources like the FAQs the version labels should suffice. > I realize that is yet more work and just keeping current is already a > strain, but if we lose the history, then people using an old version are > likely to be terribly confused when the docs don't match what they're > seeing. Right. I'd like to encourage everyone, however, to always use the most current version. Usually, they contain many bugfixes and improvements beside new features. And it's free - so what's the deal ;-) Frank - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Project status and OOoCon
Hi Kirsten, > Hello, Frank. I, too, have lacked time to participate as I would like. > Once I take the initial step of beginning to contribute, I think it will > be easier to continue active, but finding the right inroad takes time > and attention that I've been pouring into another endeavor. I *do* want > to be part of OOo. that's ghood to hear. As you can see from the preso, we *do* want to make it easier for folks to contribute. I know that currently the learning curve is still too steep. > Anyway, I looked over the document you sent, and boy do I want to go to > Barcelona! The presentation is attractive, friendly, informative and, > to my uninitiated eye, well organized. Two minor suggestions: Thanks for your kind words. > 1) Substitution of the word "currency" for "up-to-dateness": It is an > unconventional use of "currency," but I think it's a great word for the > meaning. Just a personal preference. > > 2) On page 16, under "Benefit," rather than using the word again as a > verb, you might substitute "Access" for "Benefit from." > > Happy to be a part, however small, as yet! And I love what I see in the > presentation. It addresses exactly what makes it difficult for me to > get started as a contributor! Thanks again. I will include your suggestions in the presentation. Frank -- Frank Peters, Documentation Project Co-Lead The OOo Documentation Project: SIGN UP - PARTICIPATE - CONTRIBUTE IT'S FREE! NO OBLIGATIONS! http://documentation.openoffice.org http://wiki.services.openoffice.org/wiki/Documentation - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Project status and OOoCon
Frank, I agree with all you have said in this presentation. This is definitely the direction we need to go as a documentation project. Kirsten Milligan wrote: 1) Substitution of the word "currency" for "up-to-dateness": It is an unconventional use of "currency," but I think it's a great word for the meaning. Just a personal preference. I disagree. Plain English is best, especially since many people in the audience at OOoCon have English as a second (or third) language. An unconventional use of a word could detract from the message. --Jean - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Project status and OOoCon
Kirsten Milligan wrote: ... Sorry, I'm tacking on to Kirsten's message instead of the parent. The presentation does look great--nice job with the layout and organization! Yes, and exciting to see all the changes together in context. Very nice touch to include the picture of Gerry; sorry I never had a chance to meet him in person. I just wanted to add a comment on some of the points under "up-to-dateness" (Slide 12). Not for the conference so much, just in general. Hanging out on oooforum, there are regularly people asking questions about 1.x and 2.0.x. IMO, it would ideal if the current documentation retained at least some clues about the version history. E.g. if the documentation for feature X included information like "This feature first appeared in OOo 2.3". I realize that is yet more work and just keeping current is already a strain, but if we lose the history, then people using an old version are likely to be terribly confused when the docs don't match what they're seeing.
Re: [documentation-dev] Project status and OOoCon
Hello, Frank. I, too, have lacked time to participate as I would like. Once I take the initial step of beginning to contribute, I think it will be easier to continue active, but finding the right inroad takes time and attention that I've been pouring into another endeavor. I *do* want to be part of OOo. Anyway, I looked over the document you sent, and boy do I want to go to Barcelona! The presentation is attractive, friendly, informative and, to my uninitiated eye, well organized. Two minor suggestions: 1) Substitution of the word "currency" for "up-to-dateness": It is an unconventional use of "currency," but I think it's a great word for the meaning. Just a personal preference. 2) On page 16, under "Benefit," rather than using the word again as a verb, you might substitute "Access" for "Benefit from." Happy to be a part, however small, as yet! And I love what I see in the presentation. It addresses exactly what makes it difficult for me to get started as a contributor! Thanks. Kirsten Milligan - Original Message - From: "Frank Peters" <[EMAIL PROTECTED]> To: Sent: Thursday, September 13, 2007 7:25 AM Subject: [documentation-dev] Project status and OOoCon Hi, sorry for being do quiet lately. I had to catch up with some things after my vacation. We have been busy working on the presentation for OOoCon in Barcelona. You can find the final drafts (or draft finals) here: http://documentation.openoffice.org/preso-ooocon2007-docproject.odp http://documentation.openoffice.org/preso-ooocon2007-docproject.pdf Feel free to have a look. If you have feedback be sure to let me know before tomorrow evening since we need to hand the presentations in by then. Going through the presentation you see some of the ideas for the future of this project. Many of those are directly based on feedback from all of you and it would be great if we can work on these ideas together. The wiki will definitely be a major theme going forward and we emphasized that by starting to consolidate information and give our section of the wiki a usable structure: wiki.services.sun.com/wiki/Documentation Here at Sun we had made some progress in getting all of the Sun documentation content open sourced. I already ported the Administration Guide to the wiki: http://wiki.services.openoffice.org/wiki/Documentation/Administration_Guide and very very soon, a giant piece will follow with the Developers Guide (more than 900 wiki pages) thanks to the tireless efforts of Clayton Cornell. Once on the wiki, we can all work on those pieces making them even better ;-) (Note that for all features to work the OOowiki engine needsa to be updated. We're working with the maintainers to get that done quickly) I'm hoping to be able to touch base with many (at least some) of you in Barcelona next week. If you plan to attend, let me know and be sure to visit the doc.oo.o presentation on Friday. Frank -- Frank Peters Documentation Project Co-Lead The OOo Documentation Project: SIGN UP - PARTICIPATE - CONTRIBUTE IT'S FREE! NO OBLIGATIONS! http://documentation.openoffice.org http://wiki.services.openoffice.org/wiki/Documentation - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- No virus found in this incoming message. Checked by AVG Free Edition. Version: 7.5.487 / Virus Database: 269.13.16/1005 - Release Date: 9/13/2007 11:45 AM - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
