docs April 2007

docs@lists.stg.fedoraproject.org

34 participants
93 discussions

FDSCo Meeting 2007-04-01 Summary
by Paul W. Frields 01 Apr '07

01 Apr '07

Attendees: ----------- * Karsten Wade (chair) * Bob Jensen * Paul W. Frields Absent: * Bart Couvreur * Dimitris Glezos * John Babich * Pawel Sadowski Summary: --------- * Karsten and Paul will create in CVS a per-module Makefile.l10n that will be ACL'd so any cvsl10n members can edit it. L10n'ers can add support for their language in this file once a translation is underway. * Karsten and Paul will send email to fedora-{devel,maintainers}-list noting upcoming relnotes Wiki freeze on 2007-04-02, 2359 UTC. * FDP will start enforcing style guidelines with its writers, to both teach them the ropes and to ensure high-quality docs. Karsten and Paul will finalize the StyleGuide on the wiki¹ and link it from the docs.fp.o site. * Bob will be working on relnotes post wiki-freeze so they can enter the translation process. * Paul will be committing updated POT and PO for a variety of documentation today, using the new "xml2po -k" option. = = = = = ¹ http://fedoraproject.org/wiki/DocsProject/StyleGuide -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Project: http://fedoraproject.org/wiki/PaulWFrields irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug

1 0

FDSCo Meeting 2007-04-01 IRC log
by Paul W. Frields 01 Apr '07

01 Apr '07

