00:01:38 #startmeeting Docs Project - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings#Thursday_July_23.2C_2009_.28Wed_US_Time.29 00:01:47 Who is here? 00:01:47 * Sparks 00:01:59 * jjmcd is onna fone 00:02:08 I'm here 00:02:22 * bcotton is here for a change 00:02:27 * laubersm 00:02:45 * rudi is here 00:04:05 * Sparks gives everyone a few more minutes to get here. 00:04:18 * danielsmw is here 00:05:58 * stickster 00:06:33 Okay, let's get started. 00:06:35 #topic Status on CMS (Zikula) <-- ke4qqq 00:06:56 So we had a Zikula planning meeting this morning... 00:07:17 and discovered that our deployment schedule is slipping because of problems we are having... 00:07:28 getting some of the modules packaged. 00:08:01 * stickster notes current status is at https://fedoraproject.org/wiki/Zikula#Module_status 00:08:02 One of the bigger problems is that these modules have snippets of code or skins or icons that are... 00:08:18 licensed under other-than-GPL licenses. 00:08:23 Thanks stickster. 00:08:42 The link that stickster posted is the current status of all the modules. 00:09:08 I plan on working on a couple of items tonight. 00:09:30 We also need to identify if there are other modules that are needed to stand up Zikula for the other projects. 00:09:33 * stickster did some work this afternoon, will try to resolve his other action item if time allows tonight 00:09:41 Does anyone have any questions? 00:09:54 What is the action item for identifying those modules? 00:09:59 Who is doing it? 00:10:37 We don't have that. 00:10:40 I think if we can identify the actionable task, it's easier for someone to put up their hand and say, "I'd like to help." 00:10:48 agrees 00:11:03 So I ask you, what is needed to do that identification? 00:11:18 (anyone can answer, really) 00:11:25 * stickster puts question out on table for consideration 00:11:39 I'm not sure. Maybe nothing. 00:11:42 Um 00:11:58 Who are the people involved outside Docs? 00:12:14 * stickster looks at list and sees Fedora Insight and Fedora Weekly News 00:12:23 mchua was working on the Marketing people for their foobar project 00:12:25 That's Marketing team, and News team, right? 00:12:29 yes 00:12:41 So how can we put them in a position to identify modules? 00:12:54 Point them to the website? 00:13:12 Well, maybe there's something we could do that's less... I don't know, flailing 00:13:13 Actually we probably need to sit down with them and help identify things they want to do. 00:13:18 Aha! 00:13:20 awesome 00:13:46 So that's a list that really *anyone* could make 00:13:54 Yes 00:14:09 If a project needs a calendar or something then we need to make sure that can happen. 00:15:08 Would anyone like to step up and help Marketing and News make these decisions? 00:16:16 * ianweller rolls in 00:16:26 perspectival: You're new here, what would *you* like to do? 00:16:53 grin; I'm madly busy preparing some statements right now 00:16:59 thanks for the offer but pass for the moment 00:17:12 OK, moving on then. 00:17:12 * mchua pokes head in as well 00:17:18 Hi mchua! 00:17:41 We were just saying, we probably need to have someone in Docs working with each of the teams looking to leverage Zikula 00:18:09 Because we'll want to compile a list of needs you have, elementary ways of displaying content 00:18:11 like "we need a calendar" 00:18:24 or "we need a daily-rotating headline" 00:18:26 for the record, I've got it on my plate before next tuesday to nail down specs for Fedora Insight's zikula stuff from the Marketing side... and I have stickster and ianweller as the Marketing <--> Docs interfaces... anything else we need? 00:18:27 or something like that. 00:18:34 a pony? 00:18:54 Ah, I guess that's me for your team then 00:18:57 and ianweller 00:19:02 So who's left? News? 00:19:09 Yeah 00:19:37 OK, that seems like the not-covered bit 00:19:59 stickster: I haven't met with anyone from that group. 00:20:28 I know JonRob is working with them a bit, might be good for someone here to round up with him and maybe Pascal Calarco, who I think said he'd be willing to meet with someone to discuss their needs 00:20:44 * stickster is trying to make sure that someone in that group knows something about Zikula, or at least knows someone who does 00:21:00 Sparks: Why don't you take this one then 00:21:20 #action Sparks to follow up with the News people about Zikula 00:21:31 Okay, anything else on the Zikula subject? 00:21:39 or maybe "to met with News people and solicit a list of their needs" 00:21:43 s/met/meet/ 00:21:53 Yeah, that too 00:22:01 * stickster thinks the more explanatory and concise the actions are, the easier it is to track them at the next meeting 00:22:37 #action Sparks to meet with News people and solicit a list of their needs 00:22:48 Okay, moving on. 00:22:52 * stickster stands down since munchkin bedtime is coming up 00:23:01 #topic Status on CC license rollout. <-- ianweller 00:23:04 * ke4qqq is here 00:23:08 sorry for being late 00:23:23 ianweller: Where are we on announcing to the world that we are changing licenses? 00:25:16 ianweller: Hello? 00:25:42 * stickster wonders if ianweller is still stuck on RH's guest net 00:25:46 Sparks: oh sorry :( 00:25:52 stickster: no i'm at the hotel 00:26:17 Sparks: we should be announcing to the world via a quasi-press release to CC and to fedora-announce-list i guess 00:26:26 i believe 00:26:38 * ianweller apologizes again for wasting meeting time 00:26:41 ianweller: When is this going to happen? 00:26:55 Sparks: when do you want it to happen 00:27:00 we just need to write something up and push it 00:27:13 and by "we" i mean "not me tomorrow or friday" 00:27:21 ianweller: Are we waiting on something to happen? Do we announce and then go through the process of changing stuff? 00:27:41 you can go either way, the way you said or the reverse 00:27:46 i would recommend the way you said 00:27:56 announce that we're committing license changes, hten actuallydo work 00:27:58 oh god i can't type 00:28:08 Actually, it really should be the other way around IMHO 00:28:20 You announce what you've done (or maybe even are in the process of doing) 00:28:37 Otherwise it's too easy to announce, find a blocker, and then people wonder why you didn't do what you said you'd do. 00:28:43 hmm 00:28:54 ianweller: can you get something written this weekend? 00:28:59 ianweller: What specifically is the action to change? 00:29:05 Sparks: that's funny, i'll try ;) 00:29:06 i.e. text in the wiki? 00:29:07 ianweller: I'm assuming that the wiki would be easy. 00:29:08 * ianweller adds it to his todo 00:29:12 yes wiki 00:29:13 What else? 00:29:18 Guides 00:29:29 otoh, if we want to give people a chance to object, we should announce it a bit ahead of time. i guess we're assuming that anyone who might care is on fedora-docs or fedora-legal? 00:29:31 Which means a change to the Fedora brand in Publian 00:29:32 i really don't know what all docs does that is being changed quite frankly. 00:29:38 bcotton: We've already done that. 00:29:38 s/Publian/Publican 00:29:43 bcotton: we've done thta for about a month i htink 00:29:44 think* 00:29:44 Sparks -- easy 00:29:45 oh 00:29:46 dear 00:29:46 god 00:29:50 give me typing lessons again 00:30:01 rudi: yeah, but then rebuilding all the guides... 00:30:08 Sparks: how about this 00:30:12 Sparks: can you guys create a rollout plan? 00:30:20 and then i can definitely write an announcement 00:30:23 Do we have to do that immediately, or just as we republish them? 00:30:37 #action Sparks to write rollout plan for license change 00:30:45 rudi: don't know 00:30:59 #action ianweller to write press release 00:31:15 ianweller: writing press release?! 00:31:45 onekopaka_laptop: i'd recommend some scrollback 00:31:56 is there anything else? 00:32:04 rudi: Can you help me with the Fedora-brand stuff? 00:32:14 i'd really just like to see an order in how everything has to be changed before we start doing it 00:32:15 Sparks -- love to. 00:32:19 so we can check things off as we go. 00:32:24 ianweller: I don't think so. Where are we going to push the release? 00:32:27 Sparks, I'll be happy to provide you with a sounding board as you develop that 00:32:39 Sparks: fedora-announce-list and mlinksva at CC 00:32:56 can you think of anything else 00:33:06 are there any documentation thinktanks or the like around the internet 00:33:08 #action rudi to help sparks on changing the fedora-brand in Publican for CC license 00:33:19 ianweller: how about a RH Press Release? 00:33:25 oh hey 00:33:26 i can pull that off 00:33:34 and/or i can make quaid do it 00:33:38 jjmcd: Cool 00:33:53 ianweller: You can MAKE quaid do that? Wow, impressive 00:34:04 * stickster has to run 00:34:09 well i can suggest it to him 00:34:15 and to some people with more clout than me 00:34:15 :) 00:34:29 like spevack 00:34:30 * Sparks doesn't know many people with more clout than ianweller 00:34:36 i am the wiki czar. 00:34:45 ok i think we're done on this subject, we've got good action items. 00:34:48 * Sparks hears thunder whenever ianweller says that 00:34:52 lol 00:34:55 Cool... Anyone else? 00:35:17 #topic Shared open-source style guide <--ke4qqq 00:35:24 #link https://www.redhat.com/archives/fedora-docs-list/2009-June/msg00163.html 00:35:31 ke4qqq: Any development on this? 00:35:53 someone should follow ianweller around with a recording of thunder and play it whenever he says "I am the wiki czar" 00:36:03 Sparks: sadly no - real life has gotten in the way of GTD 00:36:14 I'll try and fix that by tonight though 00:36:18 ke4qqq: understood. 00:36:33 that RL stuff can be a real pain 00:37:04 tell me about it 00:37:19 Okay, we'll follow up next week. 00:37:25 #topic Outstanding BZ Tickets 00:37:36 #link https://bugzilla.redhat.com/buglist.cgi?query_format=advanced&classification=Fedora&product=Fedora%20Documentation&bug_status=NEW 00:37:53 There are sixteen NEW tickets that have not been assigned. 00:38:34 danielsmw: Can we move the software-management-guide into the user guide? 00:38:36 there are some we just should close won'tfit 00:38:46 wontfix 00:39:19 ke4qqq: I agree but I think we should make sure that we make an effort to address all of them or at least make sure they've been fixed. 00:39:30 Sparks: yes, we can 00:39:49 danielsmw: Okay, I'll push those tickets (maybe one or two) to you, then. 00:39:52 k 00:40:29 danielsmw: Actually, one... :) 00:42:20 There are 69 total bugs that are either NEW or ASSIGNED. If you haven't looked at your ticket queue lately please do so and make sure you are working on these problems. 00:42:25 Anything else? 00:42:45 Sparks: lets spend some time post meeting working on doing something with NEW stuff 00:42:59 ke4qqq: Cool 00:43:11 Okay, moving on. 00:43:14 #topic Guide needs? 00:43:26 Anyone have guides that need some help? 00:43:39 Anyone want to help out with a guide? 00:43:49 I'd like to demote myself on the IG 00:44:01 ke4qqq: Denied 00:44:02 next? 00:44:11 #link https://fedoraproject.org/wiki/Docs_Project_meetings#Guides 00:44:32 The above link shows all our current guides and their status. Please keep this up-to-date. 00:45:17 ke4qqq: Do you need help or is RL catching up with you? 00:45:53 well a combination of things - I don't want to be a constraint - rudi is already doing the bulk of the work, and is effectively leading the guide 00:46:15 rudi: thoughts? 00:46:21 I still want to work on it, but figure those doing the bulk of the work should make the decisions, and that's def. rudi in this case 00:46:43 Well ke4qqq has never been a constraint! 00:47:08 Well, I'll let you two work that out. 00:47:18 I don't think ke4qqq has ever been confused with a speed bump 00:47:44 Anything else? 00:48:04 #topic New Guides 00:48:15 Installation Quick Start Guide 00:48:17 Anyone have a new guide or a new idea they'd like to discuss for a guide? 00:48:25 rudi: go! 00:48:48 There was some discussion about this in the lead-up to F11, and a lot more on f-d-l lately 00:49:07 I've now built the book 00:49:21 and have drafts available for review: 00:49:26 html is here: http://rlandmann.fedorapeople.org/IQSG/en-US/html-single/ 00:49:28 pdf is here: http://rlandmann.fedorapeople.org/IQSG/en-US/pdf/Installation_Quick_Start_Guide.pdf 00:49:48 I mentioned this on the list, but got zero feedback so far. 00:50:03 I'd like people to take a look and offer comments, in particular on the scope of the thing 00:50:11 Too much? Too little? Wrong focus? 00:50:25 how do u want to receive comments? 00:50:52 rudi: Maybe we can put it on the announce list to get others involved? Maybe some of the IRC support people? 00:51:07 Just keep in mind the constraint that I'm trying to maintain as much commonality with the text of the IG and other existing docs as possible, to ease the load on L10N in maintaining two separate but overlapping books 00:51:26 ke4qqq -- f-d-l is probably best 00:51:36 rudi: Do you want a BZ component for this guide? 00:51:43 Sparks -- yes please 00:52:10 #action Sparks to create BZ component for Installation Quick Start Guide 00:52:12 For the moment, I've directed the BZ to the install-guide component, but a separate component will ease confusion 00:53:04 Trac is here, for anyone who wants to join in : https://fedorahosted.org/installation-quick-start-guide/ 00:53:19 excellent 00:53:33 rudi: I'll take a look at it soon. 00:53:39 rudi: Anything else? 00:53:55 Nope -- that's it from me :) 00:54:00 rudi: Thank you 00:54:05 Sparks, the Virt Guide is still coming. I am just swamped 00:54:25 Tsagadai: Excellent. 00:54:26 I should have xml up by next week, hopefully 00:54:39 Tsagadai: Is in Trac? 00:54:47 Trac and git are set up 00:54:51 +1 00:55:10 Tsagadai: Do you want a BZ component for the Virt Guide? 00:55:14 could you make me a BZ component, hopefully Virtualization_Guide 00:55:33 #action Sparks to create a BZ component for Virtualization Guide 00:55:39 Tsagadai: Anything else? 00:55:55 from Tsagadai or anyone? 00:56:03 * Sparks needs to get his keys on this laptop so he can do all this work! 00:56:10 perspectival: From Tsagadai at the moment. 00:56:12 that's it for me for now. I will have lots of xml coming in soon 00:56:19 Tsagadai: Thank you 00:56:28 perspectival: You have something for us? 00:56:41 sure! 00:56:49 I mentioned the Deployment Guide a few weeks ago, and the goood news is that I've nearly got it all set up (and the unfortunate news is, of course, is that it's going to take another hour or so) 00:56:50 in view of these circumstances, I think what I'll do is announce the Deployment Guide on fedora-docs-list as early as tomorrow (it's rather late here) 00:57:09 let me do a quick intro as to what the Deployment Guide is about 00:57:33 I plan for the Fedora Deployment Guide to cover system administration tasks such as user administration, package management, and setting up network interfaces and various servers and services such as Apache, LDAP, OpenSSH, Samba, etc. 00:58:04 * Sparks thinks it sounds kin to the Desktop User Guide 00:58:23 but maybe for more of an enterprise crowd 00:58:25 I see (as of a few minutes ago) that I'll need to add this book to Docs_Project_meetings#Guides 00:58:28 I think it's very different from the UG 00:58:34 * nirik has a short thing if there is an open floor at the end. ;) 00:58:46 For the reason that Sparks just noted :) 00:58:56 nirik: There will be 00:59:04 perspectival: Yes, please add your guide there. 00:59:08 The question is, can it be structured so that translations can be borrowed from the UG, IG, etc? 00:59:11 I think that's probably a good description (more geared towards the enterprise crowd) 00:59:27 jjmcd -- translations can be borrowed from the RHEL deployment guide 00:59:33 that's correct 00:59:34 ahhhh better yet 00:59:36 already translated into 22 languages 00:59:50 * Sparks tries to remember the talk on Fedora for the Enterprise that someone did at the Raleigh FUDCON 00:59:55 huh?? FDG is already in 22 langs? 01:00:04 no -- RHEL DG 01:00:08 ahhh ok 01:00:14 ;D 01:00:35 this is goodness that we are thinking about these things 01:01:24 any questions from me at the moment? I'll provide a lot more info in an email tomorrow (including the current draft, how to get it and where to look at it, etc.) 01:01:24 Cool 01:01:35 perspectival: Excellent. 01:01:45 perspectival -- I guess this overlaps with the RPM guide to some extent 01:02:04 rudi: that's true, though I haven't had the chance to compare the respective info yet 01:02:11 perspectival: Yeah, get with bcotton and see if the two guides are similar 01:02:15 will put that on the GTDToDo list 01:02:23 ok! 01:02:25 I think there was some talk about revamping that; the revamp may be a duplication of effort... 01:02:26 will do 01:03:21 Anyone else have a new guide they'd like to discuss? 01:04:04 Okay, moving on 01:04:10 #topic All other business 01:04:17 nirik: You have something for us? 01:04:43 Yeah, we are looking for teachers for classes and more students for Fedora IRC CLassroom. 01:04:44 https://fedoraproject.org/wiki/Classroom 01:04:53 please consider teaching on docs topics sometime. ;) 01:05:17 nirik: Anything specific? 01:05:28 nope... anything you desire. ;) 01:05:44 and we are using a model now where you can just schedule your class when you can teach... 01:05:49 * jjmcd will consider a class for new beat writers 01:05:54 and we might do a weekend of classes near release time. 01:06:00 jjmcd: Very good idea. 01:06:08 just schedule 2 weeks in advance so we can advertise it. 01:06:32 ? 01:06:38 ke4qqq: Yes? 01:06:46 * ke4qqq will wait til nirik is done 01:06:55 thats all I had, just letting folks know. 01:07:03 Please see me or the classroom list if you have questions... 01:07:14 rudi: any movement on the RH style guide?? 01:07:37 Sorry ke4qqq -- I've been bogged down and haven't pursued this yet 01:07:44 no worries, same story here 01:07:51 I'll make sure I follow it up today 01:07:56 Oh, I have something (should have been in the guides discussion) 01:08:23 * rudi has something else too (when Sparks is done) 01:08:30 We had an open ticket from a few years ago... 01:08:50 asking for more formats of our guides. 01:09:02 * danielsmw has to split; peace. 01:09:17 So is it a problem to create html, html-single, and pdf for all our guides and put them on docs.fp.o? 01:09:21 danielsmw: See ya! 01:09:39 AFAIK, pdf doesn't work again 01:09:45 just a bit more work and clutter IMO 01:09:49 jjmcd: There's a rouge patch out there. 01:09:55 ah 01:10:04 jjmcd -- it's on my Fedorapeople page 01:10:11 we really should solve the clutter problem before adding more content - the 30 some odd languages in one format is enough. 01:10:27 ke4qqq, I thought mo was going to sort that for us 01:10:33 41 for RNs 01:10:40 jjmcd -- rogue patch: http://rlandmann.fedorapeople.org/xslthl-2.0.0-1.fc11.noarch.rpm 01:10:44 ke4qqq: http://docs.fedoraproject.org/selinux-user-guide/ 01:10:54 ^^^ not so cluttered. 01:10:55 jjmcd: didn't we tell her to hold off pending zikula 01:11:15 Yes, when Zikula comes in all this might be different 01:11:17 that's not bad 01:11:19 maybe you're right, as soon as we handed it to her it went off my radar 01:11:45 ke4qqq: Yeah, it's a lot clearer. I built that as a "try". Could be fixed up even more. 01:11:49 * rudi notes that the licence change may provide a good opportunity to publish extra formats... 01:11:57 ke4qqq: We always get requests for whatever isn't there. 01:12:03 +1 01:12:12 But only 3 languages, and no "iso" 01:12:27 no iso? 01:12:46 language codes 01:12:55 I put the language codes in there. 01:13:00 For RN's we have "as released" as well as most current. As release is "iso", I presume because it was on the live cd 01:13:25 Sparks: ignore me, I missed the parens 01:13:47 Okay... Now if I could translate "single" into all the different languages I'd truely be happy 01:14:38 rudi: You had something else? 01:14:54 Yeah; I've checked in Publicanized versions of the "minor" docs packaged with the RN; these are now in translation. 01:15:06 I didn't do the "homepage" doc because I didn't know what its future is, and don't want to waste translators' time. 01:15:14 I noticed. Thank you! 01:15:19 * rudi notes that the module is showing up as "deprecated" in Transifex 01:15:33 Is it time to pull the plug finally on this one? 01:15:37 jjmcd -- NP 01:15:56 I think we need to get with the maintainers of the "minor" browsers that use it 01:15:57 maybe 01:16:13 We got more browsers ... 01:17:24 Also; I think we need to come to a decision about whether all these need to be packaged with the RNs themselves; but I guess that's one for the RN packaging meeting -- do we have a firm time for that? 01:17:46 rudi: 1500z today. 01:17:54 rudi: Not sure if that's too late/early for you 01:18:25 Great -- that's 1AM for me, but I'll be there. I just didn't want to stay up for it unless I was sure that it was going ahead! 01:18:38 jjmcd: You gonna be there? 01:18:42 yep 01:18:53 I'll be there... So that's three of us! 01:18:58 lolz 01:19:22 #action Sparks to send out reminder about the RN meeting 01:19:32 Okay, anything else? 01:19:38 Not from me 01:19:42 Anyone? 01:20:10 Okay, thanks for everyone coming tonight. 01:20:14 #endmeeting