14:00:28 #startmeeting Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings 14:00:28 Meeting started Mon Jan 21 14:00:28 2013 UTC. The chair is bcotton. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:00:28 Useful Commands: #action #agreed #halp #info #idea #link #topic. 14:00:34 #meetingname Fedora Docs 14:00:34 The meeting name has been set to 'fedora_docs' 14:00:43 #topic Roll Call 14:01:12 g'morning 14:01:18 * bcotton waves 14:01:28 * pkovar is here 14:01:29 here (typing furiously) 14:01:39 i suspect our FUDcon attendees will be too conned to show up this morning 14:01:44 * Capesteve is here 14:01:48 which is okay, because the agenda is short 14:04:12 * Sparks is here 14:04:29 #chair Sparks 14:04:29 Current chairs: Sparks bcotton 14:04:56 Sparks: after your email, i was hoping you would be 14:05:20 okay, let's start 14:05:29 #info Participants are reminded to make liberal use of #info #link #help in order to make the minutes "more better" 14:05:38 #topic Follow up on last week's action items 14:05:46 i did mine, yay! 14:06:00 pkovar: to file a bug report against publican to see if the global change of the install dir is realistic ? 14:06:17 ah, well... 14:06:34 i thunk i will mail the publican list instead 14:06:47 since there have been several comments and concerns 14:06:52 regarding this change 14:06:52 okay, cool 14:06:57 and CC doc list 14:07:14 it is not about the path only 14:07:24 another problem would be lang codes 14:07:26 #action pkovar to mail the publican list and docs list to see if the global change of the install dir is realistic 14:07:40 solution: no more translation :-p 14:07:40 so these all need to be addressed somehow 14:07:51 right! :-) 14:08:25 will see what others think... 14:08:33 sounds good 14:08:36 any other action item follow ups i've missed? 14:08:49 from me, i think that's it for now 14:08:58 bcotton: I sent an email? 14:09:15 Sparks: you did, that's correct. want to bring it up here or as a separate topic? 14:09:29 bcotton: I don't know what email you speak of 14:09:39 Sparks: oh 14:10:01 Sparks: the one froma few minutes ago about publican 3 14:10:27 Oh, yeah I can talk about that one 14:10:41 ah, was about to ask re: publican3 14:10:47 Sorry, I actually wrote that yesterday but it was just sitting in my outbox 14:10:50 #topic Publishing docs with Publican 3 andkoji 14:10:57 the floor is yours, Sparks 14:11:00 Okay 14:11:08 So... 14:11:31 Publican >= 2.8 can package docs up into SRPMs 14:12:04 multi-lang packages? 14:12:11 The Publican backend that makes the docs.fp.o can then just install these docs 14:12:26 One menu entry per language 14:12:31 This makes the web git repo unnessecary 14:13:10 And, thus, we won't need to mess with any of that anymore. 14:13:32 To make all this happen we need a tag on Koji 14:13:37 and our own repo 14:14:11 We've had a ticket open in RELENG to make this happen for a while but we didn't *need* it until after F18 was released as so to not mess up things right before the release 14:14:21 The idea being that anything in the repo shows up on docs.fp.o? 14:14:28 Of course we didn't know that such a delay was even possible for the release so it's been a while 14:14:44 I spoke with Dennis and Kevin about this and this should happen soon. 14:14:56 EOF 14:15:15 Sparks: Question - The idea being that anything in the repo shows up on docs.fp.o? 14:15:53 and we back of via a yum downgrade? 14:16:47 jjmcd: Yes 14:17:05 jjmcd: The backend would generally do a 'yum update' on a regular basis 14:17:05 So, we'd end up with the same workflow as any other package, with per-rpm ACLs and such? 14:17:15 And does it mean that anyone who publishes has to put up with the torrent of Nagios messages? 14:17:17 randomuser: Not exactly. 14:17:44 randomuser: we could but we aren't putting this into the Fedora repo but rather our own repo 14:17:59 Nagios? 14:18:23 Ahhh, OK, so I don't have to log on to update a doc, the backend just deals with it - OK 14:19:08 I was thinking we would need infra privs to log on and say yum update 14:20:21 jjmcd: I don't think so but I'll have to refer you to Rudi as I've not seen this thing work. 14:20:32 This is how they do it for Red Hat implementations, though. 14:20:42 Sounds pretty decent 14:20:51 Sparks: do you have a wiki page for information ont his? 14:21:48 I do not 14:22:03 I don't have specific knowledge of the magic 14:22:28 would you mind starting one? we can fill in info as we get it 14:24:50 i'll take that as a "sure, i'll do exactly that" :-) 14:25:14 #action Sparks to start a wiki page for collecting information on publishing via Publican 3 and koji 14:25:19 anything else on this topic? 14:25:39 this will also need the RN RPM will have to change i guess? 14:25:58 like one lang per rpm instead of multi-lang RPM? 14:26:07 that's a good question. 14:26:46 running publican package with publican 3 produces one lang RPM, fwiw 14:27:05 d-p-r doesn't use Publican's packaging because 1 lang per RPM means one menu entry per language 14:27:21 e.g. Fedora-System_Administrators_Guide-17-web-en-US-1-0.fc17.src.rpm 14:27:28 d-p-r gives menu entry and doc depending on your selected lang 14:27:40 Sorry, I'm on every other channel this morning 14:27:55 d-p-r? 14:27:58 Yeah, I can try to start one although I think Rudi has all the answers so far 14:28:08 The outfit that makes the RN RPM 14:29:13 i guess you could still make your own RPMs with different layout, but publican seems to default to one lang per RPM 14:29:34 Yes, very un-Fedora-like 14:29:46 yes, it's different 14:29:59 Good releases we have 40 languages for RNs, do you want 40 menu entries? 14:30:10 we would need our own doc category e.g. in gnome shell then... 14:30:32 ok, so i will send that mail :-) 14:30:54 to get more feedback on this particularly interesting topic :-) 14:31:06 pkovar: https://fedoraproject.org/wiki/Getting_the_release_notes_to_Bodhi 14:31:28 ty 14:32:30 okay, anything else on this topic? 14:33:02 #topic Docs Leader election 14:33:12 #info randomuser is the only candidate 14:33:27 In the proud docs tradition of leaving one person out to dry... 14:33:32 * bcotton plays trumpet 14:33:45 how nice 14:33:48 #info randomuser is your new glorious leader 14:33:53 #chair randomuser 14:33:53 Current chairs: Sparks bcotton randomuser 14:34:12 * Capesteve claps and waves 14:34:17 * randomuser cringes exaltedingly 14:34:17 randomuser: if you're still here, the rest of the meeting is yours :-) 14:34:25 Congrats randomuser 14:34:27 all hail randomuser 14:34:34 I shouldn't have said anything! 14:34:38 heh 14:34:48 randomuser: that'll teach you 14:34:52 lol 14:35:08 pkovar, also https://fedoraproject.org/wiki/What_did_doc-publican-rpm_do 14:35:20 really, it is great to be part of a group of such competent people 14:35:25 jjmcd: ty 14:35:27 14:36:16 so, funcon then? 14:36:20 #topic FUDcon NA 14:36:46 We're all green with envy for those who were able to attend, anything to share? 14:36:59 ASCIIDoc 14:37:17 That is all 14:37:56 There was lots of streaming on G+, but I didn't get to watch a lot of it 14:38:12 Was all day Saturday in training 14:40:00 nothing else? 14:40:32 #topic Outstanding BZ Tickets (5 minutes) 14:40:39 #link http://tinyurl.com/lbrq84 14:40:47 I'm going to write up something for ASCIIDoc but I think it has the potential to make life easier for new writers 14:41:09 oh, sorry Sparks 14:42:24 no worries 14:42:27 Any comments on bugs, then? 14:44:07 We don't have no stinking bugs 14:44:34 * randomuser shakes a fist 14:44:48 #topic Open floor discussion 14:45:21 Fo we have anything in firewalld yet? 14:45:32 s/Fo/Do 14:45:46 * zoglesby is awake 14:45:48 i've looked at it, and gotten confused :/ 14:46:15 Yeah, I still hadn't gotten my head around systemd 14:46:24 I may be able to help with firewalld 14:46:28 and there they go breaking my firewalls 14:47:21 Capesteve, i think even a basic high level overview would be great 14:48:01 I have also been asked to do that for DNSSec 14:48:22 A map for getting from iptables even better 14:48:33 jjmcd, +1 14:48:49 today I am busy with chrony, hope to get back onto DNSsec this week 14:48:58 Right now I seem to have to disable it and start iptables, but I'm sure that will go away at some point 14:49:26 Capesteve, are you making wiki pages, or working on a guide? 14:49:32 firewalld is on my TODO list but .... 14:49:37 I am working on a guide 14:49:45 cool 14:49:58 but at some point guide material can be duplicated to other guides 14:50:38 the system administrator's guide, i assume. Is it participation-friendly, or would we step on your toes at this point? 14:51:09 ..I am waiting for a colleague to help with a draft doc on firewalld, I was just going to clean it up etc, 14:51:26 okay, cool 14:51:28 but DNSSec I will do mostly myself 14:51:58 randomuser: proof reading is always welcome 14:52:22 expcially from someone who can actually try some of it out 14:52:44 I have a brand new fileserver here that could use some firewalld attention 14:52:52 I think sparks is going to be my new friend 14:53:04 Capesteve: firewalld needs to go into the security guide 14:53:12 although adventures with `teamd` have brought it off the network 14:53:17 if you can write up a chapter for that I'll happily include it 14:53:18 yes, understand 14:53:39 teamd is also on my ToDO list 14:54:08 Capesteve, if I figure it out enough to write something up, i'll let you know 14:54:26 OK, keep in touch then 14:55:06 jsmith and I are going to be working on ARM guides if anyone wants to help 14:55:19 and we also need to add an arm beat to the release notes 14:55:38 #info jsmith and zoglesby are working on ARM guides if anyone wants to help 14:55:38 just fyi 14:55:47 zoglesby, I'll make that happen 14:56:10 #action randomuser to add ARM beat for release notes 14:56:25 add it to the wiki list of beats, i mean 14:56:54 randomuser, +1 14:57:26 zoglesby, If I had more cycles, got both a Pi and a Beagle here doing usefulwrk 14:58:09 zoglesby, did you see my planet post the other day? 14:58:20 jjmcd: no worries, if you do you do, if you don't I'll make jsmith do it all 14:58:36 jjmcd: no I did not 14:59:18 http://jjpmcd.livejournal.com/21226.html 15:00:26 jjmcd: excellent 15:01:04 We're at the end of our block of time - shall we take this party to #fedora-docs ? 15:01:20 * Capesteve bye 15:01:25 Sounds like a plan grand master 15:01:28 #endmeeting