12:00 < quaid> http://fedoraproject.org/wiki/DocsProject/SteeringCommittee/Meetings 12:01 < stickster> Bob of any kind here? couf_afk? 12:02 < quaid> BobJensen-Away, couf_afk, stickster 12:02 < Bob-Laptop> morning buoys 12:02 < quaid> looking a little light in folks today 12:02 < quaid> I forget ... 12:02 < quaid> oh, no, I remember ... if four people, we can vote 12:03 < stickster> Yup, otherwise we just summarize 12:03 < Bob-Laptop> sorry I missed last week unexpectedly 12:03 < quaid> we'll hang out a few minutes to see if glezos shows, since he was thinking of an agenda item apparently 12:03 < stickster> Yup 12:04 * stickster is making lunch for kids, but mostly paying attention 12:05 * mull lurks 12:06 < quaid> hey mull 12:06 < mull> hey 12:06 < quaid> anyone mind waiting until :15 to start? see if any wayward folks arrive? 12:06 < quaid> we may not have enough to talk about anyway ... 12:06 < quaid> well, this close to release, there is always something to think about. 12:11 * mull notices an outdated screenshot in the DUG 12:12 < mull> the login screen has changed entirely from what's there... 12:13 < stickster> mull: Use your wiki powers :-) 12:16 < quaid> or ... 12:16 < mull> hmmm, gotta think of the best way to get a screenshot of gdm login, though 12:16 < quaid> do we need the screenshot? 12:17 < mull> I'm not sure. what sort of feedback have to been getting about the "screenshots are generally bad" email? I haven't kept up 12:17 < stickster> mull: You can use Xnest to do it 12:18 < stickster> i.e. gdmthemetester 12:19 < mull> k, working out deps to install that 12:19 < mull> Xnest had file conflicts with another Xorg package... 12:20 < stickster> mull: FC6? 12:20 < mull> F7 12:20 * stickster goes PM with mull to keep channel clear 12:21 < stickster> quaid: Let's just go ahead and barrel through for now 12:22 < stickster> glezos put something on the agenda about l10n users' access to Makefile 12:22 < stickster> Can we do that, in addition to po/ stuff? 12:22 < stickster> I have no objection, means they can test translations right away 12:23 < quaid> oh, ic 12:23 < quaid> yeah, i suppose we can 12:23 < quaid> it's not the .common 12:23 < stickster> Right 12:23 < quaid> although I suppose we could include a Makefile.l10n instead and have just that r/w 12:24 < stickster> quaid: Oh, that is actually a very good idea! 12:24 < quaid> oh! 12:24 * quaid is pwoud of himself now 12:24 < stickster> Oops, didn't mean to sound so surprised :-D 12:24 * quaid retroactively declares 12:24 < quaid> <meeting> 12:24 < quaid> ha! 12:25 * stickster volunteers for log/summary duties 12:26 < quaid> ok, thanks 12:26 < quaid> so we solved the first thing :) 12:26 < quaid> what is the ? on the FDUG 12:27 < stickster> I don't know whether that's just a call for status, or what. 12:27 < stickster> jmbabich is stateside for a while and may not be able to do much with it for the next little while 12:27 < stickster> I see that a contributor has stepped in to work on it a little 12:27 < stickster> I would like to see more folks pitching in. 12:28 < quaid> yes 12:28 < quaid> but then we get that good ol' inconsistency of style and methods 12:29 < stickster> Right 12:29 < stickster> Are we concerned at all about the growing number of guides and the lack of follow-through? 12:30 < quaid> not yet 12:30 < quaid> there shall be some purging, soon enough 12:31 < stickster> okey-dokey 12:31 < quaid> here's what I think ... 12:31 < quaid> I think FDSCo needs to set and enforce some heavy-handed style guidelines 12:31 < quaid> we sort of have, but we are always concerned about offending writers 12:31 < stickster> *nod 12:31 < quaid> but you never see Ulrich (bad example!) being nice about someone's coding style 12:32 < stickster> That's an excellent point 12:32 * stickster rubs hands gleefully 12:32 < stickster> And we do have an excellent Style guide on the wiki, thanks to Patrick 12:34 < quaid> I'm happy to tell people what I think they should do, but it would help if we were all consistent together on this 12:35 * BobJensen-Away looks to EvilBob... 12:35 < BobJensen-Away> hehehe 12:36 < stickster> quaid: If it's not documented in our Style docs on the wiki, very easy to add sections 12:36 < stickster> Then we all have a common cry 12:37 < quaid> I'm happy with that style guide, now that I clarified on the active/passive voice stuff :) 12:37 * stickster forgets the clarification 12:37 < stickster> I do see a lot of passive voice still in the Style Guide though :-D 12:37 < quaid> I know 12:38 < stickster> Is that OK by you? 12:38 < quaid> not necc 12:38 < quaid> just lazy about fixing it 12:38 < quaid> suppose I can do that 12:43 < stickster> So I was about to say, the situations where passive voice works better do exist, but they're rare 12:43 < stickster> We rarely put out "guidelines" or "recommendations" in our technical docs. Usually it's procedural, and we're indicating exactly what to do. 12:44 < stickster> Even in a "guideline" situation, you can label active voice with "Use the following guidelines" for an itemized list, and still use active voice 12:46 < stickster> Ha! 12:46 < stickster> http://fedoraproject.org/wiki/DocsProject/StyleGuide/GeneralGuidelines 12:46 < stickster> Look at the first admonition 12:46 < stickster> "Passive voice should be avoided unless necessary" :-D 12:47 * stickster decides to give it a pass-through 12:47 < quaid> heh 12:47 < quaid> ah, irony 12:47 < quaid> go ahead 12:47 * stickster wields the machete 12:47 * quaid is on CommonMistakes atm 12:48 < stickster> Do we have any other agenda item updates? 12:48 < stickster> Let me jump in with a status on CVS -- we are now using "xml2po -k". I will be rebuilding and committing POT/PO today, so there will be commits coming through. 12:49 < stickster> *end of stickster biznez 12:50 * stickster gets rid of "commanding voice" (whatever that means), which necessitates use of "you" 12:51 < quaid> that's fine 12:52 < quaid> I need to look at GSoC eventually 12:52 < stickster> No one here for the other items, let's close the meeting and jam 12:53 < quaid> ok, I see Patrick accepted my mentor request 12:53 < stickster> cool 12:53 < quaid> so now I have a queue 12:53 < quaid> I need to grow some more mentors 12:53 < quaid> I'll ask on the list :) 12:55 < stickster> Everybody knows Wiki freeze is coming up tomorrow, yes? 12:57 < stickster> 2359 IIRC 12:59 * quaid scared! 12:59 < stickster> yeah, looks a little sparse this time 12:59 < quaid> fuckers 12:59 * stickster predicts a mad rush post test4 12:59 < stickster> H 12:59 < quaid> its because rahul is leaving us out to dry :D 12:59 < stickster> No slam against mether, he carries a lot of buckets 12:59 < quaid> stickster: will you ... 12:59 < quaid> send an email to ... 13:00 * stickster prepares blog entry 13:00 < quaid> f-devel-l? 13:00 < stickster> Sure 13:00 < quaid> ok, that too 13:00 < stickster> both, +1 13:00 < quaid> BobJensen: are you on f-maintainers? 13:00 < Bob-Laptop> Please 13:00 < quaid> Bob-Laptop: can you email f-maintainers? 13:00 < Bob-Laptop> I have not been able to sent email out for 11 or 12 days 13:00 < stickster> yikes 13:00 < quaid> we need to let the former Extras group know that this is their relnotes, too 13:00 < quaid> Bob-Laptop: woah 13:01 * quaid takes f-maintainers 13:01 < Bob-Laptop> I am working on upgrading the mail server to CentOS 4.92 today it was FC2, something is busted 13:02 < stickster> Bob-Laptop: Scan bugzilla for things with requires-fedora-release-note flag on 13:02 < stickster> Make sure we have that stuff covered too 13:02 < stickster> I think that was the flag name... 13:02 < Bob-Laptop> stickster: Yup 13:02 * stickster has got to get to the IG today if possible 13:03 < Bob-Laptop> once I get this mail working I will be in BZ and wiki until we freeze 13:03 < stickster> k 13:03 < Bob-Laptop> I took tomorrow off because I know the notes need work 13:04 < quaid> ok, Bob-Laptop has BZ 13:04 < quaid> there may not be much, i haven't looked recently though 13:04 < stickster> I've been keeping an eye on stuff coming on the relnotes mail feed, I don't think there's a walloping lot 13:06 * quaid sends f-maintainers email and uses "stupidly easy" in it 13:06 < stickster> heh, way to tweak 'em 13:06 * stickster will take care of f-devel-l 13:07 < stickster> I'm copying your email. 13:08 < Bob-Laptop> I had pinged Rex to get some KDE info in to the beats, not sure if anything happened there 13:08 < stickster> Bam! 13:08 * stickster kicks it up a notch 13:09 < stickster> Are we EOM now? 13:09 < quaid> yes 13:09 < quaid> </meeting> -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Project: http://fedoraproject.org/wiki/PaulWFrields irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug

1 0

Getting started: DUG
by Jonathan Roberts 01 Apr '07

01 Apr '07

Hi, I've been looking over all the information and feel I'm ready to get started. The only trouble is that I'm reluctant to in case I over step the mark and make changes that I think are necessary/useful but others might not agree with and I'd hate to create further work for people in undoing my changes! For now there are some paragraphs on the DUG that definitely need a few changes just to read properly and I guess I'll make those as they're only going to be minor and it will be a start :D Guess I'll just take things gradually and ask that somebody tell me if I do something horrible and I'll fix it! Yours, Jon

3 2

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs April 2007