14:00:37 <bcotton> #startmeeting Docs Project Meeting - Agenda: http://fedoraproject.org/wiki/Docs_Project_meetings 14:00:37 <zodbot> Meeting started Mon Dec 12 14:00:37 2011 UTC. The chair is bcotton. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:00:37 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic. 14:00:43 <bcotton> #meetingname Fedora Docs 14:00:43 <zodbot> The meeting name has been set to 'fedora_docs' 14:00:49 <bcotton> #topic Roll Call 14:01:37 * jjmcd 14:01:44 <pkovar> I'm here 14:02:56 <jjmcd> Was there beeping on docs? I didn't hear any 14:03:36 <bcotton> jjmcd: no i should do that 14:03:41 <suehle> beep 14:04:28 * jjmcd just happened to look up at the clock at the right time 14:05:39 <bcotton> okay, now that my tea is done, i think we can get going on the agenda 14:05:53 <bcotton> #topic Follow up on last week's action items 14:06:20 <bcotton> Let's see. I took care of mine, which we'll talk about more in a few minutes 14:06:28 <bcotton> fnadge: are you around? 14:06:39 <fnadge> yup 14:06:55 <bcotton> how's the Style Guide coming along? 14:07:27 <fnadge> cgot the repo. Am now creating a book. 14:08:06 <bcotton> fnadge: excellent. Do you need any help, or are you going to get somethign in place before tossing it to the wolves? 14:09:06 <fnadge> No, I guess I am okay 14:09:10 <fnadge> Thanks 14:09:43 <bcotton> awesome. since it's now officially a work in progress, we'll just leave it for the Guide Status section instead of carrying forward the action item 14:10:00 * jhradilek sneaks in. 14:11:07 <bcotton> HEY EVERYONE LOOK AT JHRADILEK 14:11:20 <bcotton> #topic FUDcon Blacksburg 14:11:39 <jhradilek> :-D 14:11:43 <bcotton> #info every time you say FUDcon, a Southern_Gentlem gets his wings 14:11:50 <bcotton> #link http://fedoraproject.org/wiki/FUDCon:Blacksburg_2012 14:11:57 <bcotton> #info Docs is sponsoring two classes at FUDCon Blacksburg: Introduction to Docs and DocBookXML/Publican 14:12:24 <bcotton> jjmcd: are the classes coming along? i'm guessing sparks hasn't been able to contribute much lately 14:12:32 <jjmcd> actually 14:12:41 <jjmcd> my clone for my part is jsmith 14:12:48 <jjmcd> I have the prez I did at Milan 14:12:53 <bcotton> ah, well then there's no excuse :-) 14:12:55 <jjmcd> plan to fatten it up a bit 14:13:26 <jjmcd> Dunno if jsmith will be as good as jhradilek for a co-presenter, tho 14:14:16 <jhradilek> jjmcd: I am pretty sure nobody can be as nervous as me. :-) 14:14:24 <jjmcd> didn't show! 14:14:36 <jjmcd> I suspect Sparks has a tougher job 14:14:46 <jjmcd> His topic is a little more amorphous 14:16:34 <bcotton> okay, i'll check with him and see if he needs some help 14:17:14 <bcotton> #action bcotton to check in on sparks regarding his presentation for FUDcon Blacksburg 14:17:33 <bcotton> anything else on fudcon? 14:18:57 <bcotton> okay, we'll skip QA until next meeting and go straight to 14:18:58 <bcotton> Guide Status 14:19:01 <bcotton> #topic Guide Status 14:19:33 <jjmcd> ARG branched and published this past week 14:19:50 <bcotton> jjmcd: i saw that, great job! 14:21:34 <bcotton> anything else on guides? 14:22:54 <bcotton> #topic Bug Squashing Party 14:23:16 <bcotton> #info Bug Squashing Party Scheduled for December 15 at 2PM EST (1900 UTC) 14:23:33 <bcotton> i'll send a note to the list reminding everyone 14:23:47 <bcotton> #action bcotton to email docs list with a reminder about the party 14:24:15 <bcotton> bug squashers will need at least bugzilla access and preferably docs-writers, am i missing anything 14:26:38 <bcotton> #topic Open Floor discussion 14:26:45 <bcotton> i have something for this 14:26:59 <bcotton> i think 14:27:04 <bcotton> let me go back and look at my email first 14:28:10 <bcotton> yes okay 14:28:30 <bcotton> so on the ml, someone posted that they had started a quick install guide on the wiki 14:28:33 <bcotton> #link https://fedoraproject.org/wiki/Fedora_Quick_Install_Guide 14:28:53 <bcotton> have we deprecated the Installation Quick Start Guide or are we competing with ourselves? 14:29:21 * LoKoMurdoK here late sorry 14:29:49 <jjmcd> I wonder whether the author was aware of the I!SG 14:29:55 <jjmcd> IQSG 14:30:19 <bcotton> i'm not sure, but i wanted to make sure i hadn't forgotten about axing it before I brought that up :-) 14:30:23 <pkovar> is IQSG still maintained? 14:30:43 <bcotton> pkovar: it wasn't done for f16 14:30:53 <bcotton> or 15 apparently 14:31:01 <pkovar> so it's unmaintained :-) 14:31:06 <bcotton> yeah :-) 14:31:33 <bcotton> so i guess the question is: which is the better way forward for this content? 14:31:59 * jhradilek wanted to ask Rudi about the IQSG a while ago, but forgot to do so. 14:32:17 <jhradilek> I would be willing to maintain it. 14:32:23 <bcotton> given that we've seemed a little slow with guides that past release or two, i'm okay with letting the IQSG be a wiki page that could get more love 14:32:51 <bcotton> otoh, jhradilek has volunteered :-) 14:33:26 <jjmcd> I suspect first step is to see if info missing from IQSG is in wiki 14:34:09 <pkovar> fwiw, i'd talk to that wiki page author first 14:34:21 <pkovar> so the efforts are not duplicated 14:34:28 <jjmcd> Sounds like a good approach to me 14:35:15 <bcotton> okay, i'll compare the wiki and iqsg and talk to the wiki page author. then we'll go to the list to come up with a solution 14:35:22 <jhradilek> jjmcd: I can ask rudi/jreed tonight what are their intentions with the IQSG and then contact the guy who is working on the wiki and offer him my help. 14:35:34 <bcotton> #action bcotton to follow up on IQSG/wiki page 14:35:47 <jjmcd> jhradilek, Sounds like a good deal to me 14:36:19 <bcotton> #action jhradilek to contact rudi/jreed about the IQSG 14:36:22 <pkovar> excellent 14:36:36 <jhradilek> bcotton: Aye aye, captain! 14:37:05 <bcotton> oh man, jhradilek is feeding my ego. this is aobut to get out of hand 14:37:15 <bcotton> any other topics for open floor discussion? 14:37:21 <jjmcd> yes 2 14:37:28 <bcotton> go ahead, jjmcd 14:37:40 <jjmcd> 1) Both the IG and the SAG have Grub content inappropriate for F16 14:38:05 <jjmcd> 2) Someone on the wiki also suggested some docs on iptables. Does that need to be in the SA guide? 14:38:11 <jhradilek> jjmcd: I am aware of the error in the SAG; just did not have the time to fix it. 14:38:20 <jjmcd> Ahhh cool 14:38:26 <jjmcd> Grub2 seems a huge change 14:38:28 <bcotton> jjmcd: are there bugs for 1? 14:38:37 <jjmcd> bcotton, no 14:38:39 <jhradilek> There is even a bug somewhere if anyone needs a Bugzilla number. :) 14:38:52 <jjmcd> I'm not sure I understand Grub2 well enough to compose a bug 14:38:59 <jjmcd> ahhh, ok 14:39:12 <jhradilek> You can clone mine, if you want. Wait a sec. 14:40:04 <jhradilek> https://bugzilla.redhat.com/show_bug.cgi?id=752059 14:40:04 <bcotton> jjmcd: it might be worthwhile to open a bug for the IG just so we know it's there and find someone who can give us enough information to fix it 14:40:18 <jjmcd> bcotton, not a bad plan 14:40:45 <jjmcd> And it turns out there are some Grub2 utilities that prevent you needing to know as much as the old grub 14:40:56 <bcotton> well that's helpful 14:41:08 <jjmcd> But you need to know they're there 14:41:18 <bcotton> if we can't figure it out internally, then we can hunt down the package maintainer :-) 14:41:42 <jjmcd> The package database is a wonderful thing 14:41:57 <bcotton> as for your #2, if there's nothing in the SA guide about iptables, I think absorbing the recent work on the wiki would be a good idea 14:42:17 <jjmcd> It was a new contributor so perhaps with some mentoring ... 14:43:00 <bcotton> jjmcd: i like the way you think 14:43:22 <bcotton> jhradilek: you're the maintainer for the SA Guide, right? 14:43:26 <jjmcd> This week *MIGHT* turn out so I have the cycles 14:43:31 <jhradilek> bcotton: Yup. 14:44:42 <bcotton> do you and jjmcd want to work with the person who wrote the wiki page on iptables recently and work to get that incorporated into the SA Guide and provide some mentoring, etc 14:45:02 <jjmcd> Yeah, let me see what I can do 14:45:13 <jhradilek> bcotton: Sure. Can you please give me the link to that wiki page? I need to read it. :) 14:45:23 <jjmcd> Prob is, this week is either full or empty, I don't yet know which 14:45:34 <bcotton> jjmcd: i love those kinds of weeks 14:45:54 <bcotton> jhradilek: https://fedoraproject.org/wiki/User_talk:Rforlot 14:46:13 <jhradilek> bcotton: Cheers! 14:46:29 <bcotton> it's a little rough, and not quite named appropriately, but it's a good start and obviously an eager contributor 14:46:30 * jjmcd has one, maybe 2 trips to Farmington Hills, 120 miles away, and maybe a trip to Lansing, 100 miles, so I may spend the week driving 14:47:05 <jjmcd> (that's 190/160 km) 14:47:22 <bcotton> that sounds unpleasant 14:47:37 <bcotton> anything else for this meeting? 14:47:42 <jjmcd> Well, not THAT unpleasant ... got a Bose in the Porsche 14:47:47 <bcotton> heh 14:48:03 <jhradilek> bcotton: It's a good start, although it would require a whole lot of editing in order to fit to the SAG. :-) 14:48:48 <bcotton> what better way for him to learn his way around the docs process? :-) 14:49:03 <jjmcd> bcotton, exactly 14:49:12 <bcotton> last call for open floor discussion 14:49:33 <jhradilek> bcotton: Also, I know that Security Guide deals with iptables, although I am not sure if it is being released for Fedora as well. 14:50:03 <jjmcd> Oh yeah, good point 14:50:43 <bcotton> jhradilek: it is, but it'd probably be good to have at least some iptables discussion in the SAG, even if it's not as in-depth as in the sec guide 14:51:12 <jhradilek> bcotton: I agree. 14:51:34 <jjmcd> Things like iptables almost need a quick start AND complete guide like install 14:53:04 <jjmcd> jhradilek, perhaps some simple stuff in the SAG and a pointer to the SG 14:53:24 <jjmcd> or verse visa 14:54:29 <bcotton> okay, well it sounds like we've had a productive meeting. 14:54:33 <bcotton> not sure how that happened 14:54:39 <jhradilek> jjmcd: I vote for the basic stuff; a brief introduction to what iptables are and what is their purpose, how to list the current rules, how to set them on the command line, etc. 14:55:07 <jhradilek> Also, we should mention that there is system-config-firewall. :) 14:55:25 <bcotton> let's move the iptables discussion to the list or #fedora-docs so we can wrap this up :-) 14:55:32 <jjmcd> The SG badly needs some pictures 14:56:05 <bcotton> thanks everyone, i hope to see you all at the party on thursday 14:56:08 <bcotton> #endmeeting