[12:07] me, myself and my shadow? [12:07] evening [12:07] <-- Martin Meredith [12:07] so what meeting is this? [12:07] <-- robert stoffers === Mez [~Mez@cpc2-lich4-3-0-cust115.brhm.cable.ntl.com] has left #ubuntu-meeting [] === Mez [~Mez@cpc2-lich4-3-0-cust115.brhm.cable.ntl.com] has joined #ubuntu-meeting [12:07] oh, Doc team :D [12:07] this is the documentation meeting [12:07] ok all, agenda: https://wiki.ubuntu.com/DocteamMeetingAgenda [12:08] by Member Introductions I presume he means new members? [12:08] introduce yourself rob^!! === rob^ = [12:09] Ok, I'm an Australian, 23 and made the switch to Ubuntu about 2 months ago [12:09] welcome :) [12:09] a related matter is how on earth are we going to get rob^ and mgalvin commit access? [12:09] I'm an ex-Debian user, but like Ubuntu for its regular release schedule and up-to-date packages [12:10] and the fact it has apt-get :) [12:10] welcome, rob! [12:10] rob^, what do you envisage working on in the docteam? (we know the answer, but just in case you have more plans...) [12:11] The faq guide takes my fancy at the moment, but time will tell I guess [12:11] cool [12:11] I'm cycling onto shiftwork soon, so I'll actually be getting *paid* to write :) [12:11] awesome! [12:12] getting paid, what is that? [12:12] anyone have any ideas re: commit access? [12:12] i have spoken to henrik [12:12] we have bugged elmo [12:12] nothing better to do, I have already worn out one xbox controler [12:12] what more can we do? === venda pinged mdz === mdke nods [12:13] i guess we just have to wait for debconf to end :-( [12:13] guess so [12:13] not good, considering the 48 hour undertaking we were given previously [12:13] sorry rob^ :( [12:13] we're trying our best! [12:13] yeah I know [12:14] it has been more than 48hrs that is for sure [12:14] oh did I mention I did a little work for the KDE docteam? I even won a prize which never turned up [12:14] o.o [12:14] rob^: what was the prize? [12:14] cool [12:14] venda! [12:14] lol @ Riddell's highlights [12:14] umm I think it was a t-shirt [12:15] mdke: hay, I was watching this anyway :) [12:15] rob^: want me to hassle someone? [12:15] don't disillusion me! [12:15] mdke, you wont belive how many ppl watch ;) [12:15] argh [12:15] Riddell, go for it, it was a long time ago [12:15] ogra, :) [12:15] though [12:15] mdke: It's true. =) [12:16] lol [12:16] that's really cool [12:16] we want to promote awareness of our activities in the community [12:16] next agenda item? [12:16] any more for the first one? [12:16] I'm good [12:16] mgalvin isn't here so he can introduce himself another time [12:17] nope, AIs next [12:17] AGENDA ITEM: Follow-up on ARs (Action Required) from previous meeting (see DocumentationTeamMeetingSummary6) [12:17] hmm [12:18] which documents have/have not got specs? [12:18] the ubuntu userguide doesn't have one to my knowledge [12:18] I did kquickguide spec [12:18] cool [12:19] does the faq? I dont remember seeing one [12:19] no time:-( [12:19] hehe [12:19] just plodding on kubuntu-docs [12:19] its only a paragraph that's required really [12:19] https://wiki.ubuntu.com/StyleGuide [12:20] I will do one for the Ubuntu userguide [12:20] K [12:20] following jeffsch example on style guide makes it go quick, really [12:20] (although in parenthesis I should say that the two guys who are taking charge of the userguide have not done anything yet) === venda nods [12:21] we can come onto that later [12:21] what else is action required? [12:21] re: shipping in HTML [12:21] think that was decided [12:21] i spoke to mdz about that at the edubuntu summit [12:22] he said that there was probably no need to go through the TB for that [12:22] so that box can be ticked [12:22] judax, yeah === venda smiles [12:22] mdke, I know the qandaset the faq uses doesnt display at all using yelp [12:22] html may be the only option for it === jsgotangco [~jgotangco@202.57.71.236] has joined #ubuntu-meeting [12:23] rob^, yeah the decision to ship html was taken, it was just a question of informing -devel [12:23] rob^: correct [12:23] ah good [12:23] sorry i arrived so late [12:23] ok we can move on [12:23] morning jsgotangco [12:23] what else is Action Required? [12:23] docteam.ubuntu.com? [12:23] yeah [12:23] apparently the servers are being sorted this week === venda sighs [12:23] henrik said we should have it by next week [12:24] i wouldn't count on it, but that is good news anyhow [12:24] next year more like [12:24] oy [12:24] just tell it as it is :-) [12:24] optimism = good [12:25] anyhow, as everyone knows, we have found some decent temporary solutions, thanks for the kubuntu team and tseng [12:25] better order help.ubuntu.com early [12:25] agreed [12:25] ask elmo? === rob^ nods [12:25] ha [12:25] ok is "jdub's suggestion on existing documentation already in the distro" an ActionRequired? [12:26] well i've started on it actually [12:26] cool [12:26] but im stumped on some things like sk [12:26] i won't be able to do it on my own [12:26] i think we need guidance from jdub on it [12:26] its way bit too complicated on my current skill set === Burgundavia [~corey@S0106000000cc07fc.gv.shawcable.net] has joined #ubuntu-meeting [12:27] good timing [12:27] wb [12:27] well not just jdub imo, anyone who is involved in creating the catalog as well [12:27] sorry should have highlighted you when you first came in [12:27] jsgotangco: what is sk? [12:27] scrollkeeper [12:27] just joined, breezy and X currently are having issues [12:28] ah [12:28] Burgundavia, ;) [12:28] ok so what do you propose we do jsgotangco ? [12:28] hmm, what existing docs are we speaking about [12:28] that and im in the middle of an Oracle contract, so it kinda got stuck for a while [12:28] gnome docs [12:28] kde docs [12:28] manpages [12:28] debian docs [12:29] etc. etc. [12:29] personally, not want I want to be doing [12:29] or I would be upstream [12:29] dont mind using upstream [12:29] indeed IMO its an upstream issue really [12:29] and if can push up [12:29] its just a question of making upstream docs appear in ubuntu [12:30] but to tackle upstream docs is not want I want to be doing [12:30] not necessarily changing them or improving them [12:30] just harnassing them [12:30] mdke: they do already [12:30] venda, all? [12:30] well in kubuntu they do [12:30] nice kde docs [12:30] that's cool [12:30] there's still stuff not included from /usr/share/docs that doesn't appear in sk at all [12:30] aye, but there was a component of using upstream content in our docs === venda hugs konqi [12:30] jsgotangco, yep [12:30] and there's a mix of xml and html [12:31] so its not consistent either [12:31] i suggest we stress jdub for an action plan on this [12:31] it was his idea after all ;) [12:31] i guess i would have to shorten my goal on just making a catalog on it for now [12:31] jsgotangco: sk is a borked system [12:31] venda: very [12:32] jsgotangco: I don't thing one really needs such a dependancy in the docs [12:32] adds another layer agreed, but that's what we have for now === venda shuts up before he upsets somebody [12:33] ok how are we gonna leave this? [12:33] its still open [12:33] it won't really go further without a developer's help [12:33] well the only remaining idea I have is what I've already said: stress jdub for an action plan [12:33] mdke: why are we forking upstream docs [12:33] venda, we are not [12:33] venda: not forking [12:34] if we dont then we may aswell all move upstream [12:34] they're not 'forked' [12:34] venda, the suggestion is simply that we make things in /usr/share/doc appear in yelp. Not changing or forking them, or even moving them [12:34] start looking upstream to see if we can integrate better (by shipping docbook, translating source documentation formats, etc) [12:34] Hmm we do that already [12:34] judax: right, incidentally not all docs in that folder are in source === rob^ tries to remember where he saw something like this before [12:35] well i have no more ideas on this subject [12:35] jsgotangco: ok [12:35] basically the bulk of work is diving in and looking what is there [12:35] chaps its not our task to make everyone elses docs appear in sk [12:35] the mainters should do that [12:35] venda, the proposal was whether we are going to make it our task, discussed at the previous meeting === venda gets the feeling that we are trying to fix all the worlds problems [12:36] right its a GNOME thing at the moment [12:36] the problem is upstream [12:36] file a bug [12:36] if you want [12:36] its someting that the whole team should not get involved with imo [12:36] =1 [12:36] +1 [12:36] but people are freeto do it anyway [12:36] thats why im doing it [12:36] can stop them [12:37] ok let's move on then [12:37] there is a fair few man pages appering in yelp already [12:37] yeah some do === rob^ had a look [12:37] even fedora and rhel don't even fix this [12:37] thats why their pages are in html [12:37] any more items that are Action Required from previous meeting, or can we move onto the next agenda item? [12:37] anyway, its a totally different story so let's move on [12:37] jah man pages and info are best at the prompt [12:38] venda, i tend to agree. let's move on [12:38] ok AGENDA ITEM: "Author updates on DocteamProjects" [12:38] me me! [12:38] shall we go through em one by one? [12:38] well ok basically let's just have people talk about the status of their work === rob^ jumps === judax points to rob [12:39] rob^, sup [12:39] GO ROB!!! [12:39] Well, I need to be added to that page :) [12:39] rob^, you need to add yourself as lead on the projects btw [12:39] heh [12:39] syke [12:40] rob^: are you only doing gnome [12:40] I think the Ubuntu version is comming along and may even be ready for Breezy, but there is very little content for Kubuntu [12:40] or do you give some kde love [12:40] venda, yes at this stage [12:40] is there a kde version of the original ubuntuguide that could be harnassed? [12:40] yes [12:40] KUDOS [12:41] that will help right? [12:41] rob^: kubuntu faq? [12:41] http://kudos.berlios.de/ [12:41] ubuntuguide, but for kubuntu [12:41] we have permission to port it [12:41] yes, read that last night [12:41] rob^, any plans for that? [12:41] venda, rock [12:41] just needs a person to do it [12:41] I started [12:41] well, I was thinking we could add a lot of stuff from there for the kde profile in the faq [12:42] but too much going on [12:42] rob^: its can be ported we talked to the original author already and gave permission [12:42] good [12:42] rob^, well if you and mgalvin feel you can take it on, that would be supercool [12:42] I also noticed the licence was compatible too [12:42] rob^: that was the idea [12:42] I will speak to mgalvin, but I cant see why not [12:42] rob^: the author released it to us under terms of the docteam licenses === judax thinks rob has the job [12:42] rock [12:42] nice one [12:42] it might not be ready for breezy though [12:43] rob^, just do what you can :) [12:43] if kfaq is good can package [12:43] yeah :) [12:43] ok next project [12:43] styleguide [12:43] jeffsch ain't here [12:43] jury duty [12:43] ubuntu quickguide? jsgotangco [12:43] well i started on international.xml already [12:43] venda, really? ;) [12:43] poor bugger [12:44] i hope he doesn't get like a 6 month case [12:44] Colony 2 won't run well on my side so i haven' [12:44] t even started it [12:44] nah back friday === ..[topic/#ubuntu-meeting:Seveas] : Calendar -- https://wiki.ubuntu.com/Calendar || Logs -- http://people.ubuntu.com/~fabbione/irclogs || Thu 14 July 22:00 UTC Documentation Team -- https://wiki.ubuntu.com/DocteamMeetingAgenda || Tue 19 July 14:00 UTC Community Council -- http://wiki.ubuntu.com/CommunityCouncilAgenda || Tue 12 July 22:00 UTC: Tech Board -- https://wiki.ubuntu.com/TechnicalBoardAgenda || This is NOT #ubuntu, or #ubuntu-devel [12:44] jsgotangco, do you envisage that a lot of work will be needed to update it? [12:44] mdke: not much really [12:44] yay [12:45] mdke: unless the artwork gets changed [12:45] let's face it... it will [12:45] its basically review/add/delete work [12:45] okies [12:45] Riddell: why do we not have Colonies for Kubuntu [12:45] cool [12:45] About Ubuntu, squinn [12:46] have not seen him lately [12:46] no [12:46] i am slightly concerned about that doc being looked after by him [12:46] but no doubt we will improvise later on [12:46] venda: because Kamion hasn't made any [12:46] venda: and I guess now isn't a good time to start, X and all that [12:47] Riddell: is the nightly build working now [12:47] Riddell: we need that x stuff fixed aspa [12:47] venda: there are nightly builds (didn't work very well last I tried) [12:47] asap [12:47] yes I know [12:47] *coughs* [12:47] Riddell: venda = froud [12:47] aah :) [12:48] Riddell: it really stands inmy way [12:48] please resolve that issue [12:48] daniels is working as fast as he can [12:48] on topic? [12:48] ubuntu userguide? [12:48] yes, it's daniels [12:48] arent you the one doing it [12:48] kubuntu quick guide? [12:48] awaiting review, but some things will need to change/added based on breezy decisions, venda has some insight on this [12:48] oh later [12:48] as I said earlier, the two guys who took charge of the ubuntu userguide haven't yet edited it at all [12:49] i am slightly concerned about that === venda does not think docs should have owners [12:49] well once i get breezy running smoothly i will look into it [12:49] venda, then you should have spoke up when we decided that two meetings ago :/ [12:49] dude, I am already in the dwang for saying what I think [12:49] owners is not a bad thing [12:50] you think me wants more [12:50] but you need people to commit [12:50] calm voicing of opinion is good [12:50] anyhow [12:50] i have been working on the ubuntu userguide quite a bit recently, and it needs a lot of work still [12:50] i was thinking maybe I would undertake to give it some love === rob^ is entertaining baby for 5 minutes [12:51] mdke: I see you and xpointer are making friends [12:51] venda, shall we say we are still sniffing each other's bottoms === venda passes rob^ a rattle [12:51] thanx [12:52] mdke: poh [12:52] pooh [12:52] so what do people think? === venda is waiting to get to kubuntu [12:52] would it be reasonable for me to put myself down for ubuntu userguide? === rob^ is singing "You Just Said Happy Birthday, In Cat" [12:52] why wouldn't it be reasonable? [12:52] mdke: its all you [12:53] sure if you can still put time for it [12:53] okay [12:53] kubuntu docs? [12:53] they are rocking afaics === venda looks up [12:54] kubuntu docs [12:54] yes [12:54] kquickguide is reviewable, but some stuff will need to be changed/added depending on breezy decisions [12:54] sounds good [12:54] we have all the infrustructure set and working [12:54] yeah kquickguide is a sure deliver [12:54] froud started some of those things [12:54] we just need people to write [12:55] and we need kubuntu-devel to get the install working === venda nudges Riddle [12:55] About Kubuntu is no issue [12:55] its a major blocker for us [12:55] Kynaptic User would have been ready, but it may be worthless now [12:56] judax, how come? [12:56] oh i c [12:56] sorry kynaptic yeah [12:56] mdke: Kynaptic may go away [12:56] we have many not decided issues in devel [12:56] these and the x issues are major problems for us [12:57] what are we going to do with Release Notes (both K and G)? [12:57] to scared to write to much for fear it will not be like that [12:57] k release notes started [12:57] cool [12:57] venda, I can relate [12:57] i guess its hard to do much on release notes until a later stage? [12:58] right [12:58] Riddell: pls those issues, pls solve them fast [12:58] venda, you've made your point [12:58] obviously not === jbailey [~jbailey@modemcable139.249-203-24.mc.videotron.ca] has joined #ubuntu-meeting [12:58] venda, i'm sure they do their best [12:58] we need answers [12:58] not wil do best [12:58] dates [12:58] venda, docs are not their only consideration [12:58] milestones [12:58] ok we have dates [12:58] docs are my only consideration [12:58] OT [12:59] my task to bat for them [12:59] mdke: you have dates [12:59] we have feature freeze on aug 11 [12:59] but we have no working system [12:59] k docs will rock 5.10, worries not [12:59] longer no working system, closer date comes, less can do [12:59] judax, agreed [01:00] whip 'em on #ubuntu-devel why dont you [01:00] venda, ok well you can continue that discussion outside this forum [01:00] instead of doing it our meeting [01:00] cool [01:00] jsgotangco, ++ [01:00] next agenda item? [01:00] jsgotangco: its a doc problem no? [01:01] there's no point on feeling helpless at the moment and we're not the only one affected [01:01] Wiki Team update? [01:01] jsgotangco: how do you write docs with no gui [01:01] venda, enough now man [01:02] venda: whine to daniels like what everybody else does [01:02] its a good point, this is not the place [01:03] wiki team update: thanks to robitaille we have fixed the broken icons on the wiki. current main initiative is https://wiki.ubuntu.com/UserDocumentation which we are trying to give a structure to allow wiki docs to become more accessible [01:03] night all wiki is not for me [01:03] IMHO it is already starting to rock [01:03] venda, there are more items after this one [01:04] venda: night [01:04] mdke: wiki, back ports and gnome not for me [01:05] that's about all i can think of on wikiteam [01:05] venda, ok night then [01:05] chow [01:05] let him be obviously he's only interested in specific things that only interest him instead of the whole team [01:05] ok let's carry on === mgalvin [~mgalvin@cpe-69-205-46-35.nycap.res.rr.com] has joined #ubuntu-meeting [01:05] gnome user guide... this is an awesome problem [01:05] hey [01:05] hmm [01:05] just in time mgalvin [01:05] hey mgalvin [01:06] you mean the 2.6 doc in yelp? [01:06] :) did i miss all of it [01:06] yea [01:06] i can introduce the gnome user guide problem quickly [01:06] almost [01:06] mdke: break a leg [01:07] as you were saying? [01:07] basically, there is a gnome user guide. It is nice, but WELL out of date. We have three ideas that have been suggested: 1. make a vendor drop and use bits of it in our ubuntu userguide by xincluding (froud's idea). 2. copy and paste interesting bits (preferred by me). 3. take it and update it and rewrite it as the Ubuntu user guide (suggested by jeffsch) === mdke puffs [01:08] why complicate something with #1 when its easier for you to do #2 and #3 [01:08] the second solution is the most selfish, because it precludes sending improvements upstream [01:09] but it is the easiest in terms of effort [01:09] 1 is cool and all, but it seems 1 works best if the content you want to bring in is current [01:09] right [01:09] btw you can see it here: http://www.gnome.org/learn/ [01:09] I like 3, followed by 1 when needed if upstream updates [01:09] judax, with 1 we could still update the vendor drop and send it back to gnome cvs [01:10] mdke: but doesn't that fly in the face of the leave upstream alone discussion we just had? [01:10] question: is #1 doable to people here at the moment [01:10] judax, i don't think so. It would just be a helpful thing to do [01:11] my personal view is that we don't have the time for 1 or 3 [01:11] but jeffsch may commit some time, in which case they might become doable [01:11]