00:01:31 #startmeeting 00:01:31 #meetingtopic Docs Project meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings#Thursday_July_9.2C_2009_.28Wed_US_Time.29 00:01:48 * Sparks is here 00:02:26 * jjmcd is here - barely 00:02:30 * rudi is here 00:02:38 * laubersm hides in the back 00:02:47 hiiii 00:02:48 * mhideo here 00:04:04 * Sparks gives everyone a few more minutes to trickle in 00:04:24 jjmcd: busy or tired? 00:04:39 Just got back 2 minutes ago -- need coffee badly 00:06:49 Okay, let's get started... 00:06:52 #topic Using a forked version of Publican 00:06:52 #link https://bugzilla.redhat.com/show_bug.cgi?id=476471 00:06:54 Bug 476471: medium, low, ---, petersen, ASSIGNED, Review Request: fedora-security-guide - A security guide for Linux 00:07:04 The link above is to the Security Guide which is where this question originates. The Security Guide wasn't supposed to have a component (fc11) attached to the name because it is not version specific. A hacked version of Publican was used to create the latest SRPMs which allowed us to do this. The reviewer is would like a concensus on whether using a forked (hacked) version of Publican to produce these files is okay or should we only allow "officia 00:07:28 This might be a moot point because Mike will talking about the new Publican (1.0) here in a sec... 00:07:45 but this might be something to look at from a distance as well. 00:07:46 Sparks: you fail at message lengths 00:07:52 Sparks: cut off at allow "officia 00:07:54 Do you really need to hack Publican? Why not just make your own RPM? 00:08:17 ianweller: l" releases of Publican. 00:08:31 jjmcd: Well, at the time I was just trying to make the tool work. 00:08:46 * ianweller is against forking, just use a hacked rpm 00:09:05 The question is... can we use a non-supported tool to get the job done? 00:09:11 yes. 00:10:10 Anyone else? 00:10:13 I would be concerned if someone needed some unavailable tool to build the document from sources. I'm less concerned about the rpm itself 00:10:27 yeah you would want to post what hacks you did 00:10:30 on the wiki, most likely 00:10:38 but other than that, whatever 00:10:45 ianweller: good point 00:10:50 wait. 00:11:07 Sparks: is the fedora-security-guide rpm created from docbook sources or does docbook stuff the rpm with html files? 00:11:14 s/docbook stuff/publican stuff/ 00:11:25 also, correct me if i sound stupid 00:11:36 ianweller: Good question. 00:11:48 ianweller, I think the answer is yes 00:11:55 well then 00:12:02 wait. 00:12:03 The package built correctly in koji and looks appropriate 00:12:17 if the hacked version of publican isn't what's on koji then how can it work 00:12:33 Because koji gets the srpm 00:12:44 because the hacked version is what created the srpm and spec... 00:12:50 the spec is what the problem is 00:12:52 ohhhhhhhh. 00:13:08 yeah don't worry about forking, just say on the wiki what the changes were so other people can reproduce it. 00:13:14 my USD 0.02 00:13:19 cool 00:13:21 anyone else? 00:14:09 I'm still confused 00:14:25 Isn't the hacked version of publican needed to do the building according to the spec? 00:14:25 * bcotton is perpetually confused 00:14:34 lol 00:14:40 Or is the hack *purely* to change the way the srpm/spec are created, and has nothing to do with the build process? 00:14:57 stickster: the hack "fixed" the spec issues 00:15:08 nothing to do with the build process 00:15:17 OK, question answered, thanks 00:15:28 anyone else? 00:15:30 #agreed We can use "hacked" versions of tools (Publican) to create SRPMs. 00:15:34 opps 00:15:46 That wasn't supposed to have gone out quite yet. 00:16:05 #agreed We can use "hacked" versions of tools (Publican) to create SRPMs as long as it doesn't affect the build process and the "hack" is documented on the wiki. 00:16:23 And while we are on the subject of Publican... 00:16:26 #topic The new and improved (and shiny, too) Publican. <-- mhideo 00:16:27 disco 00:16:40 mhideo: Tell us about Publican 1.0, please. 00:17:15 One of the challenges with publican is the number of features that the software needs to support 00:17:33 everything from glossaries in japanese to printing non-A4 sized paper 00:17:42 lots of other things 00:18:01 the package maintainer has spent the last 3 months re-writing it to use plugins 00:18:13 so if you want a feature, you can write a dead-simple plug in for it 00:18:39 that way development does not bottleneck on a single soul and individual features can be trialed buy different writers/translators 00:18:48 Sparks, does the above make sense? 00:19:22 mhideo: yes it does! 00:19:33 mhideo: Is there documentation available for writing a plugin? 00:19:34 does anyone have any questions about the above? 00:19:46 Is this available at the fedorahosted.org/publican repo? 00:19:47 Sparks, that is the plan 00:20:15 stickster, not sure, 00:20:25 The documentation group is writing documentation on their documentation tool. 00:20:29 :) 00:20:44 mhideo: I'll check the site quick 00:21:03 fh.o would probably be a good place to put all the plugins and such. 00:21:37 most of our efforts over the next 2 weeks will revolve around regression testing 00:21:58 mhideo: The last change in "bin/" is 5 months ago 00:22:01 that has been the largest problem so far. we make a change to fix problem X, but it introduces problem Y 00:22:05 mhideo: That can't be right, can it? 00:22:23 stickster, i don't know 00:22:52 all i know at this point is that a QA guy does the regression testing next week sometime 00:22:52 mhideo: I think jsmith said he would be available to help test 00:23:16 a good way to help would be to go through all the publican bugs and write a test case for it 00:23:28 that is what my week will look like 00:24:04 mhideo: Any idea when 1.0 will hit the Fedora repos? 00:25:02 Sparks, that is the hard part, scheduling. i borrow devel time and qa time from folks. 00:25:41 understood 00:26:00 Any other questions? 00:26:17 the above is just fyi, i would proceed with your efforts as previously planned 00:26:36 Okay... Thanks for the update Mike. 00:27:35 Okay... moving on to some F12 talk... 00:27:39 #topic F12 Calendar 00:27:39 #link http://poelstra.fedorapeople.org/schedules/f-12/f-12-docs-tasks.html 00:27:42 #link http://poelstra.fedorapeople.org/schedules/f-12/f-12-docs-and-releng-tasks.html 00:27:46 #link http://poelstra.fedorapeople.org/schedules/f-12/f-12-docs.ics 00:28:07 These are the official calendars for the F12 release. Has everyone looked at them? Any corrections? 00:28:31 * juhp scrolls back 00:28:48 The first item coming down the road is just under four weeks away. 00:29:12 Any questions? 00:29:51 #topic Status on CC license discussion. <--quaid 00:30:03 quaid: You here? 00:30:49 If he shows up later we'll come back to this. 00:30:58 AFAIK everything is on go for the switch... 00:31:14 quaid has been putting the word out and I haven't heard any flak from anyone. 00:31:23 Does anyone have any questions or comments? 00:32:15 #topic Shared open-source style guide <--ke4qqq 00:32:23 #link https://www.redhat.com/archives/fedora-docs-list/2009-June/msg00163.html 00:32:28 ke4qqq: You around? 00:33:15 We'll come back to this topic if he shows up. 00:33:29 #topic Bugzilla Component Changes 00:33:36 #link https://fedoraproject.org/wiki/User:Sparks/BZ_and_Guide_Table 00:34:21 Okay, so all the BZ products on the lower part of that table have been removed from BZ. 00:35:02 All the open tickets were closed as WONTFIX. 00:36:05 I haven't done anything with the "Move to the wiki" guides as stickster had a good idea to not move them to the wiki but just wait for the CMS to come and put them in there for development... 00:36:13 so we don't have to mess with formatting and such. 00:36:21 Any questions or comments? 00:36:48 Sparks: Sorry, was PM'ing with someone else 00:37:51 stickster: Did you have anything? 00:37:54 did anyone check with translation teams about those two at the bottom of the abandon list? They seem to be a still relevent topic unless there is a replacement 00:38:13 yes.. 00:38:19 Not really Sparks -- just saw my name pop up. I agree somewhat with quaid that we don't want to move things twice, or move them in a way that decimates metadata we might want 00:38:21 they said dump them. they are no longer supported. 00:38:38 cool 00:39:01 stickster: Yeah. Valid. Of course I'm having problems locating some of the source... :( 00:39:19 other wise list looks good to me - with the "move to wiki" really meaning "move to place of a more living doc - such as wiki or cms" 00:39:38 laubersm: Yeah, I'll change that. 00:40:17 Sparks: Where? 00:40:22 Sparks: sorry, which source? 00:40:39 * laubersm sees translation quick start in the keep now... 00:40:45 * laubersm is slowly catching up 00:40:57 stickster: For some of the documents we were going to move to the... CMS. 00:42:36 Okay, anything else? 00:42:48 Sparks: Right, I meant which documents are causing you problems 00:43:47 stickster: Oh, I don't remember. I'll look again this week and notate on the page. 00:44:49 Okay... let's move on to everyone's favorite topic... stuff to do! 00:44:55 #topic Outstanding BZ Tickets 00:45:07 link http://tinyurl.com/lbrq84 00:45:07 The link above shows all the tickets that are currently NEW or ASSIGNED for Documentation. Please take a look in there and see if there is a ticket (or two) that you can work on. If so, please assign it to yourself. I'd like for everyone to update their tickets weekly (prefereably on Wednesdays before the meeting) so I can keep track of what needs attention and what doesn't. 00:45:13 Comments or questions? 00:45:16 #link http://tinyurl.com/lbrq84 00:48:00 okay... moving right along... 00:48:09 #topic DocsProject wiki pages changes 00:48:23 ianweller: I won't ask what the status is of the wikibot... 00:48:37 but I will ask about the status of ianbot! 00:48:40 Interesting. 00:48:49 Even though it's zodbot, the command is still #? 00:48:55 s/command/character 00:49:11 So is there still a list of changes that need to happen to the wiki? 00:49:12 ricky: yeah it's cuz meetbot is a snarfer 00:49:15 Sparks: yes. 00:49:19 They must have done some extra-weird stuff to get it that way. 00:49:21 Sparks: they're in fh.o/fedora-wiki 00:50:22 Okay. So can you give us a summary next week of what needs to be done? Maybe we can put a task out on the wiki for a newbie to work on. 00:51:30 * stickster sees that some of those tickets are his and will work on them this weekend 00:52:43 stickster: TU 00:53:23 * jjmcd_ started on some RN tickets but ran into a git wall ... need to get back at that 00:53:50 Okay... moving on... 00:53:57 #topic Release Notes meeting 00:54:39 I sent a message to f-doc-l earlier this week about a Release Notes meeting. Please look at that message and let me know your availability if you want to work on the F12 RNs. 00:54:44 Questions or comments? 00:55:06 I am now free most of thu/fri, wasn't earlier but am now 00:55:30 * Sparks doesn't know if you can go back and change your answers. 00:55:47 me too 00:56:02 jjmcd_: Well, let me know. 00:56:04 Anyone else? 00:56:27 #topic Guide needs? 00:56:35 Does anyone need anything for their guides? 00:57:22 #topic New Guides 00:57:31 Anyone have any ideas for a new guide? 00:57:44 I know that the RPM Guide could use some love. 00:58:59 Anyone want to volunteer to work on the RPM Guide? 00:59:19 I still need to hear from Florian 00:59:23 I'll ping him 00:59:38 i can learn what i need about RPM to work on the guide if nobody who knows what they're doing steps up 00:59:41 Okay. I've added the RPM Guide to the Guide table. 01:00:16 bcotton: The guide already exists but needs to be updated. You might look at what's existing and go from there. 01:00:45 sparks: can do. any guidance on what kind of updates it needs, or just in general? 01:01:01 in general. Not sure when it was last looked at. 01:01:14 bcotton: Get with me after the meeting in #fedora-docs. 01:01:24 Sparks: aye, cap'n 01:01:43 I think it talks about punch card rpms 01:01:56 oooo Those are the good kinds 01:02:05 s/kinds/kind 01:02:44 easier to edit than paper tape 01:02:58 * Sparks likes paper tape 01:03:14 did i bring my X-acto knife for nothing, then? :'( 01:03:52 Well, I'm sure you can figure out some way to use it. 01:04:39 anything else? 01:05:49 #topic Go over task table 01:06:01 I believe all the tasks that are in the task table are now in Bugzilla. I'd like to use Bugzilla for tracking all these items. Opinions? 01:07:17 anyone? 01:07:34 * bcotton feels very neutral 01:07:59 Okay then... 01:08:02 #topic All other business 01:08:11 Anyone have anything? 01:09:35 If not... we'll close... 01:10:28 5 01:10:32 4 01:10:34 3 01:10:37 2 01:10:40 1 01:10:45 Thanks everyone for coming! 01:10:49 #endmeeting 01:12:45 Hmmm... I didn't get the logs... 01:14:03 Sparks: Sorry, I've been off in the weeds. 01:15:11 Sparks: Doesn't the meetbot send those to the right place for you? 01:15:23 What's the right place? 01:16:08 to the chairperson you mean? 01:16:13 I don't think so 01:16:49 no... to a place on the web... somewhere 01:16:57 No, I think they go to some place in nirik's fpeeps space right now 01:17:42 http://www.scrye.com/~kevin/fedora/fedora-meeting/2009/ maybe? 01:17:45 * juhp still wishes (or doesn't understand why not) we could just push the publican fedora-rpm-spec patch to rawhide... 01:17:50 stickster: yup 01:18:04 surprised it didn't appear above 01:18:12 I think it did for me yesterday... 01:18:38 stickster: Yeah... that's where they are... 01:18:51 http://kevin.fedorapeople.org/fedora-meeting 01:19:52 sorry, we were setting up meetbot.fedoraproject.org. 01:20:39 not sure where they went. Will look.