=== nixternal [n=nixterna@71.194.189.213] has joined #ubuntu-meeting === nixternal`v2 [n=nixterna@71.194.189.213] has joined #ubuntu-meeting === j_ack [n=nico@p508DC1EE.dip0.t-ipconnect.de] has joined #ubuntu-meeting === JaneW [n=JaneW@dsl-146-167-152.telkomadsl.co.za] has joined #ubuntu-meeting === rikai [n=kitty@pool-72-65-96-19.ptldme.east.verizon.net] has joined #ubuntu-meeting === Flik [n=Flik@d205-250-159-119.bchsia.telus.net] has joined #ubuntu-meeting === rikai [n=kitty@pool-72-65-100-66.ptldme.east.verizon.net] has joined #ubuntu-meeting === nixternal [n=nixterna@71.194.189.213] has joined #ubuntu-meeting === susana_ [n=susana@92.Red-83-52-54.dynamicIP.rima-tde.net] has joined #ubuntu-meeting === teckfatt [n=teckfatt@AC8D48E8.ipt.aol.com] has joined #ubuntu-meeting === Spec [n=dragonco@ubuntu/member/spec] has joined #ubuntu-meeting === Spec[x] [n=dragonco@charon.devis.com] has joined #ubuntu-meeting === mgalvin [n=mgalvin@ubuntu/member/mgalvin] has joined #ubuntu-meeting === dou213 [n=xxx@p54B04254.dip0.t-ipconnect.de] has joined #ubuntu-meeting === paco_reyes [n=paco@201.121.81.154] has joined #ubuntu-meeting === ogra_ [n=ogra@p5089DB24.dip.t-dialin.net] has joined #ubuntu-meeting === ajmitch__ [n=ajmitch@203.89.166.123] has joined #ubuntu-meeting === ajmitch__ [n=ajmitch@203.89.166.123] has joined #ubuntu-meeting === ajmitch__ [n=ajmitch@203.89.166.123] has joined #ubuntu-meeting === Flik [n=Flik@d154-5-33-125.bchsia.telus.net] has joined #ubuntu-meeting === BlueT__ [n=BlueT@61-59-209-195.adsl.static.seed.net.tw] has joined #ubuntu-meeting === robitaille [n=daniel@ubuntu/member/robitaille] has joined #ubuntu-meeting === gruvby [i=gruvby@eyeoftruth.be] has joined #ubuntu-meeting === jsgotangco [n=jsg123@ubuntu/member/jsgotangco] has joined #ubuntu-meeting === magical_trevsky [n=magical@80-45-41-53.static.dsl.as9105.com] has joined #ubuntu-meeting === raphink [n=raphink@ubuntu/member/raphink] has joined #ubuntu-meeting === Lure [n=lure@ubuntu/member/lure] has joined #ubuntu-meeting === nixternal [n=nixterna@71.194.189.213] has joined #ubuntu-meeting === Lure [n=lure@ubuntu/member/lure] has joined #ubuntu-meeting === Hobbsee [n=Hobbsee@ubuntu/member/hobbsee] has joined #ubuntu-meeting === Hobbsee [n=Hobbsee@ubuntu/member/hobbsee] has left #ubuntu-meeting ["Bye!] === raphink [n=raphink@ubuntu/member/raphink] has joined #ubuntu-meeting === lloydinho [n=andreas@rosinante.egmont-kol.dk] has joined #ubuntu-meeting === imbrandon_ [n=brandon@ubuntu/member/imbrandon] has joined #ubuntu-meeting === mvo [n=egon@p54A67118.dip.t-dialin.net] has joined #ubuntu-meeting === jenda [n=jenda@unaffiliated/jenda] has joined #ubuntu-meeting === rodarvus [n=rodarvus@200.146.65.147.adsl.gvt.net.br] has joined #ubuntu-meeting === Lure_ [n=lure@ubuntu/member/lure] has joined #ubuntu-meeting === doko_ [n=doko@dslb-088-073-096-168.pools.arcor-ip.net] has joined #ubuntu-meeting === ubijtsa2 [n=ubijtsa@nat-pool-lhr.redhat.com] has joined #ubuntu-meeting === ubijtsa2 [n=ubijtsa@nat-pool-lhr.redhat.com] has left #ubuntu-meeting ["Leaving"] === rodarvus [n=rodarvus@200.146.65.147.adsl.gvt.net.br] has left #ubuntu-meeting ["Leaving"] === luka74 [n=lure@ubuntu/member/lure] has joined #ubuntu-meeting === slomo [n=slomo@ubuntu/member/slomo] has joined #ubuntu-meeting === KOnsumer [n=KOnsumer@drsd-d9b85624.pool.mediaWays.net] has joined #ubuntu-meeting === Fracture [n=Fracture@dsl-202-173-191-84.qld.westnet.com.au] has joined #ubuntu-meeting === lucas [n=lucas@ubuntu/member/lucas] has joined #ubuntu-meeting === Lure [n=lure@ubuntu/member/lure] has joined #ubuntu-meeting === Hirion [n=hirion@draugr.de] has joined #ubuntu-meeting === Lure [n=lure@ubuntu/member/lure] has joined #ubuntu-meeting === raphink [n=raphink@ubuntu/member/raphink] has joined #ubuntu-meeting [01:59] see you later === bhuvan_ [n=bhuvan@vpn5.maa.collab.net] has joined #ubuntu-meeting === ..[topic/#ubuntu-meeting:bhuvan_] : Calendar: http://fridge.ubuntu.com/event | Logs: https://wiki.ubuntu.com/MeetingLogs/ | 16 Jun 17:00 UTC: Docteam meeting | 20 Jun 20:00 UTC: Technical Board | 21 Jun 13:30 UTC: Xubuntu | 21 Jun 20:00 UTC: Edubuntu | 26 Jun 21:00 UTC: Kubuntu | 28 Jun 12:00 UTC: Edubuntu | 28 Jun 13:30 UTC: Xubuntu === ..[topic/#ubuntu-meeting:Ubugtu] : Calendar: http://fridge.ubuntu.com/event | Logs: https://wiki.ubuntu.com/MeetingLogs/ | 20 Jun 20:00 UTC: Technical Board | 21 Jun 13:30 UTC: Xubuntu | 21 Jun 20:00 UTC: Edubuntu | 26 Jun 21:00 UTC: Kubuntu | 28 Jun 12:00 UTC: Edubuntu | 28 Jun 13:30 UTC: Xubuntu === Plug [n=crb@203-167-190-117.dsl.clear.net.nz] has joined #ubuntu-meeting === Lure_ [n=lure@ubuntu/member/lure] has joined #ubuntu-meeting === bhuvan [n=bhuvan@ubuntu/member/bhuvan] has left #ubuntu-meeting [] === lukketto [n=lukketto@host40-190.pool877.interbusiness.it] has joined #ubuntu-meeting === lukketto [n=lukketto@host40-190.pool877.interbusiness.it] has left #ubuntu-meeting [] === lukketto [n=lukketto@host40-190.pool877.interbusiness.it] has joined #ubuntu-meeting [03:09] when the next meeting to become "member"? === luka74 [n=lure@ubuntu/member/lure] has joined #ubuntu-meeting [03:10] lukketto: AFAIK the next community council meeting should be soon, but no time has been set yet [03:10] but I haven't followed closely [03:14] azeem: thank you! I'll be tuned ;) === j_ack [n=nico@p508D8C93.dip0.t-ipconnect.de] has joined #ubuntu-meeting [03:23] I've been following closely, but it hasn't helped much :) === DBO [n=DBO@cpe-71-65-4-255.twmi.res.rr.com] has joined #ubuntu-meeting === LjL [n=ljl@62-101-126-215.ip.fastwebnet.it] has joined #ubuntu-meeting [03:31] azeem, probably in 2 weeks [03:31] next week is the paris conference [03:32] was there a CC meeting this week? === ogra [n=ogra@ubuntu/member/ogra] has joined #ubuntu-meeting === rodarvus [n=rodarvus@201.21.134.56] has joined #ubuntu-meeting === lapo [n=bat@host166-243-static.46-85-b.business.telecomitalia.it] has joined #ubuntu-meeting === lapo [n=bat@host166-243-static.46-85-b.business.telecomitalia.it] has left #ubuntu-meeting ["Ex-Chat"] === j_ack [n=nico@p508D8C93.dip0.t-ipconnect.de] has joined #ubuntu-meeting === raphink [n=raphink@ubuntu/member/raphink] has joined #ubuntu-meeting === magical_trevsky [n=magical@80-45-41-53.static.dsl.as9105.com] has joined #ubuntu-meeting === rodarvus [n=rodarvus@201.21.134.56] has left #ubuntu-meeting ["Leaving"] === slomo [n=slomo@ubuntu/member/slomo] has joined #ubuntu-meeting === rodarvus [n=rodarvus@201.21.134.56] has joined #ubuntu-meeting === jsgotangco [n=jsg123@ubuntu/member/jsgotangco] has joined #ubuntu-meeting === Seveas [n=seveas@ubuntu/member/seveas] has joined #ubuntu-meeting === mgalvin [n=mgalvin@ubuntu/member/mgalvin] has joined #ubuntu-meeting === bhuvan [n=bhuvan@ubuntu/member/bhuvan] has joined #ubuntu-meeting === DonSc [n=don@82-41-205-39.cable.ubr11.edin.blueyonder.co.uk] has joined #ubuntu-meeting === lukketto [n=lukketto@host40-190.pool877.interbusiness.it] has joined #ubuntu-meeting === klepas [n=klepas@203-213-31-142.static.tpgi.com.au] has joined #ubuntu-meeting === lukketto [n=lukketto@host40-190.pool877.interbusiness.it] has joined #ubuntu-meeting === lukketto [n=lukketto@host40-190.pool877.interbusiness.it] has left #ubuntu-meeting [] === slomo [n=slomo@ubuntu/member/slomo] has joined #ubuntu-meeting === luka74 [n=lure@ubuntu/member/lure] has joined #ubuntu-meeting === jjesse [n=jjesse@64.186.55.234] has joined #ubuntu-meeting [06:53] @schedule detroit [06:53] Schedule for America/Detroit: 20 Jun 16:00: Technical Board | 21 Jun 09:30: Xubuntu | 21 Jun 16:00: Edubuntu | 26 Jun 17:00: Kubuntu | 28 Jun 08:00: Edubuntu | 28 Jun 09:30: Xubuntu === LaserJock [n=mantha@ubuntu/member/laserjock] has joined #ubuntu-meeting [06:57] jjesse: that's nice :) [06:57] @schedule Sydney [06:57] Schedule for Australia/Sydney: 21 Jun 06:00: Technical Board | 21 Jun 23:30: Xubuntu | 22 Jun 06:00: Edubuntu | 27 Jun 07:00: Kubuntu | 28 Jun 22:00: Edubuntu | 28 Jun 23:30: Xubuntu === archis [n=archis@unaffiliated/archis] has joined #ubuntu-meeting [07:00] ding, time to start ? [07:00] wow, punctual [07:00] let's try to be punctual :) [07:00] whats going on? there is nothing scheduled [07:01] doc team meeting [07:01] ogra: we have scheduled doc team meeting, but it was not updated in the topic ... [07:01] the schedule got messed up, the channel and fridge had it for yesterday, when today is the real time [07:01] ah [07:01] i remember :) [07:01] I thought it was yesterday too [07:01] heh. they've probably said 'ubuntu' 10 times on the news tonight :) [07:02] highvoltage, not here :/ [07:02] (sorry, meant for other channel) [07:02] LaserJock: no [07:02] woo [07:02] almost missed it [07:02] let's start. first: Has everyone merged any changes made to the branch back to trunk for their documents? [07:02] can we wait to make sure mdke is here? === Exdaix [n=Exdaix@c-69-242-74-210.hsd1.pa.comcast.net] has joined #ubuntu-meeting [07:02] ok, np [07:03] bhuvan: I'm guessing no [07:03] looks like he isn't goign to make it [07:03] LaserJock: ok [07:03] bhuvan: yes i have merged some changes back into branches for the releasenotes for bug #48525 [07:03] Malone bug 48525 in kubuntu-docs "Problems with Dapper Release Notes for Kubuntu" [Medium,Confirmed] http://launchpad.net/bugs/48525 [07:03] bah, why can mdke never make the meetings? we need to schedule him better ;-) [07:03] however i'm not done making all of the changes [07:04] ok [07:04] packaging guide merge is ready to commit, I was just waiting for mdke to merge the common stuff [07:04] ok [07:04] bhuvan: the changes have been both made in trunk/kubuntu and also branches/dapper/kubuntu [07:04] ok, so henceforth we should make changes only in trunk? [07:05] bhuvan: correct [07:05] cool [07:05] yeah, unless we have some weird thing that should go in -updates [07:05] especially as we build edgy documents and then at the end of things we wil merge trunk to branches/edgy [07:06] yeah ok [07:06] +1 LaserJock [07:06] jjesse: i guess we have long way to go to creat branches/edgy? [07:06] doc string freeze [07:06] when doc freeze comes we create branches/edgy [07:06] 4 months [07:07] oh ok [07:07] actually less then that :) [07:07] we'll see next week :-) [07:07] when is edgy scheduled to release (if i'm ignorant) ? [07:07] october [07:07] ok [07:07] bhuvan: the release schedule will be done next week at the dev summit [07:07] falls in line with the every 6 months [07:08] gets us bac on schedule for the 6 months after the delay [07:08] whats' the next point in the agenda? [07:08] new docs [07:08] next: New documents for EdgyEft [07:08] NEW DOCUMENTS FOR EDGY EFT [07:08] hehe [07:08] 1) Ubuntu Reference Manual [07:09] any opinion about adding this manual for ubuntu? [07:09] what does it do? [07:09] what exactly will this manual be? how will it defer from the DesktopGuide? [07:09] we need a spec or something? [07:09] i would assume? [07:10] whose baby is it? [07:10] LaserJock: spec is not ready. but the intention is to make sure user is able to resolve most of his issues using this manual. it covers basics [07:10] LaserJock: it's (will be) mine! [07:10] how does that differ from the Desktop Guide? [07:11] jjesse: here we may cover how to install (basics), how to upgrade, how to configure custom apt repo, some server apps. finer specifics may be covered in specialised manuals like desktop guide, server guide, etc. [07:12] bhuvan: seems like a lot of overlap [07:12] troubleshooting? [07:12] jjesse: may be how to add a cron job [07:12] jjesse: overlap with existing ones? [07:12] LaserJock: you want to add that section? [07:13] bhuvan: yes overlap with what the desktop guide can and should show [07:15] jjesse: i want this manual to the superset and all other documents may be derived from it. it should be the one stop document for almost all user requirements. for finer details, the users can refere specialized documents/manuals [07:15] it's just a thought. unsure how relevant/useful it will be [07:15] then we need to make a Kubuntu one as well [07:16] jjesse: definitely :) [07:16] thats where i can help out if needed since i use Kubuntu and know my ways around KDE...i tend to loose it, or get lost in gnome ;) [07:16] hmm, I think something more like an index of what we have [07:16] ? [07:16] LaserJock: i wonder if that would be better on what mdke is suggesting about reording yelp [07:17] i guess almost all distribution (redhat, gentoo, debian) have such kind of document. so i guess we should have one [07:17] jjesse: that's what I was thiinking [07:17] it could be universal, as pretty much what you do with Ubuntu you can do with Kubuntu and so forth, you would have to get specific when it comes down to KDE/GTK specific apps [07:18] bhuvan: i think we need a more/better defined spec of it before i can figure out why i would use it as a user [07:18] maybe some further discussion on the mailing lists? [07:18] with links to other docs of similar sort [07:18] yeah [07:18] I agree [07:19] jjesse: point. it adds value only when we have defined spec. i guess, i can prepare the spec so we can discuss either in mailing list/irc [07:19] I think a nice indexing type page (one for all derivatives) that makes it easy for a user to find what they want in the existing docs [07:19] would be nice :-) [07:19] which i think mdke is aruging for [07:20] kinda, yeah [07:20] LaserJock: you are more refering to site map kind of document. i guess, reference manual may not be for that [07:20] kind of like a site map, but a little more to it [07:21] yeah [07:21] bhuvan: I'd suggest making a spec with an outline and links to other like docs as jjesse has said. I'm just not clear on what you are proposing [07:21] LaserJock: ok [07:21] and how it integrates with our docs, etc. === linuxmonkey [n=linuxmon@unaffiliated/LinuxMonkey] has joined #ubuntu-meeting [07:21] ok [07:21] I think I like the idea, I just need to see more and we should tweak it up nice :-) [07:22] yeah ok and it should be presented well :) [07:22] +1 laserjock === linuxmonkey [n=linuxmon@unaffiliated/LinuxMonkey] has left #ubuntu-meeting ["Konversation] [07:22] ok, good plan. shall we move to next topic ? [07:23] sure [07:23] Kubuntu Docs ([JonathanJesse] ) [07:24] jjesse: do you like to propose new documents for kubuntu? [07:24] jjesse: this is along the lines of what kmon and Riddell referred to? [07:25] jjesse: ok so what's new, the switching from windows? [07:26] sorry phonecall [07:26] my opinion, as well as many other Kubuntu'ers, is that the documentation is Ubuntu sided, and it seems as if Kubuntu is a back burner project..i think users would like to see a little more kubuntu specific documentation [07:26] haha jjesse me too..my sister wouldn't stop talking [07:27] nixternal what are you refering to riddell talkign about? [07:27] nixternal: I've been hearing that kind of thing from the dev side as well [07:27] about the Kubuntu documentation that was brought up during the Kubuntu Meeting a week or so ago [07:27] nixternal: ah yes [07:27] well currently the spec KubuntuDocs/Edgy refer to the current docs plus a SwitchingFromWindows [07:27] plus there is no guide for any of adept programs which i'm writing [07:28] i know kmon had proposed a kubuntu doc/wiki team at their meeting...and that is why i was here to help [07:28] ah [07:28] bah, why do that? [07:28] nixternal: kmon and I spoke that we would not seperate the kubuntu users from ubuntu-doc [07:28] im guessing they feel left out ;) [07:29] we use the same tools, the same repository, the same site, help.ubuntu.com/doc.ubuntu.com etc [07:29] i agree jjesse..as i think that goes against the Ubuntu meaning for one...w/o Ubuntu there would be no Kubuntu [07:29] nixternal: can you elaborate ? [07:29] bhuvan: it goes back to a lot of the documentation/work is very ubuntu specific [07:29] yeah, because people work on what they use [07:29] for example in the Official Ubuntu Book, there is only one chapter dedicated to Kubuntu (which I wrote) but the rest of the book is dedicated to ubuntu [07:30] jjesse: wont it be solved if we have enough kubuntu documenters [07:30] if you look at wiki documentation/howto's and what not, they all seem to lean towards Ubuntu...of course most of these articles will also work with Kubuntu [07:30] i would love to get involved with some Kubuntu documentation..that is why i was trying to join the DocTeam [07:30] and there is no reason you can't [07:30] bhuvan: yes it would help, however most of the calls for help that have been placed there has been no response [07:31] nixternal and we would love to have you help out with thedocs [07:31] im not a coder..and i just want to help out..plus i have done documentation previously [07:31] thx jjesse [07:31] jjesse: as LaserJock say they work on what they use. [07:31] if you want to help out with the dekstop guide, release notes, about kubuntu etc that is great [07:31] nixternal: great [07:31] or if you want to write your document that needs help that would be perfect [07:31] nixternal: just add it to the spec :) [07:32] spec link that you are referring to [07:32] or link spec rather ;) [07:32] http://wiki.kubuntu.org/KubuntuDocs/Edgy [07:32] imo, if we remove gnome/kde everything is just one. so, the help system is available for all those applications in ubuntu/kubuntu form. so, why do we have hard feeling (if we have one)? [07:32] arg..lol...looking at it already [07:32] i can come up with something im sure [07:33] nixternal: that is awesome [07:33] i can work with kmon and Riddell to see what they may like to see [07:33] nixternal: can you CC me on emails to them :) [07:33] sure can [07:33] nixternal: and may be to ubuntu-doc mailing list? [07:33] yeah [07:33] no problem [07:34] instead of cc me just cc ubuntu-doc :) [07:34] got it [07:34] jjesse: ok, so is this switching to windows doc Kubuntu specific? could we turn it into a generic doc? [07:34] LaserJock: well i think it might become like the DesktopGuide [07:34] switching to windows? is that backwards? [07:34] one for Ubuntu and one for Kubuntu [07:34] don't we want switching from windows ;) [07:34] just because there are a lot of things that are different [07:35] and it should be switching from windows [07:35] hehe [07:35] lol, sorry [07:35] i think that would have been a bad marketing decision ;D [07:35] hehe [07:36] anyways the wiki page SwitchingFrom Windows is quite big and there is a lot ubuntu specific stuff on it [07:37] i think someone, and maybe nixternal would like to create it :) should take a large portion of it and kubuntuize it [07:37] i can take a look and come up with some Kubuntu ideas for it if you would like [07:37] imo, it should be more generic (applicable to both ubuntu/kubuntu) than being specific to kubuntu :) [07:37] yeah, I just wondered if it was DE specifc enough to need 2 docs [07:37] 2 docs = 2 identical docs [07:38] https://wiki.kubuntu.org/SwitchingFromWindows [07:38] imo, in long run it may be difficult to maintain and keep them up-to-date and sync with each other [07:38] agreed bhuvan, i think that is the problem we ran into w/ the desktop guide [07:38] maybe a default page "SwitchingFromWindows" with other pages linked to Ubuntu > Kubuntu and so forth [07:38] or like bhuvan said, make it generic [07:39] if we create the document, we can get it linked off of help.ubuntu.com and also get included in the DesktopCD === j_ack [n=nico@p508D8C93.dip0.t-ipconnect.de] has joined #ubuntu-meeting [07:39] what I'd like to see is something where you write it as generically as possible and then have little notes or something where it is DE specifc [07:39] although, it could be generic...alot of it actually...with some differences when it comes to graphical software installations via synaptics or ept [07:39] jjesse, imo we should have one document as we currently have (server guide, packaging guide). we can feel free to ship two copies seperately, may be one in ubuntu-docs and one in kubuntu-docs [07:40] ok, i'll start a thread on the mailing list where we can discuss in further detail [07:40] bhuvan: yes, ideally, the point is if we can get the info to the user we need doing it generically [07:40] jjesse: ok [07:40] some things do depend on the DE [07:41] yeah [07:41] ok, now, shall we move to next topic ? [07:41] I have one doc [07:41] yeah? [07:41] I didn't put it on the agenda [07:41] the packaging guide? [07:41] and I don't know that I'll be doing it in edgy [07:41] https://wiki.ubuntu.com/UbuntuScriptingDoc [07:42] go ahead [07:42] jjesse: now, that one isn't new anymore ;-) [07:42] grin [07:42] my idea was to have a simple intro to Python/Bash scripting and with cookbook style code snippets (contributed by the community) for every day user things [07:43] i like that [07:43] it is very brain dump at this point, but here is my rationale [07:43] LaserJock: that sounds pretty cool [07:43] 1) Ubuntu has been called a Python-centric distro [07:44] but we really don't have any docs that show it (we do ship Dive into Python) === bhuvan is loving python these days === nixternal is learning it ;) [07:44] 2) Even fairly new users need to do automated tasks [07:44] i can print 5+6 to the screen ;) [07:44] rename .mpg/.ogg based on id tags [07:45] 3) It give a change for kids (and adults of course :-) ) to get into programming in an easy way [07:45] LaserJock +1 for me [07:45] i'd go ahead and create it [07:46] so it's more of an Python/Bash evangelizing doc than a Course in Computer Science ;-) [07:46] +1 here big time [07:46] great spec imho [07:46] LaserJock, but how well it is useful while tons of documents are already available for python [07:46] indeed [07:46] bhuvan: because it is Python on Ubuntu, and it isn't a Python Reference/Tutuorial [07:46] i could really use something like that considering im just now getting into the programming part of computers after stopping many many years ago... [07:47] LaserJock: can you show an example? [07:48] bhuvan: the one I gave was renaming .mp3s based on id tags [07:48] it takes about 10 lines in python [07:48] ok, so are we going to include the script and demonstrate the user using a document? [07:48] yeah [07:48] the idea would be similar to Python Cookbook [07:48] but more user focused [07:49] LaserJock, great idea. but do you think other distro docteam prepare these kind of documents? [07:49] so get little scripts from people (we can have a "call for scripts" on the forums, ML, etc.) and then explain Python by explaining what the script does [07:49] bhuvan: I don't really know [07:49] bhuvan: I doubt it [07:50] LaserJock: good we didnt choose perl and we may end up shipping the dependent module along with the document ! [07:51] just getting people interested in Python by showing, "heah, you don't have to write a 10,000 line GUI app to use this" [07:51] my main point is, Python is great, and we ship lots of Python stuff, let's show users how to use it a bit, get them interested [07:52] LaserJock: definitely we have point to prove. may be, we can list of couple of frequent programming needs in day to day user/developer need and document it in a form to reach them effectively [07:53] LaserJock, i'm not fully inclined including as part of document. But it is worth discussing with others through mailing list. so please ... [07:53] what is the next topic? [07:53] seems as if the next topic is mdke specific concerning his "Turn the help system upsidedown and make it more useful" proposal [07:53] yeah, this is sweet [07:53] nixternal, yeah thanks [07:54] i have two questions from that document. 1) what does he refer as help system (d.u.c or h.u.c or w.u.c) 2) what does he refer as upstream document [07:55] 1) yelp or khelpcenter? 2) gnome/kde [07:55] i think he referes to help.ubuntu.com [07:55] 1) +1 jjesse [07:55] maybe we should hold this to the end just in case he makes it home and comes in here...or hold it off until we can speak with him [07:55] "a possible way to go might be to bin the upstream categorisation that currently forms the front page of the help system" [07:56] what he's talking about it taking gnome/kde doc and melding them with our docs [07:56] i wish he wa here :) [07:56] and then we have a listing (like he has) of areas a user would want to go to [07:57] I read it as reforming the Yelp front page (FWIW) [07:57] yes [07:57] DonSc: me too come to that conclusion after reading point 1 in advantages section [07:57] I think the idea is to move away from doc specific documentation [07:57] like you click on Packaging Guide or Desktop Guide [07:58] explain doc specific documentation? [07:58] infact i never use 2nd half [07:58] "Project Mallard"!!!!1111!!one1!!!(tm) [07:58] so the documentation is centered around those areas [07:59] so I don't write the Packaging Guide so much as add to the "Contributing to Ubuntu" section [07:59] intersting [07:59] if we include those new sections, where does the existing ones go? [08:00] "Using your desktop" would have stuff from DG but also Gnome/KDE docs, Offical book, etc [08:00] bhuvan: away! [08:00] and how do we maintain it in svn? [08:00] hehe, that's a good question :-) [08:00] LaserJock: :) i'm unsure if he mean it :) :) [08:00] yes [08:01] wrong button? [08:01] may be [08:01] bhuvan: he wan't the yelp home page to look like what he had [08:01] hehe [08:01] LaserJock: yeah, but where do we place existing ones and how do we draw line between new and existing ones? [08:02] there won't be existing ones [08:02] that's the point [08:02] lot of work [08:02] yelp will *only* have those items [08:02] LaserJock, each of those topics are excellent and need to be placed but where and at the cost of what? [08:03] those items are the help system [08:03] Really, really, look into Mallard [08:03] the cost is a heck of a lot of work [08:03] DonSc: I think that might be in the plan [08:03] not sure though [08:03] LaserJock, not just that at the cost of existing ones [08:03] Basically along the same lines [08:03] bhuvan: no, they are a part of the new system [08:04] LaserJock: you mean they will be part of new system, but they wont be placed in front page? [08:04] bah, no [08:04] it won't say [08:05] "Desktop Guide" [08:05] the desktop guide content will be in the relevent areas [08:05] oh ok [08:05] along with the upstream content [08:05] Offical book sections, etc. [08:06] see the italicized stuff next to the items [08:06] so, it will be like segregating existing ones and forming these documents. once we develop all these documents, we may remove existing ones? [08:07] well, I don't know that there an plan, but I would think the existing doc contents get swallowed up into the new help system [08:07] *is a plan [08:08] basically, the problem is that the current yelp (and I think KDE has a similar problem) is a mess [08:08] users don't know where to go [08:08] ok [08:08] LaserJock: we're working on a new TOC for 2.16 [08:08] they never get to things they should, a lot of that is because we don't integrate into the upstream docs [08:08] As a stopgap until Mallard arives [08:08] DonSc: ah, interesting === bhuvan have added UbuntuScriptingDoc to agenda [08:09] bhuvan: hehe, thanks [08:09] for instance, Dive into Python [08:09] Need to look into new categories though === jjesse [n=jjesse@64.186.55.234] has joined #ubuntu-meeting [08:09] wb jjesse [08:09] sorry needed to restart [08:09] hehe [08:09] vmware locked on me [08:10] LaserJock: what's your opinion about this proposal? [08:10] and jjesse: your opinion? [08:10] mdke's? [08:11] don't have one right now, but i like the way things are setup right now :) [08:11] if we go ahead with this plan, how do we cater kubuntu needs? are we going to span that many kubuntu copies? [08:11] my opinion even though im not officially a member > i don't know about turning it upside down, however making it more useful is good, but making the entire system EASIER for a beginner is the biggest approvement I think needed [08:12] improvement [08:12] agreed with bhuvan [08:12] nixternal: to give your opinion, you need not be a member. so feel free. you are doing good [08:12] whew..thx ;) [08:12] my opinion is this, I think the idea is great and we need to head in that direction, but it will take a lot of hard work and *really* good communication with upstreams, etc. [08:13] so if we can do it, wonderful [08:13] i see where bhuvan is coming from... you would need 4 introductions for instance > Ubuntu / Kubuntu / Edubuntu / Xubuntu and more when new distro's come available [08:13] supported instances [08:13] nixternal: each of those ships there own -docs anyway [08:13] true [08:14] LaserJock: not yet i guess [08:14] not yet what? [08:14] i guess, each of those distro dont ship theire own -docs right now [08:15] just kubuntu-docs and ubuntu-docs [08:15] so far [08:15] jjesse: yes [08:15] so as mdke stated in line 2, we should do something adventurous this release. in that line it's an excellent move [08:16] bhuvan: yes they do [08:16] jjesse: no [08:16] LaserJock: is it? where do you see? [08:16] edubuntu and xubuntu shipped their own for Dapper, Edubuntu I'm sure of [08:17] yeah, they are both there [08:17] all the derivatives ship -docs [08:18] LaserJock: yeah i see relevant launchpad projects [08:18] anyway [08:18] https://launchpad.net/distros/ubuntu/dapper/+source/xubuntu-docs [08:18] fine [08:18] I believe users are not using the help systems effectively [08:18] so, atleast we conclude we can move forward in this direction. am i right? [08:18] heck, I'm not even using them effectavly [08:19] bhuvan: as long as we take into account the different distros [08:19] bhuvan: well, there are a lot of other issues, translations, how to actually merge upstream, etc. [08:19] jjesse: it has to be discussed [08:19] LaserJock: it's the path right. so, we must take care [08:20] I do think it is the right path [08:20] see the last point. 'Some hard work required' :) [08:20] the user shouldn't have to figure out what is Ubuntu and what is Upstream [08:20] they should just think "What do I want help about" and that's it [08:20] +1 ^^ [08:21] i would be intersted in further discussion [08:21] anyhow, we still have two questions unanswered: 1) action plan and what will be the status of existing ones and how it will be organised in svn 2) for other distros [08:21] existing docs are turned into the new ones [08:21] we might have to ditch svn I don't know [08:21] LaserJock: ok [08:22] ditch svn? === bhuvan is from collabnet -- official svn sponsor :) [08:22] well, it could be that possibly it would be done via bzr [08:22] using LP [08:23] who know's [08:23] we are discussing ditching source packages too so.... ;-) [08:23] it Edgy!!! [08:23] it's [08:23] source package is ubuntu-docs and i assume we will place all these new documents in that. [08:24] bhuvan: hehe, my point is that some people are talking about doing away with source packages in Ubuntu and using bzr/LP [08:24] anyway [08:24] ok === bhuvan is in half sleep. it's already 11:55 midnight [08:25] my point is, at this point we need to decide if it is worth pursuing actually figuring out an implementation plan [08:26] LaserJock: i meant action plan. how do we plan to generate these docs ? what are the topics they constitute ? when we will release the first snapshot and things alike [08:27] LaserJock: and importantly who is going to take the lead responsibility [08:27] well, I think most of that is in mdke's spec [08:27] LaserJock: nope. it's just the outline and it define what to do, but it doesnt explain howto do [08:27] well, then we need to figure that out ;-) [08:28] yeah, shall we move to next topic? [08:28] I think mdke just wanted some feedback from the team as to if he was on crack or not ;-) [08:28] lol [08:28] LaserJock, yeah i read it so [08:28] next item [08:28] w.u.c to h.u.c/community migration activity [08:29] do we know if the wiki has moved yet? [08:29] nope. they have set redirecting though [08:29] yeah, I think people are busy getting ready for Paris [08:29] ok [08:30] will there be any change in wiki clean-up activity before we do this migration? [08:30] we really need to get that done though [08:30] well, it should be ready to go [08:30] lots of people went though and cleaned out docs they didn't want moved and added ones they did [08:31] since it was supposed to happen like a week or two ago [08:31] we have been working on cleaning up w.u.c [08:31] yeah, we seem to keep discussing about wikiteam and special privileges for them to control certain freezed pages ... [08:32] next item? [08:32] are we through with this? [08:33] I think so, the move hasn't happened yet [08:33] my doubt is, if we move are we planning to implement new policies for wiki or live with existing one? [08:33] any timeline on the move? [08:33] nixternal: it was supposed to happen a while ago [08:33] are we still on the agenda or are there things we can move to #ubuntu-doc? [08:33] we are on the agenda, do we need to make room for somebody else jjesse [08:34] i thought so..i remember when i started working with the wiki team, corey said they were getting ready to move to h.u.c [08:34] nope i just don't want to get off track too far [08:34] jjesse: i guess we are not getting off track [08:35] bhuvan: yes, I expect there will be some new policies, not much of a change though [08:35] i assumed when we migrate w.u.c to h.u.c/community, there might be a change in wiki policy, thus not all of the users can edit all pages [08:35] LaserJock: ok [08:35] bhuvan: only the wiki team can delete/rename and a few pages might be locked maliciousness doesn't happen [08:36] so...community docs..is the entire wiki going to be transferred, or just redirects? [08:36] may be none of us here are unaware of that. we can discuss it in in #ubuntu-doc or mailing list so each of us may be aware of what'd happen after the move [08:36] ok, next item? [08:36] nixternal: everything with CategoryDocumentation [08:37] ok [08:37] it's mine: Define a standard for svn (ubuntu-doc repository) commit log messages [08:37] need to work on cleaning up more of those then [08:37] nixternal: and redirects will be left on wiki.u.c [08:38] bhuvan: yes? [08:39] currently, we committers dont follow standard when we commit the patch [08:39] it'd be great and useful if all committers follow and adhere to the standard when we record log messages [08:39] is it a problem? [08:39] in general, every open source project follow standard when it comes to commit [08:40] well, but is it a problem for us? do you have an example? === mdke [n=matt@ubuntu/member/mdke] has joined #ubuntu-meeting [08:40] LaserJock: definitely yes. for a given document right now we dont know what was committed. the quality of log depend on committer [08:40] does the log matter much? [08:41] yes LaserJock [08:41] when someone wish to scan through the changes made to a document over a period of time, it makes sense [08:41] k, I guess [08:41] bhuvan: are you talking about the svn commit log? [08:41] it does not require major effort to follow these simple standards, like: http://pastebin.com/713240 [08:41] mdke: yes [08:41] mdke: last topic! [08:41] gotcha [08:42] I think the quality of the logs has been quite high, myself [08:42] mdke: yeah true. everyone of us should follow [08:42] they don't? [08:42] ops, wrong url. it should be: http://pastebin.com/713254 [08:43] I'm just not seeing a problem, not that I'm against what your saying [08:43] i prefer every committer to follow this standard. so the quality of log doesnt differ among committers [08:44] I think that is a bit too detailed, it might be overkill [08:44] LaserJock: ok. imo, it's good to practise these standards when we work in any open source project [08:44] lots of times people make big changes, and detailing everything that closely would take some time [08:45] mdke: ok, i guess it is required in long run. we can scan through the log messages and spell the history of document [08:45] I don't know, I just try to explain what I did, if people really care they can check out the diff or -commits [08:45] mdke: it can be comma seperated. for example if we add installation section for numerous sections, just include the section name seperated by comma [08:46] LaserJock: to understand what has been changed, it's wise to have detailed log message than expecting the user to go through diff or -commits [08:46] who's the user? [08:47] I mean does anybody really care? [08:47] document maintainers [08:47] if someone joins our team in future and if he wish to see the history of document, log messages play vital role [08:47] I'm not trying to bash the idea, it just seems a little overkill for us [08:47] agreed [08:48] jjesse: agreed with whom :) :) [08:48] LaserJock [08:48] yeah ok [08:48] I'm pretty bad a commit/change logs but I can try to get better [08:49] yes, I think it's a bit overkill. However we can make an effort to give a good explanation of what is done in commits [08:49] ok. let me assume it's -1 :) [08:50] I'm not -1, I just think your paste was a little too much effort [08:50] mdke: ok [08:50] bhuvan: what I would like to see is a good example in the style guide (if it doesn't have one already) [08:51] good idea [08:51] LaserJock: so you dont want it as mandatory. but we can let the committer take a call? [08:51] "best practices" [08:51] ok, sounds good [08:51] and pehaps have a couple "essential elements of a good commit log" [08:52] yeah ok [08:52] like if you commit a patch from somebody else make sure to mention who they are ;-) [08:52] yeah, we already do that [08:53] fine, i guess that's it for the day. we have discussed almost 2hrs! [08:53] i guess, it's one of the productive meeting we had :) [08:53] yes [08:53] nice [08:53] it's because Matthew and Corey didn't show ;-) [08:53] thanks to everybody, LaserJock, jjesse & nixternal === mdke nods [08:54] ha ha ha [08:54] and Madpilot :) [08:54] Doc Team meeting ends here ---------- === bhuvan [n=bhuvan@ubuntu/member/bhuvan] has left #ubuntu-meeting [] === jjesse [n=jjesse@64.186.55.234] has left #ubuntu-meeting [] === LaserJock [n=mantha@ubuntu/member/laserjock] has left #ubuntu-meeting [] === DonSc [n=don@82-41-205-39.cable.ubr11.edin.blueyonder.co.uk] has left #ubuntu-meeting ["Ex-Chat"] === raphink [n=raphink@ubuntu/member/raphink] has joined #ubuntu-meeting === mdke [n=matt@ubuntu/member/mdke] has left #ubuntu-meeting ["goodbye!"] === jarufe [n=jarufe@200.104.140.155] has joined #ubuntu-meeting === ogra__ [n=ogra@p5089E3ED.dip.t-dialin.net] has joined #ubuntu-meeting === mgalvin [n=mgalvin@ubuntu/member/mgalvin] has joined #ubuntu-meeting === ogra_ [n=ogra@p5089E3ED.dip.t-dialin.net] has joined #ubuntu-meeting === Spec[x] [n=dragonco@charon.devis.com] has joined #ubuntu-meeting === sebas [n=sebas@belphegor.deadlysins.nl] has joined #ubuntu-meeting === Ubugtu [n=bugbot@ubuntu/bot/ubugtu] has joined #ubuntu-meeting === j_ack [n=nico@p508D8C93.dip0.t-ipconnect.de] has joined #ubuntu-meeting === sirkelley [n=sirkelle@ip68-12-236-180.ok.ok.cox.net] has joined #ubuntu-meeting === kjcole [n=kjcole@ubuntu/member/kjcole] has joined #ubuntu-meeting === Hirion [n=hirion@draugr.de] has left #ubuntu-meeting [] === lukketto [n=lukketto@host40-190.pool877.interbusiness.it] has joined #ubuntu-meeting === Seveas [n=seveas@ubuntu/member/seveas] has joined #ubuntu-meeting === Rinchen [n=Rinchen@unaffiliated/rescue] has joined #ubuntu-meeting