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

=== mdke [~mdke@mdke.user] has joined #ubuntu-doc
=== mdke [~mdke@81-178-74-18.dsl.pipex.com] has joined #ubuntu-doc
mdkesorry12:23
=== jdub [~jdub@home.waugh.id.au] has joined #ubuntu-doc
=== froud-away [~froud@ndn-165-128-37.telkomadsl.co.za] has joined #ubuntu-doc
mptI'd agree with this bit though01:52
mpt""One problem with the services model is that it is based on the idea that you are giving customers crap--because if you give them software that works, what is the point of service?"01:52
mptThat's why help keeps sucking, for example.01:52
=== jiyuu0 [~jiyuu0@219.95.244.116] has joined #ubuntu-doc
=== robitaille [~robitaill@d154-5-117-228.bchsia.telus.net] has joined #ubuntu-doc
=== jiyuu0 [~jiyuu0@219.95.244.116] has joined #ubuntu-doc
=== jiyuu0 [~jiyuu0@219.95.240.88] has joined #ubuntu-doc
=== froud-away is now known as froud
froudAfrican Greetings08:34
robitailleand in return, some Canadian greetings08:41
froudhello robitaille , you're new here. Please to meet you :-)08:41
robitailleyeah; I have been hanging around here in the background from time to time.08:42
froudwe have quite a few Canadians here08:42
froudso, are you new to Linux or an old hand?08:43
robitailleactually live in the same town than Corey Burger.  Still haven't met him yet in real life.08:43
froudprogrammer or net admin or writer?08:43
froudthat's cause corey never leaves his computer08:43
froud:-)08:43
robitailleBeen using Linux since late 1990s.  Formally working as a  system admin...now doing it in the evening while I code in Fortran during the day.08:44
froudOh cool, you ever considered helping out on the docs08:44
robitailleI did.  I did review the hardware database application manual for you just before Hoary was released.   And played with the xhtml strict version of ubuntuguide.org a couple of weeks ago when someone wanted to convert it to docbook08:45
froudOh yes, great, now I remember. Thanks for that :-)08:46
froudwell I have ported ubuntuguide.org into docbook so it is now in svn08:46
froudstill needs some work08:47
froudthe port is mostly a manual thing08:47
robitailleI have been doing all sort of little things around  Ubuntu for the last few months;   I'll probably try to help when some of the wiki gets converted using the template you probided the other day08:47
robitailles/probided/provided/08:48
froudGreat, that would be a good help08:48
froudYour a sysadmin, so how about writing for the Admin Guide?08:48
froudThe outline is done08:49
froudof cours eyou are free to change the outline08:49
robitailleI could take a look at it at one point;  I'm not that great of  a writer in the first place, and english isn't my first language. But besides that, I'm sure I could help a bit.08:50
froudwe dont expect shakespear08:50
froudb'side others will edit and reveiw08:51
froudif you see a section you would like to do or feel there is something on the wiki you can port, insert to one of the existing docs are create a new doc, just go for it08:51
froudif the docbook is problematic, we will help you out with that08:52
robitailleis the outline in the svn?08:52
froudyes08:52
froudyou can find it under https://docteam.ubuntu.com/repos/trunk/gnome/adminguide/C08:52
robitaillethanks. got it08:54
froudso you know how to svn then, that's good08:54
robitailleyes; thanks for the great wiki pages for the doc group.  I have been reading a little bit about docbook; I have to write some small doc at work, and I'l probably try to to it in that format as a learning experience.08:55
robitailleI have done html/xhtml in the past, so it's not that foreign in concept 08:56
froudOK, well if you need help just give me a shout08:56
=== Seveas [~seveas@seveas.demon.nl] has joined #ubuntu-doc
=== Seveas [~seveas@seveas.demon.nl] has joined #ubuntu-doc
=== Seveaz [~seveas@seveas.demon.nl] has joined #ubuntu-doc
=== froud is now known as froud-away
mdkemorning all11:01
=== Seveas [~seveas@seveas.demon.nl] has joined #ubuntu-doc
mdkewhat do you guys think about deleting pages without much material on the wiki? I guess we're going to be deleting quite a few pages during the transition... i was looking at http://www.ubuntulinux.org/wiki/QTThemeWithoutKDE11:16
=== enrico [~enrico@enrico.developer.debian] has joined #ubuntu-doc
=== froud_ [~froud@ndn-165-128-37.telkomadsl.co.za] has joined #ubuntu-doc
=== jiyuu0 [~jiyuu0@219.94.80.193] has joined #ubuntu-doc
=== ubuntulog [~warthylog@port49.ds1-van.adsl.cybercity.dk] has joined #ubuntu-doc
=== Topic for #ubuntu-doc: Ubuntu Doc Team - general discussion - backlog at http://irclog.workaround.org | This channel tries to follow the tradition of the #gnome-love channel on irc.gimp.net, all new comers and questions are welcomed, as long as you follow the Ubuntu community code of conduct @ http://www.ubuntulinux.org/community/conduct first.
=== Topic (#ubuntu-doc): set by sivang at Sat Jan 1 20:48:30 2005
=== jiyuu0 [~jiyuu0@219.94.80.193] has joined #ubuntu-doc
jiyuu0finally i removed marillat05:37
KinnisonHeh05:37
jiyuu0and added backports in the main sources.list05:37
Burgundaviasalut Kinnison 05:37
jiyuu0the only thing that will use the marillat is acroread and transcode 05:38
jiyuu0if only backports has it... then can 100% marillat free :)05:38
=== Burgundavia [~corey@S0106000000cc07fc.gv.shawcable.net] has joined #ubuntu-doc
=== jiyuu0 [~jiyuu0@219.94.80.193] has joined #ubuntu-doc
=== jiyuu0 [~jiyuu0@219.94.80.193] has joined #ubuntu-doc
mdke*grins*09:29
mdkejiyuu0, now all you have to do is remove backports :p09:29
jiyuu0remove backports?09:29
jiyuu0i just added it09:29
jiyuu0quite some changes made09:30
jiyuu0but it's worth it09:30
jiyuu0java, azureus, nvu... more updates09:30
mdkeupdates are detested by the ubuntu developers09:32
mdkethey don't pay any attention to packaging policy09:33
mdkebut most users want them i suppose09:33
jiyuu0ic09:34
jiyuu0but at least it's better than marillat09:34
jiyuu0in the sense... backports is meant for ubuntu09:34
mdkehttp://www.ubuntulinux.org/wiki/UbuntuBackports09:34
mdkemy personal reason for disliking the backport project is that it encourages the "I must have the latest version of everything" attitude, without explaining that this compromising stability09:35
mdkebut thats IMO09:35
jiyuu0well... take e.g. firefox 1.0.409:36
jiyuu0it's considered to be stable and official09:36
jiyuu0and why is ubuntu devel not updating09:36
jiyuu0i mean it fixes security and stuff09:36
vendajiyuu0: I am just about to make a big commit on this thing will you pleas eprovide patch to align your changes09:36
jiyuu0venda, what patch?09:37
jiyuu0i'm not the developer of backports09:37
mdkejiyuu0, he means the guide09:37
mdkejiyuu0, do you seriously think that the ubuntu developers don't update security problems?09:38
mdkejiyuu0, the firefox fixes are included in the Ubuntu security updates09:38
mdkejiyuu0, ALL security issues are fixed09:38
jiyuu0ok :)09:38
jiyuu0is there going to be a conflict with backports?09:39
mdkethe version name does not change because they are patched09:39
vendajiyuu0: yes, the ubuntu guide. can you please add any changes you have made to the docbook xml version in svn. Thanks09:39
mdkejiyuu0, yes there is a conflict. backports are safe if properly pinned I believe09:39
jiyuu0ok. just spent one whole day on ubuntuguide09:40
vendaso did I09:40
jiyuu0now waiting for the add-on-cd to be uploaded09:40
vendasee commit list09:40
=== jiyuu0 got mail bomb again...
vendaoh that's handy09:42
vendajiyuu0: will you do the update?09:43
vendajiyuu0: have you sent your public pgp key to elmo yet?09:43
jiyuu0not yet...09:43
jiyuu0i'll look into it... but i need instructions09:44
jiyuu0subversion and stuff09:44
jiyuu0ok.. gotta crash... nearly 4am09:44
jiyuu0c'ya tomorrow09:44
vendayou have a working copy still09:45
vendajust svn update09:45
vendamake updates to FAQGuide09:45
vendamake diff and send us the diff09:45
jiyuu0ok... i'll workn on the svn from 3.0 onwards09:46
vendaHuh?09:46
jiyuu0UbuntuGuide 3.0 just release today09:46
vendaOk what about the changes you have made now, can you do the changes in svn?09:47
jiyuu0major change -> removed marillat and use backports (as lot requested)09:47
vendaplease send me diff between your html files09:47
vendamdke: to save the translators major work09:48
vendamdke: I wonder if we can create a pot of en version09:48
vendaand copy paste from nn versions into po files09:48
mdkeof what?09:48
vendathen submit these to rosetta09:48
vendaubuntuguide.org (FAQGuide)09:49
mdkei spent like a week trying to get a pot out of it, no go09:49
vendano no09:49
vendaI mean, from the xml version09:49
vendaonce we have it finsihed we can create POT09:49
mdkethat is the plan for breezy yeah09:49
vendathen create po files09:49
jiyuu0first time using diff09:50
vendacan copy paste the strings from nn HTML files into respective po files09:50
jiyuu0diff file1 file2?09:50
mdkejiyuu0, diff file1 file2 > file.diff i think09:50
vendadiff foo1 foo2 > foo309:50
vendamail foo3 to list09:50
vendaif you can do this I will upgrade xml in svn to 3.009:51
jiyuu0the output not easy to read09:51
jiyuu0what version is the svn?09:51
vendasvn 1.009:51
vendaI can read diff well09:51
vendalet me take care of it09:51
vendaor send me new HTML 3.0 and I will diff it for you09:52
vendasean@inwords.co.za09:52
jiyuu0the last 2.09 is here09:52
jiyuu0http://frankandjacq.com/ubuntuguide/5.04/index.html09:52
jiyuu0the new 3.00 is09:52
jiyuu0http://ubuntuguide.org/index.html09:52
vendaOK09:52
vendagot it09:52
jiyuu0btw, just curious what will the svn of the guide turn to?09:53
mdkejiyuu0, it can turn into anything09:53
mdkeyelp, pdf, html09:53
jiyuu0i don't really like yelp09:53
vendawhat format do you want?09:53
mdkeif it is made official it can go on the Ubuntu website09:53
vendaI can make PDF09:54
vendaor X/HTML if it is better for you09:54
jiyuu0can u send me a sample of PDF09:54
jiyuu0jiyuu0@gmail.com09:54
jiyuu0just curious how it will look like09:54
vendayes, once we have version in svn complete09:55
mdkethe great thing is that it can be published in many ways09:55
vendajiyuu0: we would also like to profile this doc for kubuntu09:55
jiyuu0but i'm still going to maintain ubuntuguide as it is right?09:55
mdkeand therefore can go in the Ubuntu local system, and on the website, and on the livecd etc09:55
jiyuu0as it suites my preference09:55
vendawe would like to take Judos09:56
mdkejiyuu0, the point of putting it in svn is that it would be a community project09:56
vendaif you want to maintain ubuntuguide.org you can09:56
=== mdke nods
vendabut we cannot say what will happen to the version in svn09:57
vendawe expect people in the community to develop it09:57
=== jiyuu0 nods
mdkeif it will go on the ubuntu website and on the ubuntu local system, it will have to be modified fairly heavily09:57
vendawhile I was marking it up as docbook I got some ideas that I think will improve it09:58
vendaI am sure others will do the same09:58
jiyuu0what ideas?09:58
mdkejiyuu0, but that doesn't stop you from developing the guide on your website as you wish09:58
venda:-) JOin us and let's share them dude09:58
jiyuu0so SVN will be more detailed09:58
mdkenot necessarily09:59
jiyuu0the ubuntuguide.org will still maintain in it's point form (for easier reference)09:59
vendaits a faq, so detail is not wanted09:59
mdkejiyuu0, the point form is good09:59
vendathe version in svn is a question and answer format09:59
vendaQ A09:59
vendaqanda09:59
mdkedoes it validate?09:59
vendanot yet10:00
vendaworking on it10:00
vendajiyuu0: here is a small example10:00
venda<qandaentry>10:00
venda                <question>10:01
mdkeyes i've seen how hard you are working on it10:01
venda                    <para>Configuring network interfaces... (taking too long to load)</para>10:01
venda                </question>10:01
venda                <answer>10:01
venda                    <orderedlist>10:01
venda                        <listitem>10:01
venda                            <para>Read <xref linkend="temporaryskipboot-upservices"/>10:01
venda                            </para>10:01
venda                        </listitem>10:01
venda                    </orderedlist>10:01
venda                </answer>10:01
venda            </qandaentry>10:01
vendayeah, my next step is to resolve the xref10:02
vendamdke: we want to bring in KUDOS to this guide10:02
mdkecool10:02
vendathat way we will have a book for ubuntu and a book for kubuntu10:02
mdkethat would be excellent10:03
vendabut KUDOS is large10:03
vendalarger than ubuntuguide.org :-(10:03
vendaI hope he has docbook src already10:03
mdkeunlikely10:03
vendayeah10:03
mdkeis it significantly different to jerome's document?10:03
vendasome stuff is duplicated10:04
vendaits a faq10:04
vendajerome is doing quickguide10:04
jiyuu0kudus is like a book10:04
jiyuu0lot's of explanations and stuff10:04
mdkei c10:05
jiyuu0it's good in a way i's bad10:05
mdkemaybe those can be cut out if it is converted to a faqguide10:05
vendayes, it has pros and cons10:05
mdkeand inserted into a userguide10:05
vendawe need to normalize it10:05
mdkeok i'm gonna hook up to the userguide and see if I can do somemore work on it10:05
mdkesee ya later10:05
jiyuu0ok... i've really gotta crash10:06
vendajiyuu0: night10:06
mdkenight jiyuu0 10:06
mdkethanks10:06
jiyuu0night :)10:06
=== mkde [~matt@mdke.user] has joined #ubuntu-doc
mkdeargh10:20
mkdevenda!!10:20
mkdethe userguide doesn't open anymore.10:20
mkdehave you removed entities?10:20
mkdeor added some invalidly10:20
mkdepasting you the errors10:21
mkdefroud_, venda ?10:23
=== _venda [~sean@ndn-165-128-37.telkomadsl.co.za] has joined #ubuntu-doc
_vendasorry crash mdke paste again10:31
mkdejust do ./validate.sh on the userguide10:31
=== _venda is now known as venda
mkde:/10:31
mkdeentities are missing10:31
vendaOK I will resolve them10:32
mkdety10:32
mkdehow come it happened?10:32
vendaI may have merged and missed something :-)10:32
mkdeok np10:33
mkdewe need a "no removing entities without grepping around for them first" rule tho :p10:33
vendano its not a merge problem I see the problem now10:34
vendagimme a sec10:35
mkdeawesome10:35
mkdewhat was it10:35
vendaI forgot a whitespace and also duplicated an entity10:36
mkdeis that all?10:37
mkdegosh10:37
mkdeso all the remaining entities weren't found?10:37
vendasvn up10:38
vendatry it now10:38
mkdeok thanks10:38
mkdebingo10:38
mkdeworks10:38
vendayes, an invalid entity is a blocker10:38
vendahe he10:38
mkdeits always the damn typos10:38
vendayeah10:38
mkdei hate them10:38
vendathat's programming for you ;-)10:39
mkdetoday it was a - instead of a = that mucked me up10:39
mkdestill here?10:43
vendayep10:43
mkdecan i check that xref with ya10:43
mkdeits a chapter10:43
vendawhich xref10:44
vendain faq10:44
mkdeyou remember i asked you how to do it10:44
mkdei've sort of forgotten10:44
venda:-( yes10:44
mkde<xref something="id"></xref>10:44
vendaoh10:44
vendaxref linkend="target-id"10:44
mkdeawesome10:45
vendayou can also bring in text10:45
vendalike this10:45
mkdeso how is this:10:45
vendaxref linkend="target-id" endterm="title-target-id"10:45
mkde<para>First and foremost you must have a working connection to the internet. To find out how to set this up, see <xref linkend="systemconfiguration-internet">this section</xref>10:45
mkdehmm10:45
vendano10:46
mkde:/10:46
venda<xref linkend="systemconfiguration-internet"/>10:46
mkdeok10:46
mkdeso i just need to insert the /?10:47
vendathis will create the text for you10:47
vendathe id is in the same file right?10:47
mkdeyes10:47
vendaok xref is an open tag10:47
vendawhen the proc does its work the xsl will do the rest10:47
vendait will say, see the Chapter "Title of Chapter"10:48
mkdeso i can't define the text that is linked10:48
mkdeok10:48
vendaor it will say, see the section "Title of Chapter"10:48
mkdeok so:10:49
mkdeTo find out how to set this up, see the section <xref linkend="systemconfiguration-internet"/>10:49
vendait will do the words for you10:49
vendaTo find out how to set this up, see <xref linkend="systemconfiguration-internet"/>10:50
vendathis will become10:50
vendaTo find out how to set this up, see the section <xref linkend="systemconfiguration-internet"/>10:50
mkdeok10:50
mkdeclever10:50
mkdewhats the policy on linking to other documents?10:50
vendaTo find out how to set this up, see the section $target-text10:50
vendawe don't yet support olink10:51
vendaI hope to add this support before 5.1010:51
mkdei guess the problem is that they would be published in different places, not just yelp, like on the website, so linking between documents is not easy10:52
vendabut not impossible ;-)10:52
mkdethat would be supercool10:53
mkdegnome help seems to be back at 2.6 on my system11:00
mkdeGNOME 2.6 Desktop System Administration Guide11:00
vendadunno I am on Kubuntu right now11:00
mkdethat sucks balls11:01
mkdemaybe gnome 2.10 hasn't got a help yet11:01
BurgundaviaSun also just stopped supporting some gnome docs11:02
Burgundaviaso the gnome doc team is in a real mess11:02
vendayeah I saw that11:03
mkdeic11:03
mkdehow would I link to the synaptic help?11:03
vendajust dont11:03
vendainterlinking does not work without olinks11:04
mkde?11:04
mkdebut the whole userguide has links to other help docs11:04
mkdelike this:11:04
mkde<ulink type="help" url="ghelp:sound-juicer"11:04
mkde                        >here</ulink>11:04
vendayeah11:04
mkdedoes that not work?11:04
vendadont use ghelp11:05
mkdehow come?11:05
vendait should not be used11:05
mkde,,,11:05
vendaties us in to yelp11:05
mkdeah11:05
vendaremain neutral11:05
mkdeso what should I do just copy all those documents?11:05
vendano11:06
mkderemove all the:11:06
vendaif the doc is online use it11:06
mkde                <para> A more thorough explanation of the ins and outs of <application>Sound11:06
mkde                    Juicer</application> can be found <ulink type="help" url="ghelp:sound-juicer"11:06
mkde                        >here</ulink>. </para>11:06
mkdethere will be lots to remove11:06
vendayes, it was a problem11:06
mkdeespecially because the userguide attempts to do an overview11:06
mkdeit is useful to refer a user to a more detailed doc11:06
vendathe user guide need to explain in itself11:06
vendaarh perhaps I can call you11:07
vendamsg your number to me11:07
mkdei'll call i have a cheap thing11:07
mkdewhats the land line again11:07
venda+27 11 678 449611:08
mkdegimme a mo11:09
mkdecheap thing is slow tonight, everyone is calling ;)11:09
mkdeok11:10
mkdering ring11:10
vendano ring11:10
mkdestupid thing11:11
mkdegive it time11:11
vendathe number is right11:11
=== mkde nods
mkdeok11:11
mkdetrying again11:12
mkdering ring?11:13
vendano ring ring11:13
mkde:/11:13
vendacheap thing no work11:13
vendame call you11:13
vendawhat number11:13
mkdedamn11:13
mkde+44 207 476 325911:14
mkdeperhaps the lines are clogged this evening11:14
vendaring ring11:14
mkde:)11:35

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