From eric at christensenplace.us Wed Dec 2 23:13:28 2009 From: eric at christensenplace.us (Eric Christensen) Date: Wed, 02 Dec 2009 18:13:28 -0500 Subject: Fedora Docs Meeting Reminder Message-ID: <4B16F498.8020201@christensenplace.us> -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 REMINDER: There will be a Fedora Docs Meeting today at 0001 UTC. The agenda can be found at: http://fedoraproject.org/wiki/Docs_Project_meetings#Agenda_for_Next_Meeting -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.10 (GNU/Linux) Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org/ iEYEARECAAYFAksW9JcACgkQfQTSQL0MFMFz6QCggFX+HW/W/qF00aLKzKQKHonS 8bsAoLS1IUNFCyMTKVYhi6J0HqcwdYNv =zGhX -----END PGP SIGNATURE----- From eric at christensenplace.us Thu Dec 3 04:35:19 2009 From: eric at christensenplace.us (Eric Christensen) Date: Wed, 02 Dec 2009 23:35:19 -0500 Subject: Docs Meeting 2009-12-03 IRC log Message-ID: <4B174007.4050500@christensenplace.us> -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 00:00:29 #startmeeting Docs Project Meeting - Agenda: http://fedoraproject.org/wiki/Docs_Project_meetings 00:00:29 Meeting started Thu Dec 3 00:00:29 2009 UTC. The chair is Sparks. Information about MeetBot at http://wiki.debian.org/MeetBot. 00:00:30 Useful Commands: #action #agreed #halp #info #idea #link #topic. 00:00:35 #topic Roll Call 00:00:36 * Sparks 00:00:41 * danielsmw 00:00:53 * jjmcd . 00:01:03 * bcotton is here 00:01:21 * ianweller 00:02:05 Wow! Lots of people here tonight! 00:02:33 Mssr. Landmann indicated he was swamped today so I'm not sure we'll see him 00:02:45 wow it's like every party i've ever hosted 00:03:16 jjmcd: Figures... just when we have complaints on his work... :) 00:03:25 heh 00:04:49 speak of the devil 00:04:50 Hey look 00:05:25 Okay, let's get started 00:05:42 #topic Docs Project Leader Elections 00:06:03 #link https://fedoraproject.org/wiki/Docs_Project_Leader_Elections 00:06:28 So would anyone else like to nominate anyone to head up this awesome project? 00:07:05 I heard a rumor about ianweller 00:07:11 somewhere 00:07:14 jjmcd: You know, I heard that too 00:07:21 i'm honored but i have zero time 00:07:26 it's my senior year in high school :P 00:07:27 must not be a rumor anymore if more than me heard it 00:07:40 * Sparks thought the senior year was the slack off year 00:07:42 Well, at least it's non-negative like the rest of us 00:08:02 * danielsmw confirms Sparks assertion 00:08:03 heh 00:08:54 :) 00:08:59 i would slack off but my extra curriculars are insane 00:09:04 Okay so am I the only one up for this job? 00:09:18 I think so 00:09:19 *nod* 00:09:20 * Sparks thinks ianweller will have some other kind of excuse for next year 00:09:33 Seems to say not too many are upset with the job you are doing 00:09:57 Okay... all in favor of continuing to have me head this monster up. 00:10:04 +1 00:10:09 +1 00:10:10 +1 00:10:10 +1 00:10:28 unless you really don't want it :P 00:11:05 and then what? 00:11:13 then we're headless. 00:11:20 give it back to stickster 00:11:23 we're close to that now 00:11:29 where is stickster_afk anyway? 00:11:38 he's afk... 00:11:44 :) 00:11:45 I think he is still vacationing 00:11:47 okay... so I guess I'm hired on for another year. 00:11:54 jjmcd: no, he's been back 00:12:05 #action Sparks to remain Docs Leader for another year. 00:12:09 Didn't he tweet like he had a couple more days he was going to try to play with the kids 00:12:30 ya 00:15:56 So Sparks is steeling himself with another brandy 00:16:29 jjmcd: SPC just issued a PDS for NC where my folks lived. Had to give them a call. 00:16:39 Okay... well thanks for the vote of support... I think. 00:16:55 just days before SRD, too 00:17:29 * Sparks makes a note to talk to stickster_afk about his pay raise now that he's tenured. 00:17:50 #topic Release Notes 00:18:05 jjmcd: So you want to talk about Yelp v. HTML 00:18:07 I bet he would go for a 10% hike if you ask nice 00:18:14 Yeah, here's the deal 00:18:22 We currently use yelp to display RNs 00:18:42 This gives us automatic language selection and integration with the rest of gnome help 00:18:59 yelp has some limits, tho, and it doesn't help our KDE users 00:19:23 Jeff Fearn suggested some javascript so we could get the lang selection in html 00:19:50 I had to fix his script, but it does work. We can get automatic language selection of RNs in both Gnome and KDE 00:20:05 Downside is that it is no longer integrated with the rest of help 00:20:25 Upsides it gets us KDE and gets away from some yelp clumsiness. 00:21:00 jjmcd: Should we also discuss what shaunm (from GNOME) said? 00:21:00 I wanted to get peoples thoughts on that .. basically a separate menu choice under Documentation for RNs, under System in KDE 00:21:07 Yes, 00:21:44 shaunm indicated that the current langiage selection scheme in yelp will be changed, and we might be able to integrate html too, in yelp 3.0 00:21:50 but I have no idea the timeline 00:22:12 jjmcd: He also wants to have a meeting in March to discuss documentation... 00:22:26 so this might be a way to have a single file go into GNOME and KDE similarly. 00:22:44 Of course, we have no idea what the Publican/Yelp issues are in the new scheme. And yes, he wants to get together to get something that may be even more cool 00:22:59 I'm going to speculate here... there may be fixes coming soon in Yelp that may fix some of the problems we've seen recently. 00:23:15 and then there is the idea that abadger1999 had 00:23:19 With the html, the only thing we add for KDE is a .desktop file 00:23:26 which was 00:23:36 which is to provide a separate, non-packaging means, to getting documentation to the desktop 00:23:51 probably through PackageKit 00:24:07 Oh yeah. I got to admit I saw that as something a little far out, but certainly we ought to explore it. 00:24:14 (Note: my idea will need coding work to see the light of day) 00:24:37 At this point it is hard to see what we might get that would go beyond rpm that would be useful 00:24:48 But then I'm an old fogey with limited imagination 00:24:56 abadger1999: Ya... but definitely worth mentioning! 00:25:21 * Sparks whacks jjmcd with an imagination stick 00:25:27 Sparks, is there any reason why we can't use RPMs? 00:25:27 Some time back we talked abuot a separate rpm repo because we might want to have a LOT of packages 00:25:51 FWIW, in RHEL, we add a .desktop file for GNOME too 00:26:03 Tsagadai-netbook: There are some issues to using RPMs... and two ways to package the languages... and pros and cons for eac 00:26:13 s/eac/each 00:26:17 Tsagadai-netbook, I think the discussion was that if we looked specifically at content, there might be additional useful functionality 00:26:27 Which is, I guess, RHEL's way of getting around the "no longer integrated with the rest of help" issue 00:26:57 (whether stand-alone documentation belongs in help is a different (and religious!) question) 00:27:15 rudi, I agree that one might make the argument either way 00:27:34 I am always concerned when I talk about changing how things look to the user 00:28:19 Personally, I would like to see the guides in yelp, too. But I don't want to write all the .omf's 00:28:31 I, personally, would like to get everyone in the know in a room together and hash out this entire issue 00:29:03 Sparks -- with pointy sticks? 00:29:04 Second choice would be a doc menu with the Jeff language solution (and smarter ,.desktop files for the guides) 00:29:38 rudi: pointy sticks not required. There are so many ideas it's hard to get them all out asyncronously or via IRC 00:30:06 Well, if we do it in yelp I think we should also do it in khelpcenter, and I'm not so sure I want to do that, either 00:31:05 Sparks, you got that right. What we need is some sort of web page where everyone could put their ideas 00:31:11 I'm still working on a proof-of-concept package for the Install Guide to see whether Yelp can render a doc of that size and complexity at all 00:31:20 Anyone know when the next FUDCon NA will be? 00:31:29 hmmmm 00:31:33 jjmcd: Like... ummm... a wiki? 00:31:44 Maybe something like that, yeah 00:31:50 does yelp == khelpcenter? 00:32:02 functionally similar 00:32:13 same file types? 00:32:24 WHAT? Are you nuts? 00:32:26 errr 00:32:40 Can I take the same file and have each render the file similarly? 00:33:05 I'm guessing not 00:33:09 Acually, I think khelpcenter is looking for html, yelp wants xml 00:33:11 which goes on my shopping list for March 00:34:08 So are you going to come to chi in march? 00:34:26 Still pretty cold in the windy city 00:34:31 jjmcd: If I must. I think I can take the train for <$180 00:34:51 how many days? 00:35:17 1 00:35:27 ish 00:35:31 surprised, I figgered it would be 3 00:35:35 nah 00:35:46 it's a short(er) trip 00:36:34 Of course I haven't received my official invitation or found a golden ticket in a candy bar, yet 00:37:03 IMO, we need to be working with Yelp upstream to see what's coming down. 00:37:12 shaunm didn't say exactly where yet, either 00:37:28 If it's going to be a complete drag then we can go with html on the desktop 00:37:46 I would hope something close to ORD 00:37:58 With Jeff's code the HTML isn't all that awful 00:38:00 but if we could integrate better into Yelp and khelpcenter then I feel that it might be better that way. Just my opinion, though 00:38:10 I agree with that 00:38:47 Some people don't like that with yelp you get yelp's rendering, rather than playing with your own stylesheets 00:38:54 But as far as I'm concerned, its one less thing to mess with 00:40:04 Yelp helps with accessibility, though 00:40:28 yep 00:40:51 Sparks, if you have a travel budget I'll happily come and visit :) 00:40:51 rudi: Are you in cahoots with khelpcenter upstream? 00:41:05 Sparks, no 00:41:19 Tsagadai-netbook: A travel budget? Yeah, it's 10% of whatever stickster_afk pays me 00:41:22 But I *can* confirm that the help docs are in html 00:41:30 Tsagadai-netbook: not sure you can get very far on that, though 00:41:43 Just looking at them now in /usr/share/doc/HTML/ 00:42:10 rudi: cool. It'd be nice if both were using the same format 00:42:24 maybe we should get both to implement the other format they aren't supporting 00:42:41 Agreed. GNOME should just fork HelpCenter 00:43:11 I was joking :) 00:43:17 Tsagadai-netbook: :) 00:43:24 Tsagadai-netbook: You can still come, though 00:43:34 It is interesting. Yelp is more appealing because the index doesn't point to hundreds of help files. For some reason, KDE seems to insist on a manual even if its empty 00:43:37 I intend to at some stage 00:43:50 * rudi would love to get to one too :) 00:43:59 * Tsagadai-netbook has not been to that continent yet :) 00:44:17 * jjmcd hasn't been to rudi's continent 00:44:35 * Sparks wants to visit AU 00:44:42 but is scared he might stay 00:45:00 Okay... just to recap 00:45:04 been to europe and asia but hasn't yet been to any of those upside-down continents 00:45:32 Plan A is to work with upstream Yelp and possibly khelpcenter to work out the issues we are having 00:45:40 Plan B is to just put HTML on the desktop 00:45:43 is there a Plan C? 00:45:55 I'd say plan B is better :) 00:46:05 we know browsers work 00:46:07 Well, providing for khelpcenter IS html for now 00:46:21 Tsagadai-netbook, we had serious doubts this morning 00:46:30 We should also find out what Xfce uses 00:46:35 jjmcd, about browsers? 00:46:39 And based on Jeff's recent comment to my bug, maybe still 00:46:39 yeah and Sugar 00:46:48 Since that seems to be getting some traction 00:46:52 Tsagadai-netbook, yeah 00:46:55 Moblin doesn't have working help on fedora :) 00:47:14 so we can skip it for now :) 00:47:35 LXDE? 00:47:42 jjmcd, I missed the "morning" discussion. What's wrong with browsers? 00:48:24 We were having inconsistencies in detecting the language browser to browser. Sounds like it is still a problem on RHEL, but for Fedora I think I have a workaround 00:49:00 Still have quite a few to test, tho. Certainly we will fail on Mosaic and Dillo and probably others 00:49:25 Tsagadai-netbook, we have like a dozen browsers on Fedora 00:49:41 jjmcd, do we need to support the obscure ones? 00:49:57 or just file bugs with the projects that they don't display properly 00:50:13 Well, if someone chooses Dillo as their default I can't say I have a lot of sympathy for them 00:50:28 * Tsagadai-netbook notes there are a dozen browsers on fedora but they all have a marketshare smaller than IE4 00:50:34 But Mosaic, heck, that is THE classic 00:50:48 works on elinks and lynx 00:50:56 what more could people want? 00:51:18 Well, Jeff wasn't very receptive to making lynx work on rhel 00:51:52 see BZ#538159 00:52:05 .bug 538159 00:52:07 Bug https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=538159 low, low, - ---, jfearn, NEW, Publican should package multiple languages 00:52:07 Sparks: Bug 538159 Publican should package multiple languages - https://bugzilla.redhat.com/show_bug.cgi?id=538159 00:52:08 Bug 538159: low, low, ---, jfearn, NEW, Publican should package multiple languages 00:52:21 #link https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=538159 00:52:23 Bug 538159: low, low, ---, jfearn, NEW, Publican should package multiple languages 00:53:01 doh! 00:53:25 bugbot, zodbot, these computers are taking over 00:53:50 jjmcd: Is there a standard for rendering languages like what we're asking it to do? 00:54:14 If there is and they aren't meeting it then we can file bugs against those browsers for it. 00:54:26 It seems like the issue is around the DOM and how it interacts with JS. Every browser interprets JS differently 00:54:49 I haven't even attempted IE, I be that will be a whole new experience 00:55:16 * Sparks doesn't like js 00:55:23 But since I am looking at Fedora help menu items, I don't think IE will be a big issue 00:55:31 nor I, Sparks 00:56:03 But I bet if I said