=== Ubugtu [n=bugbot@ubuntu/bot/ubugtu] has joined #ubuntu-doc === jjesse [n=jjesse@ppp-69-214-0-109.dsl.klmzmi.ameritech.net] has joined #ubuntu-doc === ryanakca [n=ryan@ubuntu/member/ryanakca] has joined #ubuntu-doc === jjesse [n=jjesse@ppp-69-214-0-109.dsl.klmzmi.ameritech.net] has joined #ubuntu-doc === mpt [n=mpt@121-72-135-240.dsl.telstraclear.net] has joined #ubuntu-doc === david_corrales [n=david@ip247-10.ct.co.cr] has joined #ubuntu-doc [03:20] what is s.u.c. [03:21] ?? [03:25] I would guess screenshots.ubuntu.com [03:26] screencasts.ubuntu.com rather === david_corrales [n=david@ip247-10.ct.co.cr] has left #ubuntu-doc ["Ex-Chat"] === david_corrales [n=david@ip247-10.ct.co.cr] has joined #ubuntu-doc === iSeriesSysAdm [n=davidvas@64-17-87-28.co.warpdriveonline.com] has joined #ubuntu-doc === mpt [n=mpt@121-72-135-240.dsl.telstraclear.net] has joined #ubuntu-doc === ubuntulog [i=ubuntulo@trider-g7.fabbione.net] has joined #ubuntu-doc === Topic for #ubuntu-doc: Ubuntu Documentation Team http://doc.ubuntu.com or https://wiki.ubuntu.com/DocumentationTeam | Get involved! http://www.mdke.org/?p=67 | backlog at http://people.ubuntu.com/~fabbione/irclogs | SVN - https://docteam.ubuntu.com/repos | Please observe the Ubuntu CoC @ http://www.ubuntu.com/community/conduct | Next meeting: https://wiki.ubuntu.com/DocumentationTeam/MeetingAgenda === Topic (#ubuntu-doc): set by crimsun at Sat Dec 30 01:13:50 2006 === tonyy [n=anthony@ubuntu/member/tonyyarusso] has joined #ubuntu-doc === Madpilot [n=brian@ubuntu/member/madpilot] has joined #ubuntu-doc === tonyy [n=anthony@ubuntu/member/tonyyarusso] has joined #ubuntu-doc === Burgundavia [n=corey@ubuntu/member/burgundavia] has joined #ubuntu-doc [08:28] 3 [08:28] bah === willvdl [n=will@vc-196-207-41-253.3g.vodacom.co.za] has joined #ubuntu-doc === mdke mornings [09:54] mdke: you genius [09:55] ? [09:57] I mean, obviously, but why in particular? [09:57] I'm talking with Revell ATM ;-) [09:57] about? [09:57] MOTU contact? [10:01] mhm [10:02] mdke: "I === mdke boggles [10:04] "I own Matt East a pint :)" === Madpilot read 'pint' as 'joint' - blames his Left Coast upbringing... ;) [10:05] yeah, we are talking Englishmen not Canadians, shesh ;-) [10:06] heh [10:08] tell him I'll waive the pint if he fixes my faq bug === mdke has to run off to work now [10:08] cya === fijam [n=fijam@unaffiliated/fijam] has joined #ubuntu-doc === Gwaihir [n=Gwaihir@mail.foredil.it] has joined #ubuntu-doc === WaterSevenUb [n=WaterSev@azevedo.astro.up.pt] has joined #ubuntu-doc === dgold [n=aiden@dsl-51-63.dsl.netsource.ie] has joined #ubuntu-doc === mpt [n=mpt@121-72-135-240.dsl.telstraclear.net] has joined #ubuntu-doc === Gwaihir [n=Gwaihir@mail.foredil.it] has joined #ubuntu-doc === tuxmaniac [n=aanjhan@unaffiliated/tuxmaniac] has joined #ubuntu-doc === fijam [n=fijam@unaffiliated/fijam] has joined #ubuntu-doc === dsas [n=dean@cpc3-stok6-0-0-cust253.bagu.cable.ntl.com] has joined #ubuntu-doc === tuxmaniac [n=aanjhan@unaffiliated/tuxmaniac] has joined #ubuntu-doc === poningru [n=poningru@n128-227-11-224.xlate.ufl.edu] has joined #ubuntu-doc === medders [n=matt@81.168.72.134] has joined #ubuntu-doc === dsa [n=douglas@extra09.inova.ufmg.br] has joined #ubuntu-doc === somerville32 [n=somervil@ubuntu/member/somerville32] has joined #ubuntu-doc === poningru [n=poningru@n128-227-11-224.xlate.ufl.edu] has joined #ubuntu-doc === poningru [n=poningru@n128-227-11-224.xlate.ufl.edu] has joined #ubuntu-doc === rrittenhouse [n=tad@cpe-76-188-35-66.neo.res.rr.com] has joined #ubuntu-doc === poningru [n=poningru@n128-227-11-224.xlate.ufl.edu] has joined #ubuntu-doc === somerville32 [n=somervil@ubuntu/member/somerville32] has joined #ubuntu-doc === n1c0las [n=nicolas@nicolas.xs4all.nl] has joined #ubuntu-doc === xipietotec [n=jackfros@cpe-67-49-247-144.dc.res.rr.com] has joined #ubuntu-doc [07:56] yo mdke, I'm bemused at your changes to HelpAndSupportAccess [07:56] mpt: ask away. I removed a couple of things that were inaccurate [07:56] iirc [07:58] first, I find it clearer if short adjective phrases use dashes [07:58] For comparison, shows some examples using dashes, some not [07:59] mpt: ok, I'm not going to challenge that [08:00] the other bit in line 13 I removed because it's not true, tooltips appear when the mouse is stationary over the menu item; and you don't have to close and reopen the submenu to get tooltips for different menu items [08:00] oh, I didn't see that change [08:01] line 22 is self explanatory, right? [08:01] https://wiki.ubuntu.com/HelpAndSupportAccess?action=diff [08:01] and line 40 is cosmetic only [08:02] Tooltips appearing when the mouse is stationary over the menu item == requiring scrubbing [08:04] it looks like you need to wait for 1 second on each [08:04] is that a technical term? to be scrubbing involves moving backwards and forwards quickly [08:04] be/me* [08:04] I misunderstood I guess [08:05] like scrubbing the floor [08:05] http://72.14.253.104/search?q=cache:K2_sRkQ6yKQJ:www.drunkenblog.com/drunkenblog-archives/000697.html+%22a+scrubbing+interface%22&hl=en&ct=clnk&cd=1 === somerville32 [n=somervil@ubuntu/member/somerville32] has joined #ubuntu-doc [08:06] so it does mean moving backwards and forwards? [08:07] well, it means that you have to hover over something to see what it is [08:07] so you have to scrub back and forth to find the right thing [08:07] I guess it's not the greatest term [08:07] ok, my bad. Maybe you can readd it without using the word "scrub"? :) [08:08] or I can [08:08] since I removed it :( [08:09] no worries, I'll fix it [08:09] oh, and on a completely different subject [08:21] was "Exit" ever a submenu? [08:22] mpt: not to my knowledge, but it is quite similar to the control center effect now [08:23] ok [08:23] If it had been, that would be relevant [08:23] Otherwise I don't think we should be using the Quit dialog as a good example of anything :-) [08:23] ok === Gwaihir [n=Gwaihir@ppp-126-108.25-151.libero.it] has joined #ubuntu-doc === david_corrales [n=david@ip247-10.ct.co.cr] has joined #ubuntu-doc === stelis [n=se@82-71-4-26.dsl.in-addr.zen.co.uk] has joined #ubuntu-doc === Ubugtu [n=bugbot@ubuntu/bot/ubugtu] has joined #ubuntu-doc === mdke hos and hums [10:11] why? [10:12] thinking about translations [10:12] nixternal: are you here by any chance? === Ubugtu [n=bugbot@ubuntu/bot/ubugtu] has joined #ubuntu-doc === tonyyarusso whispers enchantingly "diaaalllects....diiiaaaalllecccttsss...." [10:15] mdke: I am in class right now, I will be back online at about 2300 UTC [10:16] nixternal: hmm. I ought to go to bed early, I'll try you tomorrow [10:16] or email === david_corrales [n=david@ip247-10.ct.co.cr] has left #ubuntu-doc ["Ex-Chat"] [10:19] email will rock! === jenda [n=jenda@ubuntu/member/jenda] has joined #ubuntu-doc === joachim-n [n=joachim@ACCB8247.ipt.aol.com] has joined #ubuntu-doc [10:47] mdke: is the packaging guide still being shipped? [10:47] LaserJock: I'll look [10:47] not currently [10:48] I tried viewing it yesterday, and it said the link was broken / file didn't exist [10:49] tonyyarusso: being shipped is a different thing to being on the website. Although in this case, perhaps the latter is broken [10:49] mdke: if we keep it that way can I maintian it trunk? [10:49] mdke: I mean in the system help on Feisty. [10:49] i.e. no string freeze for me [10:49] in yelp [10:50] LaserJock: it's up to you. What do you want to do with it? Perhaps we could do a standalone package? [10:50] I was thinking about that [10:50] I'm finding that I really shouldn't make it release specific [10:51] that's ok, but it's nice for people to be able to use it on their system if they want [10:51] yes, so I would propose a seperate package that I release like Debian docs [10:51] tonyyarusso: ok, can you file a bug? you shouldn't have a linK! [10:51] sort of as needed [10:51] I can't find a link to it [10:52] I think if it wasn't tied to the release schedule I could get more contribution when there are slower times for the devs [10:52] mdke: Will do, in a minute. btw, here's the exact text I got when clicking "Running Server Applications": [10:52] The Uniform Resource Identifier file:///usr/share/ubuntu-docs/xml/C/serverguide/serverguide.xml is invalid or does not point to an actual file. [10:52] tonyyarusso: Oh, server? that's fine [10:52] tonyyarusso: file a bug anyway, but we were talking about the packaging guide [10:52] and it would also give me an oppritunity to make it a better online resource [10:53] mdke: Aaah, okay. [10:53] which I think it the most common use for the packaging guide [10:53] mdke: Why is the packaging guide not going to be there now? [10:53] it doesn't really fit in with the rest of the docs, IMO [10:54] tonyyarusso: i'll leave LaserJock to explain, I've got too many damn windows [10:54] :-) [10:54] lol [10:55] tonyyarusso: do you want more? [10:55] LaserJock: sure [10:55] heh [10:55] well, as we are moving to TBH the packaging guide has a hard time fitting in [10:55] and packaging is a rather advanced topic [10:56] I wouldn't mind contributing some little "How to rebuild a source package" topic or something like that [10:56] but as a comprehensive guide to packaging in Ubuntu it just doesn't seem like the appropriate place [10:56] it's more of an online/standalone thing [10:57] the vast majority of packaging guide readers that I've come across read it online or print it out [10:57] even when I mention "it's in the help system" they are like "cool, but I'd rather read it online" [10:58] so while it's kind of a novelty (even mentioned in a magazine review of Ubuntu) it's sort of out of place [10:58] Could it be done such that you could apt-get packaging-guide say and then have it show up in yelp henceforth, for people who want it there? [10:59] I agree it was out of place for most users before - I once had someone read part of that instead of how to use synaptic. (....) [10:59] I'd rather not have to read things online, since I might want to while I don't have a connection. [11:02] yes, that's how I plan on doing it I think is a seperate package [11:02] we'll do that with the server guide too [11:02] but I think the focus should be on online/print presentation [11:02] tonyyarusso: we can't include it in the yelp table of contents easily [11:02] mdke: dang [11:03] it seems to be hard to do well with both "system help" and "online help" [11:03] mdke: Separate help menu entry? [11:03] I hope not === poningru [n=poningru@adsl-074-245-140-197.sip.gnv.bellsouth.net] has joined #ubuntu-doc [11:04] for now can't it go under "other documentation"? [11:04] Only if you installed it of course, not defaults. Just picturing how this might end up looking for me. [11:04] there won't be an "other documentation" [11:04] I don't have an "other" [11:05] mdke: where will that stuff go? === mdke points at the ether [11:05] Meanwhile, I question arranging yelp alphabetically. Shouldn't "New to Ubuntu?" be higher up? [11:05] it'll be searchable, and the relevant ones will hopefully be linked from relevant pages [11:06] tonyyarusso: that's just a temporary thing. We have an order in mind [11:06] so useful documentation will be installed on the user's computer but they won't be able to see it? [11:06] ah, good [11:06] sometimes yelp is just ... frustrating [11:06] LaserJock: define useful [11:06] installed [11:06] you mean Gnome documentation XSLT Manual? [11:06] or Linux NAT Howto? [11:07] right now I have CUPs, gai, synaptic and those yeah [11:07] my point being, they might not be what we want to present to the user right away [11:07] right, so those useful ones can be linked [11:07] but surely it should be discoverable [11:07] probably not cups actually [11:08] well, that's sad, but not your fault [11:08] well, it's my fault in that I'm totally behind choosing to get rid of it === poningru [n=poningru@adsl-074-245-140-197.sip.gnv.bellsouth.net] has joined #ubuntu-doc [11:08] well, I think it's kinda bad form to go getting rid of docs that authors have put a lot of time into [11:09] just because they aren't "our" docs [11:09] LaserJock: no offense, but Linux NAT Howto is not desktop help === Ubugtu [n=bugbot@ubuntu/bot/ubugtu] has joined #ubuntu-doc [11:09] who cares if it's desktop help [11:09] it's probably great, but it's not going to help our users much [11:09] "desktop" help isn't the only help [11:09] Shouldn't we be able to read things that aren't desktop help in a more friendly form than with less? [11:09] just as desktop packages aren't the only packages on a machine [11:09] you can read em, just open them with yelp [11:10] or search for them [11:10] name me one person that has opened their help system and gone "oh wow, Linux Nat Howto, I'll read that in the help system, because it's probably right up to date with the online version" [11:10] that seems odd though. Normally you'd at least be able to make some sort of crapbin section to stuff them into [11:10] I do that! [11:10] that's the only reason I use the help [11:10] LaserJock: you've got some issues [11:11] go read the online version, it's much more likely to be up tod ate [11:11] because the stuff we ship is pretty trivial [11:11] anyway, we need to take care of people who can't find the help first [11:11] it's important for user for sure [11:11] I can't, but I can name myself as someone who's read docs in less or Firefox, and said dang I wish this were prettier and/or accessible offline [11:11] mdke: I agree [11:11] people like you guys can type "linux nat" into the help box [11:11] Four and a half months of the year I am _unable_ to read documentation online. It wouldn't be fair to my family. [11:12] actually I just surf around for that stuff [11:12] I don't use the search box [11:12] but maybe that's my problem :-) [11:13] Usually I only use search boxes if I don't really know what I want. I'm used to being able to just find it. If I have to search, it usually means something bad, either on my end or the docs'/site's [11:13] anyway, I know where you are coming from mdke [11:14] hope so [11:14] the current view in that sidebar is not so great === Ubugtu [n=bugbot@ubuntu/bot/ubugtu] has joined #ubuntu-doc [11:14] you'll like it when you see it [11:14] I just feel like we are pushing down the software authors to achieve our goals [11:14] Yeah, I do too - I just think it's one step too far. I _should_ be tucked away somewhat, so it doesn't provide clutter / confusion for most users, but should still be available in a submenu or something for convenience, imo. [11:14] like there should be a "see all documentation" button or something [11:16] mdke: well, I comes down to I trust you. :-) === mdke phews === mdke passes the blame onto mpt [11:17] I have my reservations, but I trust that you ( and mpt too) know more about what our users need than me [11:18] we could make an "advanced documentation" topic which links the users to the GNU Info/Man pages and your precious Linux Nat Howto, I guess [11:18] i would consider it a bad idea though, myself [11:18] Why? [11:19] because the newer users would click on it hoping for inspiration, and would get gibberish [11:19] well, I think the search thing will eventually be the way to go anyway [11:19] people who don't really know what to search for will need guidance [11:19] What new user clicks something labelled "Advanced"? Most get scared and run away. [11:19] they all click it :-) [11:20] people are curious [11:20] tonyyarusso: no, I disagree, it sounds like it means you can do cool things. Also, even a user who has mastered the rest of the topics is going to be put off by man pages [11:20] hmm [11:20] Is there another word we could use? [11:20] but it does seem like we could use some middle ground [11:20] tonyyarusso: "DON'T CLICK" [11:20] "Utterly terrifying hacker-speek!" [11:20] LaserJock: the middle ground is the search [11:21] does the search give any preference for doc names? [11:21] but Linux is trying to reach the world of real computer users, and I think we should too. The days of providing power linux users with man pages is in the past, at least for Ubuntu, IMHO [11:22] Now that's where I lose you. [11:22] Absolutely we should be reaching out to less experienced users. [11:22] But why does that mean we have to tell the experienced linux users to shut up and use Gentoo instead? [11:22] because they are 0.01% of the market? [11:22] maybe less [11:23] anyway, that's not what we're telling them to do [11:23] So? We don't actually lose anything by it. [11:23] gentoo users don't use Yelp for reading man pages either, they type "man whatever", like Ubuntu power linux users [11:23] It seems like it, if you start removing options from the documentation. [11:23] we are saying "we think you are smart enough to use the search" :-) [11:23] tonyyarusso: we do lose something by it, we lose a help system that is nice for the 99.9%, like other operating systems will do [11:24] man and info pages are written almost to assume you already know the tool and just need a reminder of what switches are there [11:24] mdke: Even by hiding it away? [11:24] they are very bad a telling you things like: I want to do X or Y [11:24] yes, but there is a lot of stuff besided man and info pages in there though [11:24] mdke, oh, *now* you're warming to "Advanced topics" :-P [11:24] I think the man and info shoudl could go, I really do [11:24] mpt: no, I was trying to placate the onslaught [11:24] :-) [11:25] in which I think one of the subsections should be "Reference manuals (man)" [11:25] mpt: anyway, your advanced topics is not the sort of thing they're talking about [11:25] it doesn't even mention Linux NAT Howto [11:26] or Gnome Documentation XSLT Reference Manual [11:26] I know there is some really useful documentation in there and I think it's a shame to take that away from people [11:26] I don't know what a NAT is, except that it's something to do with networking and IP addresses [11:26] but, I think the search function is probably a good middle ground there [11:26] I'm sure it's important, because Ekiga screams at me about it during setup [11:26] mpt: oh, then it *must* be important :) [11:26] :-P [11:27] Actually, what I'd love === mdke leaves mpt to LaserJock and tonyyarusso [11:27] is for mdz to come along and say "the documentation is allowed to take up X MB on the CD, and no more" [11:28] maybe [11:28] Then once we'd reached that limit, for each new thing we'd have to discuss whether it was more helpful than something we were already including [11:28] I'd almost rather see the documentation not installed than it not be discoverable [11:28] mpt: For the things we're talking about I don't think it matters what's on the CD. I'm happy to apt-get docs, I just want them easily accessible once I do. [11:28] mpt: most of the least useful documentation is installed with packages that are essential parts of the system [11:28] tonyyarusso: exactly [11:29] mdke, yes [11:29] but we can fix that [11:29] the GDP takes patches :-) [11:29] eventually [11:29] but gnome is not everything [11:29] Have they been slow in your experience? (I haven't tried, tbh) [11:30] nah, they're good [11:30] as tonyyarusso has brought up, we have lots and lots of packages in Universe with documentation [11:30] LaserJock: most of it isn't in Yelp though [11:30] a fair amount is [11:30] and I think more should be [11:30] LaserJock, if a package is graphical, it should have a Help menu/button that loads the help [11:31] well, if mallard happens then there will likely be a good way to integrate it [11:31] And if it's not, it should have a man page (which yelp should automatically pick up in the aforementioned "Reference manuals" section) [11:31] mpt: but we ship a lot of stuff that is neither [11:31] dive into python [11:31] debian policy [11:32] gtk tutorial [11:32] etc. [11:32] Dive Into Python, I would put in "Advanced topics" > "Writing your own programs" [11:32] it just seems a waste to have documentation available but not be able to get at it reasonably easily [11:32] same for gtk tutorial [11:32] mpt: you can't. [11:32] Debian policy, wtf are we doing shipping that? [11:32] the link will be broken if the package isn't installed [11:32] ah [11:32] mpt: heh, it's required for every package [11:33] hence the crapbin "Other DocumentatioN" that yelp uses [11:33] mpt: That would be lovely if there were those sections in yelp. [11:33] well, let me rephrase that [11:33] unless we create a new scrollkeeper category and amend all those packages to go into it [11:33] No way to update yelp links based on installed packages? Or, even better, make it like discussed for file formats - if the link is broken it prompts you to install the package? [11:33] every package conforms to a specific version fo the Debian Policy [11:33] so we should provide what that policy is [11:33] oh, actually, there is x-yelp-toc:#ApplicationsProgramming [11:33] mpt: ^^ [11:34] my bad [11:34] ok, let's do your sodding Advanced Topics [11:34] you think the server stuff should be hidden in there? [11:35] yep [11:35] that'll be tricky [11:35] unless it's a single entry [11:36] I almost think we'll have to do it mdke's way while we are still trapped with yelp [11:36] it seems aweful to try to mess around with it [11:36] I'm starting to come round to this advanced topics thing [11:36] :-) [11:37] I think I'm going to stay out of it [11:37] but I don't think "Other Documentation" can go in there, we can do programming stuff, GNU info, man pages and such. [11:38] all the other categories can be linked from other topics, like x-yelp-toc:#ApplicationsMultimedia and stuff [11:38] where will Desktop and Applications items go? === mdke points at his last sentence === LaserJock points out his confusion [11:40] what do you mean by other topics? [11:40] the ones we have already [11:40] but there is more in there than what we have [11:40] suggestions welcome [11:40] so for example, where does Applications -> Scientific go? [11:40] let's just make 400 topics [11:41] no, no, I'm just trying to figure out the system [11:41] if it doesn't have a specific link it will get dropped out of TOC [11:41] four hundred BILLION topics! [11:41] and just be available as via search? [11:41] LaserJock: we've already done that to some of our own docs [11:42] but that's the way it will go, trying to confirm my understanding, not pick a fight ;-) [11:43] pending any better ideas [11:43] ok, well I'm fairly ok with it [11:44] a lot of those sections are pretty empty anyway, search is probably more effective than trying to hunt down which section things are under === LaserJock returns everyone to their regularlly scheduled programs [11:46] ;-) === tonyyarusso [n=anthony@ubuntu/member/tonyyarusso] has joined #ubuntu-doc === stelis [n=se@82-71-4-26.dsl.in-addr.zen.co.uk] has left #ubuntu-doc [] === mpt [n=mpt@121-72-135-240.dsl.telstraclear.net] has joined #ubuntu-doc