00:00:04 #startmeeting 00:00:21 #meetingtopic Docs Meeting 25 Jun 2009 00:00:35 #topic Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings 00:00:41 Roll Call 00:00:44 * Sparks is here 00:00:47 * ke4qqq is here 00:01:16 is here (still learning chat code) 00:01:32 welcome Lee! 00:01:58 Welcome all... Hopefully we'll have a good attendance tonight. 00:02:00 * ianweller is kinda maybe sorta here but not really 00:02:08 * rudi is here 00:02:15 isn't someone paying you to attend ianweller ??? :) 00:02:16 * Sparks ties ianweller to a chair 00:02:26 ke4qqq: my internet is being fuxxored 00:02:33 i want to burn my ISP 00:02:34 but 00:02:35 yeah 00:02:37 ahhhh ok 00:02:48 so no warning on whether i'm here or not :P 00:02:56 is that excuse the new 'my dog ate my homework' ? 00:03:00 * Sparks hopes that quaid will be here so he can talk about the licensing 00:03:08 ke4qqq: ok you ping salina0.ianweller.org and see when it stops responding. :P 00:03:21 ianweller: Can we all do that? 00:03:37 home grown DDOS 00:03:40 :) 00:03:50 bluh 00:03:56 Woohoo!!! My name is registered now...not really sure what that means, but.... 00:05:18 * Sparks gives everyone one more minute 00:05:35 hmm it seems like my internet is fairly stable now 00:05:36 whee 00:05:42 ianweller: have you done an unofficial review on ucluglee's package? 00:05:47 no 00:05:53 i should probably do that. 00:06:09 * Sparks makes a note to doc ianweller's pay for this week 00:06:12 do I nned to add it to the todo? 00:06:17 Wait.......that didn't sound right. 00:06:18 ke4qqq: that would be extremely helpful 00:06:19 DO IT! 00:06:48 Okay... if everyone will take their seats... we'll get started 00:06:50 quaid: You here? 00:06:58 * radsy is here 00:07:20 * Sparks skips the CC licensing topic 00:07:32 is anyone here about the shared open-source style guide? 00:07:43 can someone recap that for me? 00:07:50 i'm kinda lost about it 00:07:57 ianweller: as soon as someone fills me in... sure 00:08:02 hah 00:08:03 mmmmk 00:08:06 I like the idea - but man someone needs to stand up and lead it - and come up with lots of volunteers 00:08:24 ke4qqq: Would you like to speak about it? 00:08:38 not really 00:08:39 Sparks: which one? (I'm here representing GNOME, at a docs conference 2 weeks ago we started working on a shared open source style guide) 00:08:45 #topic Shared open-source style guide 00:08:46 we have our own internal style guide here 00:08:55 Okay... let's jump into it, then. 00:09:07 radsy: does it reference cms or ap? 00:09:16 ap? 00:09:20 pcutler: What can you tell us about the style guide project. 00:09:22 ? 00:09:40 ke4qqq - neither 00:09:53 at a docs conference 2 weeks ago, we had various free software projects, including GNOME, XFCE, Ubuntu, Drupal and BSD together. 00:10:09 during our hackfest on Sunday, one group started working on the style guide, which is a wip found here: http://writingopensource.com/node/14 00:10:39 this is in it's infancy, so it's still really rough, and nowhere near complete 00:10:48 radsy - Associates Press - and Chicago Manual of Style 00:10:54 * Sparks wonders why I wasn't invited... :( 00:10:57 i didn't spend a lot of time on it as I was doing GNOME hackfest stuff 00:11:06 pcutler: So what do you want/need from us? 00:11:16 radsy: any chance CES's is OPL-licensed? 00:11:39 Sparks: don't know yet, right now our goal is to get GNOME better integrated downstream and open communication to stuff like this 00:11:40 pcutler: discussing the open source style guide? 00:11:47 shaunm: yes 00:12:16 as far as they style guide, I was there, but wasn't active on that project 00:12:22 shaunm: If you have something to add please do. 00:12:26 ke4qqq, i'm not sure how it's licensed, but i can probably find out for you 00:12:39 leave it with me 00:12:40 one topic discussed was how to create our own version of the Chicago Manual of Style long term 00:12:42 that'd be awesome 00:12:43 ke4qqq -- not at the moment, in fact, it's "Confidential" 00:12:51 or that ^ 00:13:02 "our" as in all open source projects 00:13:15 I guess I'm just confused about what is needed from Fedora. I'm sure we'd be happy to participate and provide all our documentation as needed. 00:13:28 I saw some confusion in some places, so I'd just like to point out that the idea is not to get rid of project-specific style guides 00:14:03 they want us to participate in creation - plus fedora has an existing style guide - though it references chicago so it's incomplete in their scope. 00:14:35 * quaid slides in the back of the room 00:14:36 right, so any sufficiently large documentation project has its own style guide. same happens in the commercial sector 00:15:02 but project style guides deal with very specific things for that project, and happily leave the general stuff to a general style guide, like CMS or AP 00:15:06 okay. It would probably be a good time to get some folks working on updating our backend documents (like the style-guide and development documentation) 00:15:26 the idea is to make a free style guide that can be that general base for all of us 00:16:43 certainly in the area of "is it x86, X86, etc." 00:16:51 we do our readers a service in normalizing 00:16:53 Okay. Is there anyone that would like to raise their hand and volunteer to work as a liaison and help wrangle this from our end? 00:17:15 I don't mind acting as a liaison there 00:17:30 and note that I don't know how we're going about this. I'm not the one leading the effort 00:17:38 but I'd really like to see if we could get CES to release theirs under a free license. 00:17:47 ke4qqq: Thanks. I'll put you on it, then. I'd also like to be involved. Just keep me in the loop of what's happening, please. 00:17:53 np 00:18:16 ke4qqq -- I'll be happy to follow that up. I don't imagine that it would be a big deal. 00:18:17 ke4qqq: sorry, I'm not familiar with CES. link? 00:18:27 ke4qqq: +1 to an RHT addition 00:18:35 shaunm, actually, ECS -- Red Hat Engineering Content Services 00:18:37 shaunm: Content Engineering Services - it's the docs team at RH 00:18:46 ah, thanks 00:19:01 wow - sorry for transposing the name 00:19:24 ke4qqq - np. It's not in front of your face every day, like it is for some of us ;) 00:20:26 Okay, so ke4qqq is going to run with that ball. Does anyone else have anything on this topic? 00:21:24 shaunm: pcutler: Thanks for helping us understand what's happening here. 00:21:51 * Sparks moves back to the first topic since he saw quaid slip into the back of the room. 00:21:54 Im curious what style guides we have already. the link posted a minute ago. doesn't contain much 00:22:40 scramer: I think that is something we are going to have to figure out. 00:23:15 #topic Status on CC license discussion 00:23:25 quaid: Do you have an update on the license discussion? 00:23:37 short is, I've been on vacation since the last meeting, basically 00:23:44 so I haven't moved the needl 00:24:02 but bonus, I just started up gnote from scratch 00:24:07 and added this as the first to-do item 00:24:15 I'll bounce traffic back to the list asap. 00:24:18 00:24:31 :) 00:24:40 cool... Does anyone have any questions? 00:24:51 and dependencies I need to know about? 00:26:18 quaid: Thanks for the update... 00:26:55 moving on 00:26:57 esp. dependencies :) 00:27:02 so moved 00:27:05 :) 00:27:24 #topic Bugzilla Component Changes - https://fedoraproject.org/wiki/User:Sparks/BZ_and_Guide_Table 00:28:10 So no one has really commented on this. So if no one has anything to say about it tonight I'm going to start the process of converting or changing or leaving alone. 00:28:37 * quaid takes a quick final peek 00:28:54 Sparks: did you talk to translators about abandoning the translation docs? 00:29:02 i don't want other subprojects getting angry 00:29:12 ianweller: yes. I've gotten multiple confirmation on blowing those files away 00:29:18 errr... abandoning them 00:29:26 * Sparks never throws anything away 00:29:33 it's in Trac now iirc 00:29:43 um, two questions 00:29:59 docs-common has tools in it that are potentially useful, may never be packaged, and are in trac now 00:30:20 do we not need a bug component because it's not a packaged thing? 00:30:22 and many of them still needed for things like RN 00:30:52 * quaid is going to go over his alotted two questions, but tries ... 00:30:57 and older versions of documents such as the IG for F10 00:31:13 and example-tutorial, is that supplated by create_book? 00:31:30 i.e., if we want a Fedora-specific example, we should put it in publican-fedora, right? 00:31:52 * quaid notes there may have been some gold in xml-normalize, but it's probably supplanted by pulican, too 00:32:06 * quaid has latency, argh 00:32:07 00:32:21 quaid: We can put anything in bz that needs to be there. I plan on being very flexible with "our" product in bz. 00:32:56 so, if we are doing team wide planning/task management with bz, we probably need to keep docs-common under it's new name 00:33:10 quaid: And I think many things are going to get "lost" because we will be using publican. 00:33:29 quaid: +1 to using BZ for... everything 00:33:42 bzborg 00:34:24 ke4qqq: I'm not sure if I understand your statement 00:34:41 docs-common tools are still needed 00:34:54 for RN and F10 guides, i.e. "PP" (pre-publican) 00:34:54 perhaps I misunderstand then 00:35:18 and even the 'other dogs' that are included with RN post-publican 00:35:25 s/dogs/docs/ 00:35:38 *woof* 00:36:18 IMO, we need BZ components for all active items not in the wiki... does that make sense? 00:37:03 If we decide to sunset a project or move it to the wiki we should get rid of the component in BZ to prevent confusion. 00:37:04 eg - we can't EOL docs-common til all of the docs that need docs-common 00:37:17 yes... that makes sense 00:37:37 are EOLed - which means at least another 12 months 00:37:40 but we can rename it 00:37:51 yep 00:38:45 okay. 48 more hours and then I'm taking an ax to things... :) 00:39:10 make notes/updates on the page and let's take further discussion to the list. 00:39:13 is that okay? 00:39:27 worksforme 00:39:34 k 00:40:01 This topic really started as a BZ clean up but turned out to be a clean up of Docs! 00:40:17 Anyone have anything else before we move on? 00:40:54 #topic CMS Update <-- ke4qqq 00:41:05 ke4qqq: Zikula... talk to us! 00:41:59 so lots of modules packaged 00:42:11 a few hiccups (licensing) 00:42:25 poelcat has volunteered to take the pm role 00:42:34 but we haven't yet had an initial meeting 00:42:36 ? 00:42:45 I saw that traffic from John 00:42:51 and is that just for the docs.fp.o site? 00:42:52 upstream has been very responsive to our concerns 00:42:57 Zikula++ 00:43:27 quaid: I think this is for getting the initial instance of Zikula up... which will be docs.fp.o. 00:43:29 quaid: no this is for other fp.o uses as well I suppose 00:43:40 both! neither! 00:43:42 so many groups have an interest 00:43:47 yes 00:43:54 Well... 00:43:57 and so many parties are needed 00:44:21 infra and art are needed initially to make sure everything is... perfect (like it would be any other way) 00:44:22 it would help if we made it clear that this is a step in a process that still includes hope. 00:44:36 after that it should be an easy process to get other instances up and functioning 00:44:55 for the other teams involved; unless Infra/Websites wants to move in parallel, too 00:44:59 and I am doing a poor job of getting it all done quite honestly, though Sparks has been packaging and stuff like a madman 00:45:28 ke4qqq: give me keys and I'll drive us to California 00:45:37 :) 00:45:52 this is a nice point for poelcat to step in; it's like a Fedora-ratchet, moving things along from doer to doer :) 00:46:06 yes 00:46:19 I think we'll be meeting the beginning of next week (I speculate) 00:47:21 Anyone have anything else? 00:47:56 #topic [[DocsProject]] wiki pages changes 00:48:00 ianweller: you still around? 00:48:13 ianweller: What's the status of getting wikibot out of the garage? 00:48:23 * ke4qqq needs to duck out of the meeting - sorry can't stay longer. 00:48:27 are you through your agenda items? 00:48:36 ke4qqq: thanks for coming 00:48:56 shaunm: about half way through the items... but the last half goes faster 00:49:19 * Sparks thinks ianweller is MIA. 00:49:22 I have something I'd like to discuss with the fedora docs team, but I don't want to interrupt your agenda 00:49:48 shaunm: Can you stick around for another ten min? 00:49:59 sure, no problem 00:50:04 shaunm: cool 00:50:11 #topic Status on Installation Guide 00:50:17 rudi: Any updates on the IG? 00:50:58 Not much -- I'm working my way through the bug list and on some new material that engineers want incorporated 00:51:17 Still hope to have a revised edition ready in the next week or so 00:51:25 (but I think I said that last week) 00:52:15 :) 00:52:24 rudi: Cool. If you need anything just let me know. 00:52:31 Ta. 00:52:42 Anyone have anything for the IG? 00:53:20 #topic Status on Security Guide 00:53:37 Well... I submitted a new package for review. I think he likes it. 00:54:01 Have a couple of open tickets on transitioning some information from the wiki over to the guide. 00:54:28 And I'd like to make mention of radsy's SELinux guides in the document, somewhere. 00:54:37 radsy: do you have anything to add? 00:54:48 on the security guide? 00:54:51 no 00:54:58 Anyone have anything? 00:55:04 it's not in my field of view right now 00:55:19 #topic Status on SELinux Guides 00:55:25 radsy: I'm guessing these are, though 00:56:16 i'm trying to beat publican into submission with the user-guide translations, and i'm working on mysql/squid for the services-guide. 00:56:35 * Sparks offers his baseball bat 00:57:06 radsy: If I can help with the translations (or anything) please let me knwo. 00:57:38 I know that jjmcd has good experience with the translations, too (more than me) so he might be a good resource 00:57:43 as soon as he returns from Germany 00:58:05 Anyone have anything? 00:58:22 #topic Status on User Guide <-- danielsmw & rudi 00:58:30 rudi: Any changes to the UG? 00:58:40 Nothing on the radar for this one. 00:58:50 Anyone have anything? 00:59:00 hmm 00:59:06 is that one being lead? 00:59:27 quaid: which one? The UG? danielsmw and rudi are assigned to it 00:59:41 ok 00:59:56 * Sparks notes he hasn't seen danielsmw around lately 01:00:02 sorry, was out of touch and missed that folks actually volunteered, bless 'em 01:00:09 I thought danielsmw took an LOA? 01:00:14 did he? 01:00:23 or am I discombobulating him with jmtaylor? 01:00:27 * Sparks will consult his notes after the meeting 01:00:28 sorry Matthew if I am 01:00:36 Okay, anythign else on the UG? 01:00:51 #topic New Guides 01:01:04 Anyone working on or wanting to work on a new guide? 01:01:32 I plan to work on an Installation Quick Start Guide for F11 01:01:37 F12 rather 01:01:42 cool 01:01:49 cool 01:01:53 step one: put in DVD 01:01:59 step two: press enter 01:02:03 step three: walk away 01:02:12 step four: return and enjoy Fedora goodness 01:02:15 :) 01:02:22 Yeah; something very much like that :) 01:02:34 there may be a few steps missing in there but... :) 01:03:03 rudi: Do you need anyone to help you with this guide? 01:03:27 Sparks -- I'll know more once I have the chance to do some planning with it 01:03:44 I hope that I'll be able to reuse/condense content from some existing docs 01:03:51 rudi: Okay. Just let me know. 01:03:54 Anyone else? 01:04:27 #topic All other busines 01:04:37 Okay... Who has something they'd like to talk about? 01:04:51 * shaunm raises his hand 01:05:00 yes shaunm! :) 01:05:04 yay! 01:05:26 so there is a small group of people who are discussing coming together for a desktop help summit 01:05:40 we have interested parties from gnome, kde, xfce, and ubuntu 01:06:10 it's not a conference. it's a gathering of movers and shakers to bang out some common ground 01:06:27 docs ground? 01:06:29 I would very much like it if somebody from the fedora team could make it 01:06:36 strictly docs, yes 01:06:56 shaunm: I'm sure we can fill a slot. 01:07:21 largely focused on desktop help. but if people find something interested to talk about for other types of documentation, I'm not going to shut them up 01:07:31 *interesting 01:07:32 shaunm -- When and where? 01:07:37 I will caveat that being a starfish-type organization, it's hard to get one person who can speak for direction in terms of common ground ... depending. 01:08:01 quaid: yes... but one person can at least be the liaison. 01:08:15 my experience is we all get together in person and have great ideas, but moving those through the projects is different. 01:08:20 quaid: perfectly understood. but somebody who's involved with the fedora team can bring perspective that the rest of us don't have 01:08:33 nod 01:08:40 I'm curious what thought there is toward virtual and widely inclusive v. physical and therefore exclusive? 01:09:21 so I've offered to organize and host the event, and if I organize it, it will be in Champaign, IL, US 01:09:35 and people seem to be perfectly happy to let me do that 01:09:47 we're tentatively talking about august 21-23 01:09:54 (I realize it's rather short notice) 01:10:50 shaunm: Can you send me a message to sparks@fedoraproject.org with the details, please? 01:10:58 yessir 01:11:31 I'll forward the information to the list so we can figure it out on our end. 01:11:40 great 01:12:21 Anyone have anything else? 01:13:35 5 01:13:38 4 01:13:39 thank you 01:13:42 3 01:13:45 scramer: no problem 01:13:48 2 01:13:50 1 01:13:57 Thanks everyone for coming! 01:14:00 #endmeeting