/srv/irclogs.ubuntu.com/2007/02/09/#ubuntu-doc.txt

CIA-4Ubuntu Documentation: mantha * r3781 /trunk/ (12 files in 12 dirs):12:29
CIA-4Ubuntu Documentation: last one for today12:29
CIA-4Ubuntu Documentation: * update ubuntu omfs for CC-BY-SA 2.512:29
CIA-4Ubuntu Documentation: * update global.ent for 2.512:29
CIA-4Ubuntu Documentation: * update en legalnotice for 2.512:29
LaserJockif I see another license today I'm gonna puke12:29
=== jsgotangco [n=jsg123@ubuntu/member/jsgotangco] has joined #ubuntu-doc
=== bhuvan [n=bhuvan@ubuntu/member/bhuvan] has joined #ubuntu-doc
=== Madpilot [n=brian@ubuntu/member/madpilot] has joined #ubuntu-doc
=== Jucato [n=jucato@ubuntu/member/Jucato] has joined #ubuntu-doc
=== mdke [n=matt@ubuntu/member/mdke] has joined #ubuntu-doc
=== jjesse [n=jjesse@ppp-69-221-252-203.dsl.klmzmi.ameritech.net] has joined #ubuntu-doc
=== jjesse_ [n=jjesse@ppp-69-221-252-203.dsl.klmzmi.ameritech.net] has joined #ubuntu-doc
CIA-4Ubuntu Documentation: bhuvan * r3782 generic/serverguide/C/file-server.xml:02:54
CIA-4Ubuntu Documentation: Fix for issue 75080.02:54
CIA-4Ubuntu Documentation: Include portmap package to be installed during NFS server installation.02:54
CIA-4Ubuntu Documentation: Reported by: Trey Ethridge <tale@juno.com>02:54
=== Burgundavia [n=corey@ubuntu/member/burgundavia] has joined #ubuntu-doc
=== poningru [n=poningru@adsl-074-245-140-197.sip.gnv.bellsouth.net] has joined #ubuntu-doc
=== mpt [n=mpt@121-72-137-28.dsl.telstraclear.net] has joined #ubuntu-doc
=== Admiral_Chicago [n=Freddy@205.166.159.38] has joined #ubuntu-doc
=== j1mc [n=j1m@adsl-75-21-84-63.dsl.chcgil.sbcglobal.net] has joined #ubuntu-doc
=== Madpilot [n=brian@ubuntu/member/madpilot] has joined #ubuntu-doc
=== jsgotangco [n=jsg123@ubuntu/member/jsgotangco] has joined #ubuntu-doc
=== jjesse_ [n=jjesse@ppp-69-221-226-93.dsl.klmzmi.ameritech.net] has joined #ubuntu-doc
=== xipietotec [n=jackfros@194.115.109.66.static.dis.net] has joined #ubuntu-doc
=== TLE [n=kenneth@gray1.gbar.dtu.dk] has joined #ubuntu-doc
=== TLE [n=kenneth@hald.gbar.dtu.dk] has joined #ubuntu-doc
=== bhuvan_ [n=bhuvan@ubuntu/member/bhuvan] has joined #ubuntu-doc
CIA-4Ubuntu Documentation: mdke * r3783 debian/changelog: changelog entry09:22
LaserJockmdke: did you see my license commits?09:25
mdkeLaserJock: yep, thanks a lot for those09:26
LaserJockXubuntu, Kubuntu, and Edubuntu need a lot of changes09:27
LaserJockbut I thought maybe I'd ask them first before mucking about with their files ;-)09:27
mdkegood idea09:28
LaserJockbut Ubuntu should be set I think09:28
mdkecool cheers09:28
LaserJockmy good deed for the day ;-)09:29
=== bhuvan_ is now known as bhuvan
mdkehiya bhuvan09:29
mdkehow's the serverguide going?09:29
bhuvanhello mdke09:29
bhuvani've not yet started in full. but planning to do so this week end; i bet i'll commit something during this week end!09:30
mdkerock09:30
mdkebhuvan: is there a lot of work to do still?09:32
=== glatzor [n=sebi@p54967641.dip.t-dialin.net] has joined #ubuntu-doc
=== WaterSevenUb [n=WaterSev@242-147.dial.nortenet.pt] has joined #ubuntu-doc
bhuvanmdke: i think so; i had to add material for couple of new topics viz. wiki, ldap, tomcat, drupal, etc.10:08
=== Gwaihir [n=Gwaihir@mail.foredil.it] has joined #ubuntu-doc
=== jsgotangco [n=jsg123@ubuntu/member/jsgotangco] has joined #ubuntu-doc
=== bhuvan [n=bhuvan@ubuntu/member/bhuvan] has joined #ubuntu-doc
=== Shubacka [n=olivier@194.206.177.80] has joined #ubuntu-doc
=== jenda [n=jenda@ubuntu/member/jenda] has joined #ubuntu-doc
=== TLE [n=kenneth@hald.gbar.dtu.dk] has joined #ubuntu-doc
=== TLE [n=kenneth@hald.gbar.dtu.dk] has joined #ubuntu-doc
=== MatthewV [n=MatthewV@202.183.115.136] has joined #ubuntu-doc
=== TLE [n=kenneth@hald.gbar.dtu.dk] has joined #ubuntu-doc
=== TLE [n=kenneth@hald.gbar.dtu.dk] has joined #ubuntu-doc
=== WaterSevenUb [n=WaterSev@242-66.dial.nortenet.pt] has joined #ubuntu-doc
=== poningru_ [n=poningru@adsl-074-245-140-197.sip.gnv.bellsouth.net] has joined #ubuntu-doc
=== silwol [n=silwol@193.170.68.74] has joined #ubuntu-doc
=== poningru [n=poningru@adsl-074-245-140-197.sip.gnv.bellsouth.net] has joined #ubuntu-doc
=== poningru [n=poningru@adsl-074-245-140-197.sip.gnv.bellsouth.net] has joined #ubuntu-doc
=== willvdl [n=will@vc-196-207-41-253.3g.vodacom.co.za] has joined #ubuntu-doc
=== TLE [n=kenneth@217.74.211.126] has joined #ubuntu-doc
=== Gwaihir [n=Gwaihir@mail.foredil.it] has joined #ubuntu-doc
=== Admiral_Chicago [n=Freddy@205.166.159.38] has joined #ubuntu-doc
=== highvoltage [n=jaagaan@johannesleroux.co.za] has joined #ubuntu-doc
=== jsgotangco [n=jsg123@ubuntu/member/jsgotangco] has joined #ubuntu-doc
=== jsgotangco [n=jsg123@ubuntu/member/jsgotangco] has joined #ubuntu-doc
=== Admiral_Chicago [n=Freddy@205.166.159.38] has joined #ubuntu-doc
=== TLE [n=kenneth@217.74.211.126] has joined #ubuntu-doc
=== willvdl [n=will@vc-196-207-41-253.3g.vodacom.co.za] has joined #ubuntu-doc
=== poningru [n=poningru@adsl-074-245-140-197.sip.gnv.bellsouth.net] has joined #ubuntu-doc
=== WaterSevenUb [n=WaterSev@242-66.dial.nortenet.pt] has joined #ubuntu-doc
=== xipietotec [n=jackfros@194.115.109.66.static.dis.net] has joined #ubuntu-doc
=== mdke [n=matt@ubuntu/member/mdke] has joined #ubuntu-doc
=== Seveas [n=seveas@ubuntu/member/seveas] has joined #ubuntu-doc
=== nixternal [n=nixterna@ubuntu/member/nixternal] has joined #ubuntu-doc
=== ryanakca [n=ryan@ubuntu/member/ryanakca] has joined #ubuntu-doc
=== trappist [i=trappist@linuxkungfu.org] has joined #ubuntu-doc
=== zenrox [n=zenrox@pool-71-115-200-45.spknwa.dsl-w.verizon.net] has joined #ubuntu-doc
=== XiXaQ [n=joerlend@237-191.dsl.freewave.no] has joined #ubuntu-doc
=== Laser_away [n=mantha@ubuntu/member/laserjock] has joined #ubuntu-doc
=== enrico [n=enrico@debian/developer/enrico] has joined #ubuntu-doc
=== Gwaihir [n=Gwaihir@mail.foredil.it] has joined #ubuntu-doc
=== glatzor [n=sebi@p54967641.dip.t-dialin.net] has joined #ubuntu-doc
=== CIA-4 [i=cia@cia.navi.cx] has joined #ubuntu-doc
=== dsas [n=dean@cpc3-stok6-0-0-cust253.bagu.cable.ntl.com] has joined #ubuntu-doc
CIA-4Ubuntu Documentation: nixternal * r3784 edubuntu/handbook/C/introduction.xml: Will's Edubuntu introduction patch04:21
nixternalwillvdl: ^^ there you sir!04:23
willvdlnixternal, chatting to pygi04:23
willvdlthanks04:23
nixternalahh04:23
nixternalhow is he doing?04:23
=== nixternal grabs a bat and takes the dog for a walk :)
nixternalchicago style04:24
willvdlpoor dog04:50
=== motin [n=motin@84-217-185-66.tn.glocalnet.net] has joined #ubuntu-doc
=== willvdl [n=will@vc-196-207-41-253.3g.vodacom.co.za] has left #ubuntu-doc ["Leaving"]
CIA-4Ubuntu Documentation: nixternal * r3785 kubuntu/network/C/network.xml: added some network content06:00
=== medders [n=matt@81.168.72.134] has joined #ubuntu-doc
=== linuxphotogeek [n=will@fw-dcise.ascensionhealth.org] has joined #ubuntu-doc
linuxphotogeeksvn having troubles or is just me?07:39
linuxphotogeekversion 3785 - every file has a status of "unknown"07:40
=== Gwaihir [n=Gwaihir@ppp-43-74.25-151.libero.it] has joined #ubuntu-doc
=== jwhitlark [n=jwhitlar@h-67-102-70-2.snfccasy.covad.net] has joined #ubuntu-doc
Gwaihirquick question: has the translate.sh script been obsoleted?09:23
=== WaterSevenUb [n=WaterSev@242-222.dial.nortenet.pt] has joined #ubuntu-doc
=== penguinbrat [n=penguin@cpe-67-9-113-12.satx.res.rr.com] has joined #ubuntu-doc
penguinbratHey all - how can I start helping out in documentation?10:12
LaserJockpenguinbrat: do you have an idea of what kind of documentation you are interested in?10:22
penguinbratHi, it would mainly be for the apps that come with ubuntu, for example KDE10:24
LaserJockok10:25
LaserJockwell, a lot of that's done by the upstream documentation team (like the KDE doc team)10:26
LaserJockbut we do a fair amount to sort of pull it all together10:26
LaserJockpenguinbrat: an HTML version of the current "in progress" documentation for Kubuntu can be seen at http://doc.ubuntu.com/kubuntu/C/index.html10:27
penguinbratIs that the standard for distro's - is to mainly go off what the individual teams put out? Teams as in those actually developing the product...10:28
=== Madpilot [n=brian@ubuntu/member/madpilot] has joined #ubuntu-doc
LaserJockto a large extent yes10:32
LaserJockmost distros don't write a lot of documentation for specific apps themselves10:32
LaserJockmore like "How do I do ...?"10:32
LaserJockdoes that make sense?10:32
penguinbratYeah, but it is just getting to old having to go to the internet and search for how to do somethihng - even if it is as simple as adding a contact in the address book.10:34
LaserJockwell sure10:35
LaserJockthat should be on your computer10:35
LaserJockeither written by the software authors or the distro doc team10:36
LaserJockI'm just saying that there are two levels of documentation involved10:36
LaserJockone is the applications themselves, and we don't really handle that (although it is still interesting to us)10:36
LaserJockthe other is the distro level, (what applications to use, how to get software, etc.)10:37
LaserJockand that's what we mostly do10:37
penguinbrathmm, well here is where Im coming from...10:37
penguinbratUbuntu rocks in numerous ways, and the apps on Linux rock in numerous ways10:38
penguinbratbut for someone who is not technicallys inclined - just knows how to point and click10:38
penguinbratwould obviously really rely on documentation - All distro specialize in one thing or another -10:39
LaserJocksure10:40
penguinbratwith there own graphics and everything, giving the look and feel - why couldn't the distro take up the slack in the documentation arena10:40
=== xipietotec [n=jackfros@cpe-67-49-247-144.dc.res.rr.com] has joined #ubuntu-doc
LaserJockoh sure10:40
LaserJockwe do quite a bit10:40
LaserJockwe just let applications authors also do their part10:41
LaserJockso for you, you might end up working with both the Ubuntu doc team and the KDE doc team10:41
LaserJockdid you look at that url I gave you?10:41
penguinbratyeah - and for an example, would be following the link to some of the games - it just gives a discription of what it is, not how to play it10:42
LaserJockright10:42
LaserJockwe rely on the game authors to work on their documentation10:43
LaserJockwe can certianly help10:43
LaserJockbut it can become quite tricky10:43
LaserJockas we have several thousand different programs10:43
LaserJockwe don't have the resources to document everythig10:44
LaserJockthe wiki certainly helps10:44
LaserJockbut we are nowhere near having full and usable documentation for every app10:45
penguinbratofcourse, but we goit to start somewhere - I'm just thinking that the Docs is the one place LInux has always seriously lacked in, most developers are not that great in documentation10:45
LaserJockand as most apps are used in a variety of distros it makes sense that the documentation for them would be done not at the distro level, but at the application level10:46
LaserJockpenguinbrat: sure, I agree10:46
LaserJockso hop on board and help out :-)10:46
penguinbratGive me an app or something to document =)10:47
LaserJockgive me what you are interested in :-)10:49
penguinbratMy thinking on doing it for the distro level is 1) give one team to deal with instead of dozens, and 2) I would think it would be the same as everything else - once we do it, the developers/other distros can snag it also...10:49
LaserJockwell, yes and no10:49
LaserJockat this point the answer simply is that we don't have the resources (manpower) to do it10:50
LaserJockbut there's certainly nothing wrong with working with software authors to get better documentation10:51
penguinbratdon't get me wrong, I would expect that there aren't a lot of peeps wanting to do this - thats where I was getting at with starting somewhere =)10:51
LaserJocksome of the issue is that sometimes software authors get a little upset when we just go messing around with their stuff10:51
LaserJockKDE has a pretty extensive doc team10:52
LaserJockif you want to work on KDE apps that's the place to go10:52
LaserJockwe also have Kubuntu people in the doc team10:52
LaserJockfor the distro-level docs10:52
LaserJockso it's all there10:52
LaserJockjust not all at one place10:52
penguinbratKDE (or any developer) would really get upset if distro X spent some time and filled in all the gaps?10:55
LaserJockyep10:57
LaserJockthe do it with the software10:57
LaserJock*they10:57
LaserJockthey do it with the translations10:57
LaserJockit's just the nature of things10:57
LaserJockI mean, we can certianly work with the software authros10:58
LaserJock*authors10:58
LaserJockbut distro and application level documentation is seperate10:58
LaserJockto change an applications documentation you have to change the applications source and packages10:59
LaserJockthe distro documentation is all in one package10:59
penguinbratNo wonder documentation is so lacking under LInux =( Why would documentation not be treated the same way as the code itself?10:59
LaserJockit is10:59
LaserJocksame thing happens with code10:59
penguinbratforking?10:59
LaserJocknot forking11:00
LaserJockbut people get a bit upset when the distro starts adding and subtracting code11:00
LaserJockwe try to have good communication and send patches back and forth11:00
LaserJockand that can certainly be done with documentation too11:00
LaserJockok, so lets do a thought experiment here11:01
LaserJocksay you want to improve the konsole documentation11:01
LaserJockwhat would you do?11:01
penguinbratThat is what I'm referring to - I'm not talking about rewriting everything just write the stuff and of course give it to them for review and everything.11:01
LaserJockhow would you do it?11:02
LaserJocksure, I'm saying that can be done11:02
LaserJockbut coordinating with the app's authors11:02
LaserJock*by11:02
LaserJockwe just don't do a lot of that because, as I said, we don't have the resources11:02
LaserJockbut you are more than welcome to do it11:03
penguinbratI'll give it a shot - and I understand about the resources, that's why I'm stepping up =)11:04
penguinbratI don't want to rewrite anything, anything is better than nothing =) Would you recomend starting with a particular app, or just see what is out there - or rather not out there?11:07
LaserJockI would say look at something you really  like using11:08
LaserJockbut doesn't have very good documentation11:09
penguinbratcool11:09
nixternalOK you GNOME freaks, quit sabotaging my Kubuntu documentation build process :)11:13
nixternalI swore I fixed that before, and now it isn't building again. Ahh more work11:13
LaserJocknixternal: btw, did you seem my license commits for ubuntu docs?11:13
nixternalLaserJock: I just did a quick "Call for Help" blog as well as some Wiki explanation to help fix the previous post by Mike Stemle11:13
nixternalLaserJock: not yet, I just got home11:14
nixternalif you want, fix Kubuntu's as well while you are at it :)11:14
LaserJockI was going to let you ;-)11:14
nixternalI have to do some quick chores, then I will be doc hacking11:14
nixternalMy Lord, I have way to much doc work to get finished in a month11:14
LaserJockI just didn't want to change the license without confirming that it was indeed changing11:14
nixternalahh11:14
nixternalCC-by-SA it is11:15
LaserJock2.0 or 2.5? :)11:15
nixternal2.5 I think11:15
nixternalI don't follow CC licensing all that much, so I am just following along on this one11:15
nixternalI went to Fry's today, a huge electronics store. They sell Freespire/Linspire desktops and laptops11:16
nixternalthat rocks. Soon they will be Kubuntu based!11:17
nixternalAs soon as they come out, I will go buy one just to support the effort11:17
nixternalI gotta go do some work and quit procrastinating11:17
nixternalbbiaf11:17
penguinbratIs there suppose to be help documentation for the Adept Installer?11:41
LaserJockI think there is work being done on it11:42
LaserJockwe did have an adept guide11:42
LaserJockthat I think is being turned into the app documentation, or something like that11:42
penguinbratk11:44
nixternalpenguinbrat: jjesse is working on it for upstream12:12

Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!