13:59:29 #startmeeting Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings 13:59:29 Meeting started Mon Aug 26 13:59:29 2013 UTC. The chair is randomuser`. Information about MeetBot at http://wiki.debian.org/MeetBot. 13:59:29 Useful Commands: #action #agreed #halp #info #idea #link #topic. 13:59:29 #meetingname Fedora Docs 13:59:29 The meeting name has been set to 'fedora_docs' 13:59:29 #topic Roll Call 13:59:39 * Capesteve is here 13:59:53 * jhradilek is here. 14:00:08 * croberts here 14:00:11 * jsmith is lurking 14:00:21 * zoglesby is here 14:00:25 * randomuser` wonders if any new members will appear today 14:00:39 * pkovar 14:01:59 morning, swflint 14:02:16 * jreznik is around, ping me if you will need me 14:02:46 * jamielinux is here, thinking about joining docs team. Not gone through steps yet, but since I'm here, thought I'd say hello 14:02:52 good morning to you too randomuser` 14:03:56 welcome, jamielinux , feel free to throw out any questions 14:04:05 randomuser`: Thanks :) 14:05:36 #topic Follow up on last week's action items (10 minutes ) 14:05:48 So, last week we had action items for Badges 14:06:17 Is it safe to say we know where to file tickets for badges, and we don't have to meet about it ? 14:07:40 okay, glad we agree 14:07:58 #topic Release Notes / Changes 14:08:21 A brief overview might be good for our new people 14:08:58 We divide the work of creating the release notes into beats and track it at https://fedoraproject.org/wiki/Category:Documentation_beats?rd=Docs/Beats 14:09:20 Writers can volunteer to *own* a beat or contribute ad hoc 14:10:07 We also have a Changes process, wherein we will try to assign a writer to each of the major Changes for inclusion in the RNs and to assess impact on other guides 14:10:33 #info Writers can create bugs for themselves to cover our part of the changes process at any time 14:11:11 so, this part of the meeting is usually just to remind people about the process 14:11:39 Has anyone taken a beat yet? anything I left out in the overview that would be helpful for new writers? 14:12:59 I would but i am still working on my guide and dont want to take too much on 14:13:25 that's fair 14:14:19 #action randomuser to announce open beats 14:14:39 #action randomuser to start creating tracking bugs for Changes 14:14:56 #topic Guide Status 14:15:04 any Guide news? 14:15:35 I could consider taking the QA for the Amatuer Radio Guide 14:16:17 swflint, that'd be great! Anything we can do to help? 14:16:37 I will push new updates to mine today, My laptop crashed so I will be using my desktop for a while. Otherwise I would have pushed to git sooner 14:16:54 swflint, i think jjmcd and Sparks are well invested in that, and they are often in #fedora-docs 14:17:29 Yes, I know 14:17:48 I am hard at work on the ARM Guide 14:18:44 did you find/need any technical contacts for that, zoglesby ? 14:19:15 randomuser`: indeed 14:19:29 randomuser`: I am not sure if this is the right time and place to announce it, but I will have to step down as the maintainer of the System Administrator's Guide. 14:19:32 zoglesby, sorry, you have to pick one 14:20:07 randomuser`: I am working with the #fedora-arm group and jsmith says he will help 14:20:15 but we will see about that last part :P 14:20:46 randomuser`: for tracking bugs, please update it in the Change page (once created + owner, or update the Change page to fit your need ;-) 14:20:58 zoglesby, cool. I bought a little gadget to play around with, but if I'm being realistic, i'll probably spend my writing time on something else and leave android on it 14:21:03 jreznik, ACK 14:21:26 jhradilek, aww.... is that a side effect of your promotion? 14:21:31 congrats, btw 14:21:39 randomuser`: Thanks. :) 14:22:47 Is Capesteve stepping in? That's a big office cot to fill 14:22:51 Unfortunately yes. :( I will still be contributing to it, but I think it deserves someone who can take better care of it. 14:22:59 I hope he is. :) 14:23:05 :) 14:23:24 I'll need a lot of help 14:23:30 jhradilek, well, it's a relief to hear you will still be working with us 14:23:43 Capesteve: Now is the time for you to pretend that you volunteer to do it. :) 14:23:57 randomuser`: I certainly will. :) 14:23:58 oh, sherbet 14:24:54 I'll try to motivate some others to help with the text for outstanding bugs 14:25:56 Capesteve: I'll do my best to find you more volunteers. ;) 14:26:21 if it helps, there are badges 14:26:26 and sometimes tshirts 14:26:38 people here need luncheon vouchers 14:26:45 ha! 14:27:26 * randomuser` usually gets a "luncheon voucher" in the form of a "why did you stop working"phone call 14:27:53 sounds harsh if not cruel 14:28:16 and also OT, apologies 14:28:36 oh, while I'm thinking about it 14:28:44 here, zoglesby, have a badge 14:28:50 #chair zoglesby 14:28:50 Current chairs: randomuser` zoglesby 14:30:58 You can get a badge for that? o.O 14:31:09 for chairing a meeting? yes 14:31:12 yep 14:31:16 * jhradilek suddenly wants one too. :) 14:31:19 you got one last time, jhradilek 14:31:24 Did I? 14:32:07 yay! 14:32:18 at least, I thought you should have 14:32:30 https://badges.fedoraproject.org/user/1345 14:33:08 #chair jhradilek 14:33:08 Current chairs: jhradilek randomuser` zoglesby 14:33:25 hey Sparks 14:34:37 okay, guides are covered i think 14:34:49 #topic Outstanding BZ tickets 14:35:03 #link http://tinyurl.com/lbrq84 14:35:23 so, we've got some bugs thar 14:35:29 any we should talk about? 14:36:03 btw, croberts, i think you've discovered why you should commit and push frequently 14:36:06 :P 14:37:15 lol yes I have 14:37:30 i have learned the hard way 14:37:52 that is the best way 14:38:51 * lnovich sorry so late 14:38:54 miss anything? 14:39:42 lnovich, we're on bugs 14:39:55 eew .. bugs 14:40:37 indeed. We have quite a few of them, actually 14:41:24 maybe we need a VFAD or similar 14:42:44 wanted to ask in general - if another upstream community is making a package that is in Fedora and they already have a decent doc base for that feature - link to it or paraphrase it? 14:43:43 I would try and represent the feature in the Fedora docs, personally 14:43:51 #topic Open Floor 14:44:11 What does VFAD stand for? I can assume what it is, but Google suggests variable food agro diagnostics? Or perhaps variable fresh air duct? :P 14:44:23 lnovich, it could be very easy, depending on the upstream license 14:44:42 jamielinux: A Virtual Fedora Activity Day 14:44:52 jamielinux, virtual fedora activity day. basically we have a consensus about a date and purpose 14:45:04 sounds like a plan... 14:45:12 jsmith: randomuser`: Thanks! I did like Google's suggestions though.. ;) 14:45:42 sounds like a hackathon 14:46:01 what would that entail? 14:46:16 * randomuser` has never done one 14:46:32 neither have I 14:46:58 but i think having one day for doc writing Fedora sounds like a really good idea 14:47:33 we could probably get a lot of bugs cleaned up, as a group 14:47:42 yes we can 14:49:15 What's the plan RE publican 3.0? 14:49:38 * lnovich hides in the corner and pleads the 5th 14:49:50 jamielinux, releng, infra, and the publican maintainer are working on it 14:50:07 I suppose they will let us know when it is done and how to use it 14:50:16 randomuser`: Cool! 14:50:23 it may take a while but we are working on it 14:50:44 I will ask Rudi to give a status update if you want 14:50:44 lnovich: No rush, I was just wondering. publican 2.5 is pretty nice. 14:51:06 : 14:51:08 :) 14:51:30 i will ask/ beg him tomorrow when i speak w/him 14:52:14 is there any need - want for putting the MAN pages online ? 14:52:26 lnovich, Hopefully, he's aware we are interested in the progress already - no need to nag 14:52:44 sometimes rudi needs to be nudged 14:52:50 lnovich, there was some vague interest, but not enough to overcome the infrastructure demands of making it happen 14:53:04 we've discussed it a few times with no real development 14:53:06 what would be involved? 14:53:46 lnovich, something that would unpack every rpm on every update, format the manpage, and push to a web site 14:53:59 putting man pages on-line is waste of our time 14:54:23 efforts to improve man pages more important 14:54:36 Capesteve, +1 . It certainly isn't something I want to invest time in 14:54:37 Also there are man page conflicts to worry about too. Seems like a lot of effort for not that much benefit. 14:55:12 jamielinux: yes, version problems 14:55:26 ok noted 14:56:02 guides on how to do it for developers might be something jhradilek could look into in his new spare time? 14:56:17 is there a way submit a patch for changing a man page? 14:56:26 or is opening a bug better 14:56:29 or both? 14:56:50 lnovich, download/clone upstream release, generate diff? 14:56:52 lnovich: I do it for developers when I document thier application sometimes 14:57:05 ok guess i need to get more into that 14:57:17 Capesteve, I like that idea; better for users, and endears us to the devs 14:57:24 as i am getting involved more and more w/libvirt 14:57:43 can we talk offline on how it is done? 14:57:44 lnovich: clone the developers repo if you are working on documenting something new, take a look at the man pages 14:58:07 fascinating, fast paced development with libvirt 14:58:22 warp speed in a blender 14:58:42 we should be wrapping up, qa is starting soon 14:58:52 and the interaction with and without QEMU and KVM is a bit confusing to say the least 14:58:52 lnovich: ping me when you need to make your first patch or view your first man page in a repo 14:58:57 sure will do capesteve 14:59:43 time check 14:59:44 14:59:55 #endmeeting