14:00:27 #startmeeting Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings 14:00:27 Meeting started Mon Feb 9 14:00:27 2015 UTC. The chair is randomuser. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:00:27 Useful Commands: #action #agreed #halp #info #idea #link #topic. 14:00:27 #meetingname Fedora Docs 14:00:27 The meeting name has been set to 'fedora_docs' 14:00:27 #topic Roll Call 14:01:49 * rkratky here 14:02:21 #halp 14:02:28 woops 14:02:31 heh 14:02:47 ....it's early sorry 14:05:27 Allright, let's get rolling then 14:05:38 #topic Follow up on last week's action items 14:06:08 action items listed are "fix yo' bugs" 14:06:14 so keep on doin' that 14:06:25 #topic New Writers 14:06:50 #info in this part of the meeting we give new writers the opportunity to say hello or ask questions 14:08:12 * smccann is new and lurking 14:08:43 welcome, smccann 14:09:19 Hello, I have been searching for a page that can help guide me in the use of the trac system. 14:09:56 grundblom, I can't think of such a page on the Fedora Wiki offhand 14:10:09 maybe upstream trac has some usage stuff? 14:10:40 Good idea, I will broaden my search to general trac usage pages 14:10:52 Thank you 14:11:12 I'm going to skip talking about publishing for now in case jhradilek shows up later 14:11:16 or ptisnovs 14:11:34 #topic fedora.next product updates 14:11:57 it's on the agenda - anyone have something to share here? 14:14:16 me neither 14:14:26 #topic Guide Status 14:14:39 Anything to report on guides? 14:16:54 * randomuser did not work on guides during the last week 14:17:11 lnovich, are you here today? 14:17:36 somewhat 14:18:05 lnovich, can you share any plans for the virt guides? I recall you were going to check in with some other people about it 14:18:56 i haven't gotten much response from the maintainers themselves 14:19:17 * randomuser nods 14:20:05 i am also wondering if the guide is geared towards our users anyway 14:20:27 and if it could be simplified 14:20:36 well, no, not so much; it talks about rhel subscriptions, even 14:20:50 i am thinking of a complete re-write 14:21:00 a guide that doesn't cross barriers 14:21:16 and therefore is less subject to that kind of crossover content 14:21:56 I think at least keeping the virt quickstart guide up to date would be a good thing 14:22:26 absolutely 14:22:46 complete rewrites are massively time-consuming... and then you have to take care of two different guides 14:23:10 trust me, I know :)) 14:23:50 i know you do - and my time is limited - but i still have the nagging question in the back of my mind 14:24:17 what do Fedora users need and Use - it is different from RH users 14:24:30 my concern at this point is that we don't have an entry path if a contributor does come along that does have the time to work on these guides 14:25:03 then the one thing that needs documenting is Boxes - and setting up a VM with it 14:26:10 The Quick Start for Fedora needs Boxes instructions as well as Virt Manager as both tools are pominent. 14:26:56 true 14:27:43 and at the moment there isn't much on boxes 14:28:17 so it could be a good entry point 14:28:35 and if anyone needs help on it, i can give information 14:29:08 the other virt guides I can work on in March - not before 14:29:19 that's a start 14:29:36 I would like to try to help with the boxes guide 14:29:41 #info virt quick start guide needs updating, re: boxes in particular 14:29:50 nice, grundblom ! 14:30:36 keeping in mind i'm a rank newbie all-round (including virtualization) - I can attempt virt-manager as I need to figure that out a bit for the day job anyway 14:31:21 where are you two at in terms of tooling and workflow? 14:31:57 should we arrange a crash course soon, or are you comfortable diving right in? 14:32:13 I am learning docbook, trac, and how to use git (if its used here) 14:32:15 virt manager has had some UI changes so screen shots need to be changed, but otherwise the instructions are correct 14:32:28 (and indulge me if we've had this conversation before, early here too :P) 14:32:29 i experimented a bit back in Dec based on pointers here, but yeah... pretty much - rank newbie. I'm a techwriter using xml in the day job, so can likely pick up that part w/ some guidance 14:32:31 and i am here if anyone needs help 14:33:38 grundblom, yeah, we use git :) 14:33:53 given that I didn't remember trac was part of the equation, i'm behind groundblom on the learning curve 14:34:14 there are trac instances for each guide, but we don't really use them 14:34:45 in fact, we've discussed getting rid of them several times and nobody is interested enough in trac to even delete them :P 14:35:03 * randomuser says, realizing that's probably his responsibility 14:35:08 I am fine with jumping right in, it will be awkward at first, but, it wont last forever :-) 14:35:14 anyway, if there aren't others needing a crash course, I can bang away and come back w/ questions as needed. What's the timeline here for the updated quickstart? 14:35:33 say, one month to publishing? 14:35:58 ok 14:36:12 there is also an installation guide - so both need to be looked at and maybe combined? 14:36:28 So these guides will live at docs.fedoraproject.org correct? 14:36:37 I'm usually around in #fedora-docs, or someone, so ping whenever 14:36:41 grundblom, yes 14:36:54 lnovich, you want to merge the installation guide with the virt quick start guide? 14:38:50 the content in git right now is quite old 14:39:05 grundblom, smccann - we have office hours on Thursdays, at 14:00 US eastern - let's check in then 14:39:10 if the time works? 14:39:43 i have a dayjob meeting at that time, but can sporatically type...so long as a slooooow conversation works for you 14:40:11 smccann, it often goes through the rest of the afternoon, we don't have to start promptly then 14:40:19 randomuser: can we discuss this tomorrow or after the meeting on how do best accomplish this? 14:40:19 k 14:40:26 lnovich, sure 14:40:31 and that way move on...? 14:40:35 I do not have anything on my Calendar then, so I will make an appt for then 14:40:41 Thanks 14:41:42 great, we have a plan then 14:41:47 randomuser: grundblom, smccann - I will not be able to make that meeting but maybe if you are still around at 15:00 I can join you 14:42:18 sounds good, lnovich 14:42:36 #topic publican & publishing 14:43:16 I was playing with jenkins over the weekend, and I think we can get it to pull strings from zanata, test build, and merge them in iff the build passes 14:43:32 it can probably push strings out just as easily 14:44:10 which would make keeping translations up to date roughly 1,247% easier for everyone involved 14:45:10 wow i like those statistics 14:46:19 otherwise, I'm waiting on some sort of readme from jhradilek or ptisnovs before moving on 14:47:37 rkratky, did you have anything to share here? 14:47:53 fine if not, but I don't want to move on prematurely 14:47:58 randomuser, not really. 14:48:07 * lnovich needs to run 14:48:15 okay 14:48:23 #topic Outstanding BZ Tickets 14:48:31 #link http://tinyurl.com/lbrq84 14:48:44 there it is, we have bugs 14:49:50 #topic Open Floor Discussion 14:52:09 Anything I've missed? 14:58:29 okay, thanks for coming everyone 14:58:34 #endmeeting