14:02:43 #startmeeting Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings 14:02:43 Meeting started Mon Oct 7 14:02:43 2013 UTC. The chair is randomuser. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:02:43 Useful Commands: #action #agreed #halp #info #idea #link #topic. 14:02:43 #meetingname Fedora Docs 14:02:43 #topic Roll Call 14:02:43 The meeting name has been set to 'fedora_docs' 14:02:48 * Capesteve waves 14:02:51 14:03:04 * jjmcd 14:03:42 * randomuser is mostly here 14:03:58 * yruseva yep 14:04:05 * lnovich here! 14:04:15 * iWelcome here 14:05:43 I don't think we have any action items, so 14:05:51 #topic Release Notes - Changes 14:06:22 I started plowing through the Changes over the weekend, and I see pbokoc grabbed some too 14:06:51 I will be able to get to my changes this week or next if that is not too late 14:07:00 randomuser, yeah. Btw, I noticed you added unversioned docdirs into the installer - are you sure it belongs there? 14:07:11 not that I have a better place to put it in 14:07:14 #link http://fedorapeople.org/groups/schedule/f-20/f-20-docs-tasks.html 14:07:42 pbokoc, lol, I added some things to other beats before I noticed you put them into installer :) 14:07:54 honestly, i just couldn't think of a better place 14:08:43 Things will probably get moved when converted to docbook 14:08:46 randomuser, well, that's actually something I wanted to ask earlier - is it OK to have one feature in multiple places? For example, sendmail not being installed by default fits into both Installer and Mail Servers 14:09:03 jjmcd, ^^? 14:09:09 14:09:21 ack 14:09:29 Place a note in one place with an xref to the other 14:09:33 allright 14:10:33 With something this important I would put in a warning or at least a note 14:10:37 pbokoc, is that what you were pinging about on friday? 14:10:45 randomuser, yeah, that's it 14:11:33 pbokoc, i spent a couple hours reading devel threads and such, looking for hints on how a regular user is able to view their own log output via journalctl 14:11:57 i think we just need to advise them to redirect output to file or pipe, or put sendmail back if they want that 14:13:23 * pbokoc thinks 14:14:02 well, if anyone comes up with something... 14:14:13 randomuser, do you mean in the install guide, or just a short note in the release notes? Because it doesn't fit into either, honestly 14:14:18 i might try pinging mattdm 14:15:03 pbokoc, a normal user has no way to get STDOUT/STDERR because crond does not run as a normal user 14:15:32 im thinking for the release notes, i anticipate this to be a much asked question 14:16:19 we don't need to dwell on it now 14:16:34 yeah, that's probably true 14:16:50 #info beats on the wiki are closed, according to the schedule. Further work should be done in git. 14:17:20 #info Please commit and push *often* 14:18:02 lnovich, will you have time for the virt beats in the next few days? 14:19:27 time is a rare commodity that i haven't been able to invest in 14:19:46 when do you need the beat done? 14:20:19 lnovich, if it isn't done by, oh, thursday or friday i'll probably do it myself 14:20:33 ok I will fit it in 14:20:33 it just won't be as good 14:20:43 thanks! 14:20:46 there are 4 issues i know about 14:21:09 i mean features 14:21:09 the others I may not be able to get on time 14:21:40 we have some time before the release, but the translators need to work on this too 14:21:45 one is currently under debate on if it will get in or not 14:21:54 oh? which one? 14:22:03 hyperv enlightenment 14:22:18 hmm.. i wasn't aware of that 14:22:39 is there a Change page? 14:22:51 never mind it is how to word it that is being debated 14:23:49 well, i'm sure whatever wording you come up with will be fine 14:24:16 yup - i will grab Cole from the KVM team and get him to give me something tomorrow 14:24:47 Will you be available on thursday to walk me through the process if I am having difficulty? 14:24:55 randomuser? ^^ 14:25:09 as this will be my first beat 14:25:09 don't make him polish it too much - it seems to discourage participation of it feels like the dev is doing the writing instead of us 14:25:28 don't worry - I do the polishing 14:25:42 lnovich, during some of the day, probably 14:25:53 Cole gives me coal and I make the diamond 14:26:00 if nobody is in -docs you can email me, I carry that during the day 14:26:03 +1 14:26:28 great! - ok I will get something together tomorrow / Wed 14:26:33 thanks 14:26:58 do we worry about QEMU or Libvirt ? 14:27:02 yes 14:27:17 ok I can easily get libvirt - QEMU will take some digging 14:28:32 any other RN questions we should cover? 14:28:52 randomuser, yeah: do we each move our own beats from the wiki to git, or does someone do that centrally? 14:29:31 pbokoc, The last release or two i did it all and Capesteve reviewed it; I would not object to help 14:29:50 Ruth Suhle has some good QEMU stuff in her blog 14:30:00 randomuser, ok, I can help. Let's talk later about splitting it. 14:30:09 Capesteve can read faster than he can type 14:30:10 pbokoc, cool, thanks 14:30:56 pbokoc, the beats table has tracking fields for that, but wiki tables are a pain IMO 14:31:22 yeah, they are 14:31:23 maybe we need a new tool? 14:31:52 lnovich, a new tool would be nice, and someone to find it, deploy it, maintain it 14:32:35 what about trello? 14:32:51 At least you only need to change a couple chars per beat in the ugly table 14:33:35 ^ what he said. I don't think the time investment for switching to a completely different tool is worth it for the 30 or so rows we have to go through every 6 months 14:34:19 agreed; although that doesn't prevent anyone from investigating 14:34:30 * randomuser won't object to someone else doing the work 14:34:36 hehe 14:34:39 ;-) 14:35:20 so, on to guides? 14:35:29 And those 30 or so rowas are spread among all the writers. *BUT*, a new writer has to get past the learning curve 14:36:47 speaking of noobs, there have been new writers coming in and out - where are they and does anyone need help with their guide ( other than me??) 14:37:06 oh, good point lnovich 14:37:15 let's talk about that, i have been wondering too 14:37:19 #topic new writers 14:38:00 #info new writers ( and old ) can find help from the group 14:38:09 #link https://fedoraproject.org/wiki/Docs_Project_mentors 14:39:18 lnovich, i think that it's hard for a new writer to find a place to contribute unless they are very self-motivated 14:39:41 our task suggestion page could probably use some love 14:40:37 and really, this is something that we, as a group, should be putting some concerted effort into 14:41:18 there are introduction mails semi-regularly, but not really new committers 14:43:21 ........will be great to see at least one introductory session about: "how to use the tools while contributing in the documentation" 14:43:30 unfortunately the installation guide isn't really something for a new contributor 14:43:40 iWelcome, have you looked at the Documentation Guide? 14:43:51 yes :) 14:44:29 iWelcome, i haven't looked at it in a while, but if there's something missing I'd be willing to work on it 14:44:30 ah i understand 14:44:41 iWelcome, just speak up 14:44:48 iwelcome - have you ever used docbook before? 14:44:57 yes I do 14:45:15 ok which tool is causing you difficulty? 14:46:10 right now nothing, but it takes almost few days to learn the git and all the procedures to submit the patch 14:46:12 :( 14:46:17 it might be better to hold the tutoring sessions in #fedora-docs 14:46:28 +1 14:47:23 iWelcome, much of the work done on documentation is complaint-driven - and that's true for the meta-documentation as well 14:48:00 don't be afraid to ask questions, or ask for a howto on a procedure you are unfamiliar with 14:48:30 iwelcome - anytime you see me online - just ask 14:48:37 randomuser, i am not complaining 14:48:49 iWelcome, my point exactly - you should be! 14:48:53 lnovich, I will, thanks 14:49:08 i will be taking another look at the documentation guide once F20 goes out 14:49:14 randomuser, btw, it might be a good idea to add irc nicks into the Mentors page. I know they're on each mentor's user page, but having them all in one place might be more encouraging (or something... :) 14:49:29 good call, pbokoc 14:49:43 #action randomuser to add irc nicks to https://fedoraproject.org/wiki/Docs_Project_mentors 14:49:55 +1 pbokoc 14:51:45 the documentation guide has always been a draft thing; working on that might be a good way to get familiar with everything, iWelcome 14:52:04 that's what jjmcd suggested for me, and it worked out ok 14:53:21 i understand, but please explain how? 14:54:07 ok, we can go over that after the meeting if you have time 14:54:12 #topic open floor 14:57:41 looks like time to wind this up 14:57:58 thanks for coming all 14:57:59 So, I assume randomuser is buying the beer for the after-meeting party 14:58:25 beer is *much* cheaper in cz 14:58:31 :) 14:58:43 yes, yes it is 14:58:50 pbokoc should do it, he probably has enough for all of us on his person 14:59:03 * randomuser elbow-jabs pbokoc jovially 14:59:32 I do, but I can also drink all of it myself 14:59:47 :) 15:00:05 #endmeeting