/srv/irclogs.ubuntu.com/2005/06/26/#ubuntu-doc.txt

squinnmdke, how are those minutes coming ^^? lol12:10
squinnOh, up, cool.12:11
JonAsquinn: On the mainling list, or online?12:12
JonA*mailing12:12
squinnOnline, JonA.12:12
JonAsquinn: Thanks.12:13
squinnhttps://wiki.ubuntu.com/DocumentationTeamMeetingSummary512:14
squinnhttps://wiki.ubuntu.com/DocumentationTeamMeeting20050616 as well12:14
=== Seveas [~seveas@seveas.demon.nl] has joined #ubuntu-doc
squinnWelcome back, Seveas.12:18
Seveasty12:18
mdkeooh is the list back?12:30
mdkeon12:30
mdkedamn, still nothing12:30
Seveaswas just gonna say it ;)12:31
Seveaswhat's up with the lists anyway?12:31
mdkehow are ya Seveas 12:31
Seveasnot too bad12:31
Seveasbeen manually compiling C code today (and that means manually writing assembly crap)12:32
Seveasso i'm kinda cooked :)12:32
mdke*grins*12:32
=== Burgundavia [~corey@S0106000000cc07fc.gv.shawcable.net] has joined #ubuntu-doc
squinnmdke, sorry I had to leave meeting. I can volunteer for some projects..if I'm neeed.12:34
squinnneeded.*12:34
mdkesquinn, that is cool. Check out the docteam wiki pages and the archive see what interests you12:35
mdkehi burgs12:35
Burgundaviasalut12:35
Burgundaviaanyone else got got by NMs cute little bug?12:36
mdkesup?12:36
squinnmdke: In general, I'd be looking at a GNOME Project. Right now, '12:38
squinnI'm over-abundant on time, so I'm not in a crunch*12:38
mdkesquinn, great12:43
squinnmdke, I also just added Install Guide to DocTeam Projects.12:44
squinnTenatively, I put No Info Page, No Status Page, and No Preview.12:44
mdkeok i see it12:45
mdkecool thanks12:45
squinnNot a problem.12:45
squinnmdke, question12:49
squinnwait, maybe nevermind12:50
squinnmdke, is there a way i can subscribe to all bugs assigned to ubuntu-doc?12:53
=== JonA [~jonathan@alxpc1jaa2.alx.aber.ac.uk] has joined #ubuntu-doc
mdkesquinn, to be honest we don't tend to use bugs much01:24
JonAmdke: Are you free for me to ask some questions about the GNOME docs?01:27
mdkegimme a bit01:30
mdkeJonA, just need to tidy something up01:30
mdkeJonA, gonna be around in 15?01:30
JonANo rush :-)01:30
JonAmdke: Yeah.01:30
mdkewhat time zone is wales in?01:30
mdke:p01:30
JonAGMT, so it's 12:36 am here :-)01:36
mdkehere I am!01:43
mdkeJonA, i'll try and answer your questions, but I am no expert01:44
squinnJonA? 01:46
JonAmdke: They're not really technical questions :-) I was just wondering what would be the best way to go about tackling the GNOME guide. Are there any sections which are flagged for revision, or is there a general consensus (which I've missed) of how it needs to be updated?01:46
JonAsquinn: Yo?01:46
mdkeJonA, the userguide or quickguide?01:46
mdkefor the userguide, essentially the thing is pretty disorganised, there are lots of sections that haven't been written, and others that need revision01:48
JonAThe userguide.01:48
mdkefor the quickguide, since it was shipped for hoary, its a question of updating, and no plan has yet been done (to my knowledge) about that01:48
mdkeaha01:48
JonAShould I just grep around for authorblurb sections and see what I find?01:48
mdkeJonA, if you feel up to starting to write sections that are not yet done at all, that would be awesome01:49
mdkeJonA, ideally sections get marked with "done/to revise" etc but the problem is that different authors have different ideas about when that stage is reached ;)01:50
mdkethe userguide is so young right now that i don't think we need to worry too much01:50
mdkeit ALL needs revision ;)01:50
mdkein general, the earlier sections are better done than the later ones01:50
JonAmdke: Right, I guess I'll have a stab at some of the sections which haven't been started.01:51
mdkethat would be awesome01:51
mdkeJonA, couple of things to bear in mind are that there is plenty of info to draw on in the wiki/forums, and that the user target of the guide is beginner01:51
mdkeotherwise, run amok01:52
mdkeJonA, you can open the xml files in yelp to read through what is already there01:52
JonAOkay, well, I'll try to write a couple of sections tomorrow and get a patch up. If I'm doing anything terribly wrong, I'll find out early.01:52
mdkeyep01:52
mdkeif you follow the basic procedure you won't go wrong01:53
JonAmdke: Yeah, I've checked it all out and I've been playing about, seems simple enough.01:53
mdkehttps://wiki.ubuntu.com/DocteamStepByStepRepository is good01:53
mdkeif you validate and check your work visually as described there, you are good to go01:54
squinnmdke, I think I'll work [lead if needed]  on the About Ubuntu page01:54
mdkesquinn, cool01:55
mdkehopefully not a lot will change for breezy so that document will just need updating01:55
=== gepatino [~gabriel@200.68.127.46] has joined #ubuntu-doc
mdkewhen the mailing list is sorted we can start organising that stuff01:58
mdkehi gepatino 01:59
gepatinohi01:59
gepatinojust looking01:59
mdkewelcome :D01:59
gepatinoi'd like to help somehow in the ubuntu project02:00
mdkecool!02:00
gepatinoright now i dont have much time02:00
gepatinobut i'd like to know what options do i have to help02:01
mdkeooh lots of things02:02
mdkeyou can contribute to the documentation writing project in our archive or on the wiki, or help people on the forums, or help people here in irc in #ubuntu02:02
mdkeor on the mailing list02:03
gepatinoi've been helping with translations into spanish (my primary language)02:03
mdkethats another great way02:03
gepatinobut it's almost anything already translated :)02:03
mdkedo you work with the spanish locoteam to get translations done?02:04
gepatinono, i've just entered in the rosetta site and translate when i have some free time02:05
mdkebefore breezy there will be lots of documentation to be translated :)02:05
mdkeah good idea02:05
gepatinommm sounds good02:05
mdkegepatino, some of our existing documentation is in rosetta02:05
mdkebut hopefully lots more will be for Breezy02:07
gepatinoshould i belong to the spanish translation group to make my stranslations effective?02:08
gepatinoi've applied to that group, by haven't got any answer yet02:09
mdkeno no02:09
mdkeall translations in rosetta are effective02:09
gepatinook, i'll take a look again in rosseta02:10
gepatinothanks for your time02:11
mdkeany time02:11
gepatinosee you02:11
mdkeyeah02:11
mdkebye!02:11
=== gepatino [~gabriel@200.68.127.46] has left #ubuntu-doc []
mdkenight all02:23
=== FLeiXiuS [~fleixius@pcp0011790326pcs.essex01.md.comcast.net] has joined #ubuntu-doc
=== jsgotangco [jerome5@dialup-222-126-74-185.infocom.ph] has joined #ubuntu-doc
=== ealden [~ealden@219.90.91.99] has joined #ubuntu-doc
=== _jeff [~jeffsch@fatwire-201-201.uniserve.ca] has joined #ubuntu-doc
=== gtaylor [~gtaylor@24-158-66-230.dhcp.spbg.sc.charter.com] has joined #ubuntu-doc
gtaylorhowdy08:22
=== froud [~sean@ndn-165-146-74.telkomadsl.co.za] has joined #ubuntu-doc
froudAfrican greetings08:34
robitailleCanadian Greetings08:44
robitaillea lot of interesting discussions on the channel in the last 24 hours.  I finally went throught the backlogs earlier today08:46
froudAh yes08:46
froudvery interesting08:46
froudhow do you feel about them?08:46
froudIts ok if you think I am totally out of wack, honest08:47
froudmorn gtaylor 08:47
froudmorn JonA 08:48
froudBurgundavia: 08:48
robitaillepersonally I think it makes sense to do everytnig in xml, and from that source produce in whatever format is needed for packaging.08:48
froudHmm is lists.u.c is still not working08:49
froudrobitaille: OK08:49
robitaillestill down.   It's getting a bit annoying.  They filled up a hard drive many hours ago; I wonder why it hasn't been cleared yet08:49
froudI guess it takes time08:50
robitailleMaybe they will rush in the transition to the new lists.ubuntu.com that was supposed to be done shortly anyway.08:50
froudmaybe08:50
robitaillesystem problems often occurs on Friday nights :)08:50
froudI see the logs are also stuck08:51
froudyeah, typical08:51
froudrobitaille: are you now setup and ready for work? I cant remember08:51
robitailleyes.  I just haven't found the time yet.  But I have been pulling in updated stuff from the repo from time to time to look at them.  So I'm all setup; I just need to get myself in gear to do something :)08:53
froud:-) yeah08:53
froudsometimes that can take time08:53
froudwe need you to do a few god patches08:53
froudgood08:53
froudthen we can get you a commit account08:54
robitailleAnd I still want to sit down to read that Docbook Guide you sent earlier.08:54
froudWhich Bob Staytons book?08:54
robitailleyes08:54
froudOh most excellent08:54
froudI think everybody on the team should read it08:55
froudbut its a big book, lots to undersatnd08:55
froudBokker tov sivang 08:55
froudrobitaille: but that should notstop you from writing08:56
froudif you know what it is you want to write that is:-)08:56
robitailleI know.  The guide is for my personal learning enjoyment.  I had no idea about all these documentation things only a few weeks ago;  and I have been working with computers for years.08:57
froudJonA: if you have time I can help you get setup08:57
robitailleOnce I have a good knowledge base, I want to push a more organized way of doing docs at my workplace.08:58
froudyeah, docbook is a blessing and a curse all the same08:58
froudrobitaille: workplace08:59
robitailleI'm back (one of my kid got up).  Yes; I work for a research group of the Canadian government, and ours docs are a bit disorganized; some done in text, some done with latex, some with framemaker09:02
robitailleand some in html09:02
froudAh yes I remember now :-)09:03
=== _froud [~sean@ndn-165-146-74.telkomadsl.co.za] has joined #ubuntu-doc
_froudargh split09:04
robitaillewe're small enough (~25 staff) that it should be easy to steer the few of us who need to write things in a certain direction..thus the docbook reading09:04
froudyeah, It can work well for the technical docs09:05
=== FLeiXiuS [~fleixius@pcp0011790326pcs.essex01.md.comcast.net] has joined #ubuntu-doc
JonAfroud: Morning. I've pretty much got myself set up, I think. I've checked out the tree, and I've been playing with making some edits and patches.01:36
=== ealden [~ealden@219.90.92.252] has joined #ubuntu-doc
mdkeemail is now trickling in slowly02:38
mdkesquinn, around?03:58
squinnyep, mdke 05:07
squinnor..i wasn't lol05:07
=== robitaille [~robitaill@d154-5-117-228.bchsia.telus.net] has joined #ubuntu-doc
mdkesquinn, np i replied on the list06:10
robitaillemdke,  to answer your question in your email about the minutes to the last doc meeting and where they should be sent, you should just ask mako to give you access to -news.  He did that semi-recently with dholbach for the MOTO reports. 06:23
mdkerobitaille, i mentioned it to him yesterday, i'm not sure if he is gonna post it himself06:23
robitaillemaybe this time...but in the future you probably want to do it yourself.  He is so busy, it's probably the best way for the emails to be sent in a timely manner06:25
mdkeyes06:25
mdkeI would have thought he would say that06:25
mdkewe'll see what he thinks06:25
robitailleand of course all these reports will one day be available on "The Fridge" :)06:26
mdkehmm06:27
mdkei need to check that out06:27
mdkeis there a testing project? or just the spec06:27
robitailleit's still mostly a spec.  jdub has a live site going on his own server, but it's still pretty basic, and a work in progress.06:33
robitailleit's nice to finally have e-mails back from the lists :)06:33
mdkehave you got a url for it?06:34
jdubif you post to -news, mako or i will moderate it through06:34
jdubmdke: it's not public yet06:34
mdkejdub, ok cool06:34
mdkejdub, is -news the appropriate list?06:35
jdubsure06:35
mdkeok06:36
mdkethanks :)06:36
=== froud [~sean@ndn-165-146-74.telkomadsl.co.za] has joined #ubuntu-doc
=== squinn [chaos@68.205.198.0] has joined #ubuntu-doc
=== Seveaz [~seveas@seveas.demon.nl] has joined #ubuntu-doc
=== squinn [~squinn@68.205.198.0] has joined #ubuntu-doc
squinnmdke, I'm here.07:54
mdkesquinn, hi07:55
squinnhey07:55
squinnmdke, you were looking for me earlier/08:08
mdkesquinn, yes, I replied on the list :)08:09
squinnah, ok, lemme take a look08:11
=== buzzle [~adsfase@pcp04528012pcs.valenc01.az.comcast.net] has joined #ubuntu-doc
buzzlehey everyone08:17
squinnHey buzzle 08:18
buzzleim having trouble connecting to my lan in ubuntu08:18
buzzlesuggestions?08:19
buzzleusing wireless08:19
squinnhm08:22
squinni'd suggest #ubuntu08:22
squinnbut h/o a sec08:22
buzzlejust found it08:22
buzzlethank you08:22
squinnoh ok 08:23
squinnenjoy buzzle 08:23
buzzlethank you :] 08:23
squinnyeah, be specific'08:24
squinnwhat card..what drivers..that kinda stuff08:24
buzzlei see08:24
squinnbuzzle, because some one who has no idea of the card can't give help08:24
buzzlei guess i was looking for basic set up info to start with08:25
buzzleits not so much that my card is being an issue yet, as i cant figure out a basic set up to even see08:25
squinnah ok08:25
squinnmdke, i don't see it?08:25
squinni did get two messages from ubuntu-doc thouhg08:25
squinnubuntu-doc-bounces ?!08:26
froudHmmm, where can I post a document on the xml or html debate?08:33
=== JonA [~jonathan@alxpc1jaa2.alx.aber.ac.uk] has joined #ubuntu-doc
mdkefroud, mailing list08:34
mdkesquinn, are you subscribed to the mailing list?08:35
froudis it working08:35
mdkeyes08:35
mdkesquinn, its definitely there (http://lists.ubuntu.com/archives/ubuntu-doc/2005-June/002583.html). perhaps you are not subscribed08:36
mdkefroud, it is definitely working08:37
froudyes I just tested, thanks08:37
=== gtaylor [~gtaylor@24-158-66-230.dhcp.spbg.sc.charter.com] has joined #ubuntu-doc
=== gtaylor [~gtaylor@24-158-66-230.dhcp.spbg.sc.charter.com] has left #ubuntu-doc []
=== gtaylor [~gtaylor@24-158-66-230.dhcp.spbg.sc.charter.com] has joined #ubuntu-doc
gtayloraroo08:43
squinnI saw it finally, mdke.08:44
squinnOn web..thanks.08:45
squinnHere comes my confirmation email from mailing list.08:45
squinnI was subscribed, but not approved yet, I believe.08:45
squinnmdke, thanks i'm fixing patch now08:47
gtaylorLooks like things have been busy this weekend08:47
squinngtaylor, yeah. yesterday, seemed like lists were off or i just didn't get them08:50
squinnso i'm extra busy now08:50
mdkelists were down yesterday08:50
mdkehey gtaylor 08:51
squinnmdke, question08:51
squinnis it possible to have all mail previously [for example: all conversations in the month of june]  sent to list sent to my inbox?08:52
mdkenot as emails, but you can get them in a news reader08:53
mdkehttp://news.gmane.org/gmane.linux.ubuntu.doc/08:53
squinnah okay08:53
mdkeor can you just view them in a browser from that link08:54
squinnright ok08:54
squinnlike how i read your mail08:54
squinnmdke, proofread the patch, sending now09:02
mdkecool09:02
squinnsent09:04
=== Njal [~chatzilla@dsl-80-46-140-184.access.as9105.com] has joined #ubuntu-doc
NjalLo09:04
squinnhey Njal 09:07
NjalI was on here yesterday seeing how i might be able to try to help with the documentation project09:07
squinnWell, I'09:08
squinnI'm not in charge, but I think I am [hehe] 09:08
squinnWhat would you want to work with?09:09
froudhey Njal 09:09
squinnAgain, I'm not in charge..I'm just curious.09:09
Njalfroud told me that i would need setting up with the cvs system you use09:09
squinnsvn09:09
squinnsubversion, yes.09:09
Njalyup09:09
squinnI don't even think I've set mine up.09:09
Njali presume i apt-get it?09:09
squinnUnless that's StepByStep thing was setting it up09:09
squinnapt-get install subversion does the binaries yes09:09
froudNjal: read this https://wiki.ubuntu.com/DocteamStepByStepRepository09:10
squinnOh, I did set it up then. :D09:11
squinnhey, froud, can you do me a favor?09:11
froudyep09:12
squinnproofread the patch i just sent out on list09:12
froudNjal: you should install xsltproc09:12
froudwill do, was it applied09:12
squinnno09:12
squinnmdke said it was pretty much there, just had to change a few things09:12
froudOk09:12
squinnI'm with Njal as well, in the n00b boat.09:13
=== sivang [~sivang@box79162.elkhouse.de] has joined #ubuntu-doc
froudOk will look at it09:13
squinnThanks froud09:14
froudsquinn: Njal: hav eyou both installed xsltproc09:14
froudyou also need to ensure docbook is installed09:14
froudas well as docbook-xsl09:15
squinnyes, all three installed here09:15
froudinstall also poxml from kdesdk09:15
squinnironically, just installed docbook-xsl..and okay09:15
froudsee also http://wiki.ubuntu.com/ForTheHasty09:16
squinnthere, froud 09:18
froudyes09:18
froudjust about to read your patch09:18
=== Njal [~chatzilla@dsl-80-45-186-84.access.as9105.com] has joined #ubuntu-doc
squinnok09:20
squinnwelcome back Njal 09:20
Njalthanks net just died for some reason09:20
Njalok subvesion is now installed09:21
Njalsubversion09:22
Njalhow do i use it? Never had to use a versioning system before09:23
mdkethe instructions on the wiki page froud posted should help a lot09:23
Njalkk09:23
froudsquinn: patch applied09:36
froudthanks09:36
froudsquinn: did you ask questions about LearnLinux?09:37
squinnNo.09:38
squinnThat's another Sean09:38
squinnI'm Sean D. Quinn09:38
squinnThere's some Sean C. something09:38
froudsorry we now have three Seans, me included09:38
squinnYep.09:38
squinnfroud, I don't understand the second message I was supposed to /ignore09:42
froudyes I fix the things in the first patch09:42
froudand applied &kubuntu-download; and refer to main09:42
squinnah ok works better 09:47
squinnthanks 09:47
froudnp09:48
froudsquinn: what are you going to work on?09:48
=== Njal [~chatzilla@dsl-80-43-165-70.access.as9105.com] has joined #ubuntu-doc
froudNjal: how's it going09:50
Njalfinally back09:50
Njalgood09:51
froudhow far did you get09:51
NjalI got subversion installed09:51
froudok09:51
frouddi you get a checkout09:51
NjalI was also pointed to the wiki for further instruction09:51
froudok09:52
froudyou want to go through it09:52
Njalyes as im still not quite sure how to use a versioning system09:53
froudok in your home dir do svn checkout https://docteam.ubuntu.com/repos ubuntu-doc09:53
froudhold09:54
froudin your home dir do svn checkout https://docteam.ubuntu.com/repos/trunk ubuntu-doc09:54
froudthis will create a directory called ubuntu-doc/09:54
Njalit didn't09:54
froudit will add a working copy of the files in trunk to this folder09:55
Njaloh wait09:55
froudgive it time09:55
froudthe first checkout is big09:55
Njalit was asking me to accept something like a cookie that's why i didn't see it doing anything09:55
Njalit wasn't a cookie09:55
froudare you in a shell session09:55
Njalyes09:55
Njalbash09:56
froudok select to permanently add it09:56
NjalI did do, it was a case of not reading something carefully09:56
froudok09:56
froudgive it a minute and you will see may lines starting with A09:56
NjalMMMMMMMMMMMAAAAAAAAAAAAAAAAANNNNNNNNNNNNNNNNNNNYYYYYYYYYYYYYYYYYYYY is right09:57
froudOK that is the working copy downloading to the ubuntu-doc folder09:57
Njallotsa .pngs though09:57
froudyes09:57
NjalSo lemmie just get my heard around this09:58
Njalhead09:58
froudok09:58
froudwhat you are copying to your disk is a copy of the code we all collaborate on09:59
NjalI am downloading everything that has ever been done on the documentation project, and like all other versioning systems only one person can work on one file at any one time?09:59
froudnot quite09:59
Njalok09:59
froudyou are copying the HEAD version09:59
NjalWhats that then?09:59
froudthat is the current revision09:59
Njalok10:00
froudeach of us has a copy10:00
froudwe hack our local copies10:00
froudthen we upload to the repository10:00
froudif you have a commit account then you do this directly using the svn commit command10:00
froudif you dont then you create a patch10:01
NjalOk am lost now10:01
froudand send it to our mailing list10:01
froudOk where did I lose your10:01
froudyou10:01
Njalthe commit account bit10:01
froudOK you dont have one at present10:01
Njalno10:01
froudbut if you are serious and give us a few patches we will arrange an account for you10:02
frouduntil then you will be expected to create patches10:02
froudI will lead you through this procedure10:02
froudwhen the checkout is complete10:02
froudI will also show you how to update your working copy or sync it with the repos10:03
NjalOk so if i submit enough work to make it worthwhile giving me an account i get one, until then i just submit, the hacked local copies via email?10:03
froudyes10:03
Njalok it's starting to make sense10:03
froudhow's that checkout doing, is it finished10:03
Njalnot yet10:04
Njalonto the gnome stuff now10:04
froudOK10:04
NjalHow do i edit these local copies?10:04
froudI will explain it10:04
Njal... in good time :P10:04
NjalOk best way really10:04
froudI take it you are new to this and have also never used docbook10:05
froudbut dont worry10:05
froudits easier than it sounds10:05
froudjust takes the will from you to learn it10:05
Njalyes, this is all very new to me, to be honest i think i am trying to find my place in the community10:05
froudwhat is your background10:05
Njali have just finished a Diploma in IT practitoners (software dev), and am going on to learn networking/networked programing (software dev and deployment accross networks)10:06
NjalBut10:07
froudanyone can contribute to the docs, but knowing their background can help us in pointing you to work10:07
NjalI'm not that good at programming yet10:07
froudOk so you have technical knowledge10:07
froudhows your knowledge of Linux10:07
NjalHistorically i think it's reasonably good, but the working of it, getting there, still trying to learn how to recompile a kernel, just for the experience10:08
froudI think you will do just fine10:08
Njalthanks10:09
frouddoing docs is a great way to learn10:09
froudI think we are all learning in one way or another10:09
NjalI can see how it would be10:09
NjalThe more i learn the more i realise i know nothing10:09
froud:-) yeah10:10
NjalChecked out revision 1184.10:10
froudbeautiful10:10
froudok just gimme a sec b 4 we go on10:10
Njalsure thing10:10
froudOk have you subscribed to the commit list?10:12
froudhttp://lists.ubuntu.com/mailman/listinfo/ubuntu-doc-commits10:12
froudNjal: ?10:13
Njalnot yet am going there now10:13
froudOk let me know when you have confirmed your subscription10:14
Njalis this a mailing list... of sorts?10:15
froudyes10:15
froudeach time one of the members with a commit account adds something to the repos it will send out an email message10:16
froudyou never post to this list, only get stuff from it10:16
froudyou will see what I mean once you have subscribed10:16
froudhave you?10:16
froudlet me know when done, I need to know so I can demo for you10:17
Njali am now subscribed10:18
froudyou confirmed your subscription?10:18
Njalyup10:18
froudok I am now going to make a commit10:19
froudI am just commenting out a peice of code that is not critical10:19
froudOK I did the commit. Refresh your mail client10:20
NjalModified:10:20
Njal   trunk/kde/kquickguide/C/kquickguide.xml10:20
froudOK that message shows you what ws changed10:20
froudthis list is useful because it lets you know when things change in the repos10:21
froudwhen someting changes in the repos you must update your working copy10:21
froudso10:21
froudare you in your home dir?10:21
froudif not do cd ~10:21
froudthen do cd ubuntu-doc10:21
froudnow issue the command svn up10:22
Njalyup sync'd10:23
froudOk now you know how to get updates from the repos10:23
Njaljust svn up?10:23
Njalwhen i get an email?10:23
froudyep10:23
froudyep10:23
froudeasy10:23
Njalok i think i can manage that10:23
froudright next10:23
Njalyes?10:24
froudareyou using gnome or kde?10:24
Njalgnome10:24
froudOK I want you to now edit a file10:24
froudto do this10:24
Njalyes?10:24
froudcd kde/kquickguide/C10:25
froudls10:25
froudkquickguide.xml10:25
froudyou see the file I updated10:26
frouddo gedit kquickguide.xml10:26
froudThis will open the file in gedit10:26
froudat the top of the file you will see this10:27
Njalyup i know that10:27
froud<!--<subtitle>10:27
froud<inlinemediaobject>10:27
froud<imageobject>10:27
froud<imagedata10:27
froudfileref="../../images/&language;/kubuntu-final.png"10:27
froudformat="PNG"/>10:27
froud</imageobject>10:27
froud</inlinemediaobject>10:27
froud</subtitle>-->10:27
Njalyes i see the bits you mean?10:27
Njalmean10:27
froudI want you to delete the <!-- at the begining and the --> at the end10:28
froudthen save10:28
Njaldone10:28
Njalsvn commit by chance?10:28
froudOk close gedit10:28
froudno10:29
Njalok10:29
froudyou dont have a commit account yet ;-)10:29
froudwhen you do then yes10:29
froudsvn diff kquickguide.xml > kquickguide.xml.diff10:29
froudthen ls10:29
froudls10:29
froudkquickguide.xml  kquickguide.xml.diff10:29
Njalyup its created a diff(erences?) file?10:30
froudexactly send me that to sean@inwords.co.za10:30
froudin future however you will send it to the docteam user list10:30
frouddid you send it10:31
NjalYes10:31
NjalJust this second10:31
froudOK now when Iget it I will apply it10:32
froudand you will svn up again10:32
Njalare all the doc's in .xml?10:32
froudyes10:32
frouddocbook10:32
NjalCoz i don't know xml10:32
Njal:(10:32
froudthat's also OK10:33
froudyou will learn10:33
froudfollow the markup around you10:33
froudI will track your patches and make fixes to the sematic10:33
NjalThat's the thing i don't understand much of the markup languages10:33
froudover time you will get to know it10:33
froudOK so you can do reading at http;//www.docbook.org10:34
froudand we will help you10:34
froudreally it is not that hard10:34
froud;-)10:34
froudyou just edited a file and sent it to me10:35
froudnow if I had applied the patch, you would get an email from the commit list10:35
NjalYes i understand the transfer of files etc, it's xml i don't understand, i will have a look at this site though10:35
froudand you just cd to ubuntu-doc/ and do svn up10:35
frouddont worry about the xml10:36
froudyou just worry about writing and do your best with the xml10:36
froudwe will fix it10:36
mdkewell...10:36
mdkeits a good idea to learn as you go10:36
NjalIm sorry i miss the writing principle here, let me look at that edited file10:36
froudsure, take a look at the markup, it will make sense10:37
mdkeNjal, but its easy, you'll pick it up by playing with the files, and checking them after you edit with the validate script and visually, as described in the wiki document10:37
froudmost of the tags are natural10:37
NjalOk so we have content, i presume that it's meant to be viewed in a webbrowser?10:37
froudNjal: mdke is right10:37
froudno10:37
Njalok10:38
froudNjal: XML is presentation neutral10:38
froudhowever, I think you will find that Yelp is a good help for you at this point10:38
mdkeit can be made into many things, html, pdf, or stay as it is to be viewed by certain clients10:38
froudso I would like you to do yelp kquickguide.xml10:38
NjalSo10:38
NjalXml is umm.. clay10:39
Njalthat can be moulded into whatever10:39
mdke:)10:39
froud;-) one way to see it10:39
froudNjal: did you yelp the file?10:40
NjalYeah i really need to grasp what happening before i try anything, so we write an xml file that gets turned into a usefull file10:40
Njalno 10:40
Njalworking on it10:40
froudOk tak eyour time10:40
froudyou cant break anything10:40
froudso dont be afraid of it10:40
froudand i you edit a file and think you have really botched it10:41
NjalSo yelp presents the xml file in a human readable way?10:41
froudwhat can you do10:41
froudyes10:41
froudif you both a file then just use the revert command 'svn revert file.xml'10:42
NjalRight, i think the next few days are going te be hello world xml things10:42
squinnah, i didn't even know that about reverting..thanks froud 10:42
froudthat will return your working copy file back to the copy in svn10:42
froudsquinn: np10:42
squinnfroud, now that i'm back from yard work, here's my question10:43
froudNjal: but you will lose any change you made in that file10:43
squinnwhat can one do to find patchable things?10:43
squinni mean, sure, i was already working on the about ubuntu guide10:43
froudHmm, Idont understand?10:43
Njalyeah but if it's botched...10:43
squinnNjal, it goes back to the one from the web10:43
froudNjal: yes exactly10:43
=== _jeff is now known as jeffsch
squinnfroud, how can I find things to patch?*10:44
froudsquinn: yu mean what can you work on?10:44
mdkesquinn, everything needs work10:44
squinnyeah.10:44
froudwell we have breezy targets10:44
squinni mean, that kubuntu thing came upon me while i read and was working on the About Ubuntu guide.10:44
mdkekeep reading and you'll find more10:44
squinnfroud, true, but those can't be svn commited until breezy's almost ready for release10:44
jeffschuser guide user guide user guide user guide :)10:44
squinnyeah, i noticed some OLD screenshots of user-guide10:45
squinnwarty screenshots10:45
froud;-) jeffsch 10:45
squinnyuck, i must update10:45
mdkejeffsch, +10:45
jeffschhowdy folks10:45
NjalOk another analergy time10:45
froudsquinn: we are working towards breezy10:45
mdkesquinn, screenshots its probably better to leave until later, so we can get breezy shots10:45
froudsquinn: 10:45
froudone problem10:45
NjalIm learning C, and you need the #include <stdio.h> deal 10:45
squinni've got another question, i'll ask in a minute10:46
Njalis this <?xml version="1.0" encoding="utf-8"?> the xml equal10:46
froudsquinn: you are most likely working with hoary10:46
froudNjal: no10:46
froudNjal: see the doc type decl10:46
Njalright10:46
froud<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 10:46
froud"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [10:46
froudsquinn: you have hoary on your computer10:47
squinnfroud, that is correct. i'm using hoary.10:47
froudsquinn: the problem with that is that you can only see what is in hoary10:47
froudso, what to do10:47
froudwell if you have another computer you can install hoary and then just change the sources.list to breezy repos10:48
froudand then you us ethat machine to document10:48
NjalOk well i am going to go for tonight, i've got a fair bit to digest here10:48
froudbut10:48
froudNjal: np c ya10:48
Njalbye, and thanks10:48
squinnfroud, only one usable computer atm10:48
froudsquinn: you can also download the prerelease ISO files10:48
froudthen you use something like qemu10:49
squinnah, good idea10:49
squinnwith qemu10:49
squinndo i just...10:49
froudto emulate linux under linux10:49
squinnqemu "livecdorwhateversmartguysatcanonicaldecidetocalltheiso.iso"?10:49
froudHmm cant remember the commands but see the qemu docs10:49
squinnokay, thanks10:49
squinnman qemu after install?10:50
froudif you get stuck I will type up a tutorial10:50
squinnokay, thanks10:50
squinnwith the emulator..10:50
squinni can't save or download anything though, right?10:50
froudsquinn: the problem with that is that you must wait for prereleases10:50
froudbut at least you can do your work10:50
squinnwhat if10:50
squinni created some partitions for breezyt10:51
froudfor the most part I think you will find that your hoary system is good enough to doucment against10:51
froudsquinn: that is up to you10:51
squinnyeah, that user guide for hoary still needs work10:51
froudyes10:51
froudso you just write abook10:51
froudhave fun10:51
frouduse hoary if you must and as we get closer to breezy we will check it and realign it if needed10:52
squinnwell, breezy's what, not until 5.1010:52
froudyes10:52
squinnit's 5.06 still right now right?10:52
squinnusing ubuntu's system of numbers10:53
froudthat is why I say that you can use hoary10:53
squinnright10:53
froudmany things will be the same10:53
mdkebut later to release it will be a good idea to use the breezy development version10:53
mdkeso you can see any changes10:53
froudyes10:53
froudmdke: yes10:53
squinnat about 5.08, i think i'll upgrade10:53
squinnand right now, all cvs can take is hoary right10:54
squinner, svn*10:54
mdke?10:55
mdkewhat do you mean by "can take"?10:56
squinnum10:56
squinnall that can be handled by svn is hoary documents10:56
squinnmeaning a document written for breezy could not be in svn right now, correct?10:56
jeffschnot correct. anything we work on now is for breezy release10:59
squinnokay11:00
squinni think i'm starting to understand11:00
squinnbut i could still write up say..the user guide..based on hoary..and will update for warty11:00
squinngoing back in time11:00
squinnbreezy*11:00
jeffschyes. when we know better what breezy looks like, then we can make any updates/changes11:01
jeffschit's better to have something to fix, rather than nothing at all11:02
squinnright.11:02
squinnokay, well i'm looking at the quickguide now, i see some errors already11:02
squinnthis is quickguide that comes with hoary11:02
squinnnot in svn11:02
mdkeyou have to work in svn11:03
mdkethings may have already been changed11:03
squinni know, i'm doublechecking11:03
mdkesquinn, best thing is to ignore the old version11:03
squinni am lol11:05
squinnsvn much better version11:05
squinnyet something i don't like11:05
squinn[possible flood warning] 11:05
squinnThe top panel contains the11:05
squinnApplications Menu11:05
squinn,11:05
squinnSystem Menu11:05
squinn, and11:05
squinnPlaces Menu11:05
squinnand those three titles are huge and brown11:05
mdkesquinn, you are free to edit11:05
squinnand it just looks very..off and unprofessional11:05
jeffschthat's yelp's fault11:05
mdkesquinn, best thing is to work on it11:05
squinnah, ok, jeffsch 11:06
squinnand alright mdke 11:06
squinnif there's a workaround, jeffsch..i'd like to at least try to find one11:06
mdkesquinn, that is the least of our worries!! there is much content to sort out11:08
jeffschthe workaround is to not use xrefs with the endterm attribute11:08
squinnfor example: user guide11:08
squinnok11:08
froudhello jeffsch long time no speak11:11
jeffschfroud: howdy dude11:11
froudwhat you been doing11:11
jeffschnuthin. honest. i didn't do it. or at least, it's not my fault.11:12
froud:-)11:12
jeffsch:)11:12
froudI was looking at style guide. good stuff dude11:13
jeffschstill a lotta blanks need filling though11:13
froudyep, but I am sure it will be no problem for ppl here11:13
froudjust needs some time11:13
jeffschgetting them to follow it once it's done...11:14
froudHmm, ....11:14
jeffschmaybe the doc leads, or primary contacts can be responsible for implementation11:14
frouddoc leads?11:15
squinnleaders on certain doc projects11:15
jeffschfrom the meeting https://wiki.ubuntu.com/DocumentationTeamMeetingSummary511:16
froudI dont think there are any yet. 11:16
squinnI intend to lead on About Ubuntu in GNOME11:16
froudmdke: " The install guide is not in the list of projects, this oversight should be corrected ASAP."11:16
froudmdke: the install guide is on th elist11:16
mdkefroud, yes, because it was corrected ASAP11:17
mdkedoh!11:17
froudOh OK11:17
froudmdke: are there doc leads?11:17
mdkenot yet11:18
mdkesome have expressed interest11:18
mdkeit needs to be decided via the ML11:18
froudyes saw that11:18
mdkelisten I will be back later, am in a -it meeting right now11:18
froudML?11:18
froudok11:18
jeffschML = mailing list11:18
froudah11:18
froudk11:18
froudOk I am off for the night, c ya around11:19
jeffschlater11:19
=== froud [~sean@ndn-165-146-74.telkomadsl.co.za] has left #ubuntu-doc ["Konversation]
jeffschwell i have to get some air... 11:21
=== jeffsch is now known as jeff-away
squinnheh, i fixed the little style errors11:25
squinntook away the color, they are hyperlinks now..look a lot more professional11:25
mdkesquinn, have you read the styleguide?11:26
mdkeits important to have consistency throughout our documentation11:26
=== JonA [~jonathan@alxpc1jaa2.alx.aber.ac.uk] has joined #ubuntu-doc
squinnyes, mdke i have11:42
mdkecool11:42
squinnI'm going to submit what I just worked on as a patch.11:44
squinnhow was your italian meeting?11:45
mdkestill going11:45
squinnah11:45
squinnI'm going to try and become a member.11:45
squinnProbably not now..in a little bit.11:46
squinnI think about a month.11:46
squinnSo, mdke do you live in Italy or just speak the language?11:47
mdkejust the language11:47
squinnAh.11:48
squinnThat's awesome.11:48
squinnI know a little here and there.11:48
squinnI actually, just gotta send out this patch and head downstairs and help the mom make meatballs.11:48
mdkeenjoy :)11:49
=== ealden [~ealden@219.90.91.86] has joined #ubuntu-doc

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