/srv/irclogs.ubuntu.com/2005/05/20/#ubuntu-doc.txt

mptBurgundavia: Also, from the Bugzilla-mind-trips dept.: Don't report bugs of the form "X should be more like Y"12:17
Burgundaviampt, yes, I realised taht after I submitted it12:18
mptInstead, "Make X N", where N = {simpler, more consistent, more obvious, more efficient ...}12:19
BurgundaviaI take the advice of a master then12:20
=== Burgundavia wonders how many bug reports has mpt filed
mdkeBurgundavia, still here?12:39
Burgundaviayep12:39
Burgundaviamdke, what do you need?12:40
mdkeare you following that thread started by henrik?12:40
Burgundaviayes, but I haven't responded yet12:40
mdkeany thoughts?12:40
BurgundaviaI like the idea of seperate wikis12:40
mdkemy impression is that he is moving a little fast12:40
Burgundaviai think he should do12:40
Burgundaviawe have lots of time to sort of the fallout12:41
mdkehmm12:41
mdkei thought the idea of using a wiki as a portal had been ruled out12:41
Burgundaviahmm12:42
mdkei agree moving fast is good, but if the fallout is gonna be massive, and keeping the various wikis in sync is gonna be a huge task, we need to make sure its gonna work12:42
mptBurgundavia: About 600, I think12:43
Burgundaviampt, geez12:43
mdkethats a lot12:43
=== mpt has another go at checking out ubuntu-docs
mdkempt, not working?12:43
jdubmdke: the separate wiki suggestion is more technical-solution-to-social problem mucking around12:43
mdkemorning jdub 12:43
jdubmdke: splitting wikis is worse than splitting mailing lists12:44
mptNot nearly as much as some people12:44
mdkejdub, sorry i don't get what you mean12:44
mdkempt, i mean, is the checkout not working?12:44
Burgundaviajdub, I like the idea of the acl for some docs12:44
mdkejdub, what is "technical-solution-to-social problem mucking around"?12:44
mptmdke: Yes, it's working fine, I just didn't get it finished last night before I had to go offline12:44
Burgundavianot being allow to move such important pages as RootSudo is very good12:45
mdkempt, ok cool12:45
jdubBurgundavia: the wiki is a place for collaborative authoring, not "documentation"12:45
Burgundaviajdub, they we need to be more proactive at moving stuff to static web pages12:45
mdkejdub, you had better voice your opinion on that thread because it looks like henrik is moving quite quickly with his ideas, unless i've got the wrong end of the stick12:45
mdkeBurgundavia, ++12:45
mdkeBurgundavia, to a certain extent, moving wiki stuff to our docs can be done in the existing system tho12:46
Burgundaviayes12:46
Burgundaviawell there is to ways to do it:12:46
mdkeits just a question of putting in the time12:46
jdubmdke: i'm writing a response to that, and a lengthier email about good stuff for the doc team to be doing12:46
Burgundavia1. keep the stuff in the wiki, and apply a no-move/delete acl to it12:46
Burgundavia2. move it out of the wiki12:46
Burgundaviathat is for short things we have written that we wish to keep on the web12:47
Burgundavialike RootSudo12:47
mdkejdub, i'll just sit back and observe, in the meantime the wiki transition can get done anyway, its a separate issue really12:47
mdkeBurgundavia, +12:47
Burgundaviawhy don't we transition straight wiki to wiki, and the start talking about fancy crap like acls12:47
mdkehmm12:47
Burgundaviabecuase the wiki --> wiki transition is going to bring bugs we are going to need to fix12:48
mdkewhat do you mean?12:48
mdketransfer of zwiki to moinmoin?12:48
Burgundaviayes12:48
mdkebut that will happen anyway12:48
Burgundaviayes, that is what I am saying12:49
mdkebut the issues that will occur are gonna be separate aren't they?12:49
Burgundavialets do the transitition, and then start talking about the new stuff to make our lives easier12:49
mdkeya12:49
mdkeok i'm gonna do the washing up and get ready for bed and look forward to jeff's mails12:51
Burgundaviamdke, see the list01:02
mdkewill do01:02
mdkegood stuff01:03
mdkei am still boggled by the question: canonical are funding a fantastic translation interface, why not a documentation interface01:04
Burgundaviano idea01:04
mdkethat is a question for the long term obviously01:04
mdkemaybe we will get an answer during this debate tho01:05
Burgundaviawe already have an answer from jdub, and that is that we don't need it01:06
mdkelaunchpad is not only about "we" tho01:06
BurgundaviaI still think we do, but we can postpone the decision01:06
Burgundavialaunchpad is python01:07
Burgundaviathe suggested interface was java01:07
mdkeyou misunderstand me i think01:07
jdubmdke: because translation is ready for that kind of scalability01:07
mdkei'm not talking really about the current portal debate, more generally01:07
jdubmdke: and is worth investing in for that scalability :)01:08
mdkejdub, i see that01:08
Burgundaviayou are talking a doc portal in general01:08
mdkemy knowledge of launchpad is minimal, but isn't it the case that there are no good web interfaces for documentation? on the other hand there are lots of bug interfaces, but that hasn't stopped development of malone01:08
mdkeis malone "needed"?01:09
Burgundaviamalone is meta bug tracker01:09
mdkeno, but its a long term investment01:09
Burgundaviaand bug tracker of bug trackers01:09
Burgundavianeither is rosetta "need"01:09
jdubmdke: documentors are quite a different set of people to translators01:09
mdkejdub, sure, ditto bug reporters01:09
jdubmdke: translation has come very far, now we can scale it out significantly with a "mum can use it" interface01:09
mdke*grins*01:09
mdkei'd like to see my mum use rosetta, but i take your point01:10
Burgundaviadocumentation tends to be the forgotten child01:10
jdubmdke: hey, when it's released...01:10
Burgundavialaunchpad is very very cool01:10
mdkejdub, yeah just ribbing, i use rosetta01:10
jdubmdke: malone is a different kettle again; we're aiming for massive upstream/downstream/crossstream collaboration01:10
mdkejdub, same with rosetta no?01:10
jdubyes01:11
Burgundaviaa doc portal would need to take into account getting upstreams involved01:11
jdubbut differently01:11
mdkewhy not documentation too?01:11
jdubmdke: because it doesn't have that scale01:11
jdub"everyone" needs to do translations, "everyone" can report bugs01:11
mdkein terms of contribution?01:11
mdkehmm01:12
mdkeinteresting01:12
jdubwriting documentation (which is not the most important part of what the doc team should be doing) is very hard, and very hard to scale01:12
Burgundaviathat is why most current docs suck, and are out of date01:12
jdubbut there are ways of making it better, and involving people01:12
mdkejdub, i guess that's a little bit a matter of opinion, some would say that the more people get involved, the better quality comes out01:12
jduband i've got a little faux-timeline for doing it01:12
jdubmdke: i think that's pure poppycock :-)01:13
BurgundaviaI think the best way is to start with some sort of web stuff, and scale the technology as need01:13
jdubmdke: more people == cacophony, not clarity :-)01:13
mdkewell its the idea behind a lot of free speech theory right?01:13
Burgundaviabasically to start, you need a readonly, where are the holes, interface01:13
mdkeanyhow01:15
=== mdke drags himself back down to earth
=== Burgundavia curses that mediawiki is php
mdke*grins*01:17
Burgundaviathe best wiki engine out there, bar none01:17
=== mdke points at the forum
mdkethere is always the "let's use php anyway" idea01:18
mdkecan of worms maybe01:18
Burgundavianot hosted on canonical servers01:18
mdkethats my point01:18
Burgundaviathere was talk of hosting the portal off canonical servesr01:19
Burgundaviawhich may still be an option01:19
BurgundaviaI would like to explore it01:19
mdkethat's what i am getting at01:20
Burgundaviathat is how we got svn on the servers01:20
mdke*grins*01:20
Burgundaviait got setup and hosted offsite01:20
mdkeyou'll never get php on in the same way01:20
mdkebut still01:20
Burgundaviano, but I might be java on01:20
Burgundaviathat didn't make sense01:21
mdke*laughs*01:21
Burgundaviabut java may be acceptable01:21
mdkestill it would involve a separate wiki01:21
mdkebit annoying01:21
Burgundavianot really01:22
jdubguys, "php" is not the problem01:22
BurgundaviaI think that mediawiki, as an app is pretty security tested01:22
jdubwe've chosen moin01:22
mdkesure01:23
mdkefor the ubuntu wiki01:23
mdkejdub, we have helped a lot with the possible transition, and have never questioned the choice01:24
mdkeand we're not doing so now01:24
mdkebut we are just playing around with our ideas for a docteam portal01:25
jdubdocteam doesn't need a 'portal' dude01:25
mdkeyou've said that01:26
Burgundaviajdub, we realise your opinion01:26
mdkebut its a free channel01:26
Burgundaviaand I respect it01:26
mdkewe are just talking01:26
BurgundaviaI just don't completely agree with it01:26
jdubthat's because it looks like a bastion of direction in a directionless project :)01:27
Burgundaviaright01:27
Burgundaviawell, nobody is providing direction until now01:27
mdkewell i think the main attraction is of involving more people01:27
jdubmdke: right, but it won't01:27
mdkeand removing the massive contribution barrier01:27
jdubhere's why01:27
jdub- real documentation is hard, having a web way of writing docbook doesn't increase the quality or ability to write documentation01:28
jdub- adding more people to a project with no direction makes it much harder to go anywhere or get anything done01:28
mdkejdub, of course it is hard, but there are people around who have the skills and don't have the skills of writing docbook01:28
mdkexml01:28
jdub- writing new documentation is a red herring, and not a hugely important part of what the docteam should be doing right now01:29
jdubmdke: a 'web portal' won't help them anyway01:29
mdkejdub, go on01:29
jdubthat's the summary of my points01:29
mdkei mean, why won't it01:29
jdubbecause unless the web application is extraordinarily good, and abstracts away the whole "writing docbook" issue, they'll still be writing docbook, they'll still have to know what it is, how it works01:30
jdubhaving a web interface doesn't magically make things less complicated01:30
jdubbesides, there is *no point* scaling doc team at the moment01:31
mdkewhat does scaling mean?01:31
jdubmaking bigger, ie., bringing on more contributors01:31
mdkeah01:31
mdkewell you would agree that the documentation with Ubuntu is pitiful?01:32
jdubno01:32
jdubnot at all01:32
jdubunderexposed? yes.01:32
jdublacking analysis and integration? yes.01:32
mdkemy opinion on having a look at the local docs in yelp is that it is pitiful01:32
mdkeconsidering that Ubuntu's emphasis is on being user friendly01:33
jdubthe solution to that is *not* writing new documentation01:33
mdkeok01:34
mdkewell it is clear that you have a vision of what the solution is, so I will wait for your email before pestering further in here01:35
=== mpt [~mpt@203-167-186-82.dsl.clear.net.nz] has left #ubuntu-doc []
=== _froud_ [~froud@ndn-165-128-37.telkomadsl.co.za] has joined #ubuntu-doc
mdkeright i gtg to bed01:48
mdkecatch you all later01:48
Burgundaviacya01:59
=== Liz [~Liz@fixed-203-87-27-63.nsw.chariot.net.au] has joined #ubuntu-doc
Burgundaviasalut liz02:04
Lizkia ora Burgundavia 02:04
Liz:)02:04
LizBurgundavia, did you get unable to authenticate for the new updates on hoary?02:06
=== Burgundavia is running breezy
Lizalready?..didnt think it was stable enough for that02:07
Lizim going to have to upgrade again before the next upgrade02:07
Burgundaviabreezy is very not stable02:11
BurgundaviaI just like my latest crack02:11
Lizok..gotta go shopping...bbl03:16
=== mpt [~mpt@203-167-186-117.dsl.clear.net.nz] has joined #ubuntu-doc
=== jiyuu0 [~jiyuu0@219.95.241.41] has joined #ubuntu-doc
=== jsgotangco [~jsg@202.57.71.235] has joined #ubuntu-doc
jsgotangcohey hey07:26
=== sm [~simon@lsanca1-ar5-4-60-051-162.lsanca1.dsl-verizon.net] has left #ubuntu-doc []
=== _froud_ is now known as froud
=== froud finishes checking email
froudmorning, African Greetings07:46
=== jsgotangco [~jsg@202.57.71.235] has joined #ubuntu-doc
jsgotangcogrrr crappy router07:49
jsgotangcohi07:49
froudwoof07:51
jsgotangcofoo07:52
froudnow what animal goes foo07:52
jsgotangcofroud, you feeling well today?07:52
froudI always feel well07:52
jsgotangcoi just arrived after attending this useless isms seminar07:52
froudexcept when I am sick07:52
froudisms?07:52
jsgotangcoi dunno if you're familiar with BS 779907:52
froudBS 779907:53
jsgotangco"Information Security Management System"07:53
froudAh business continuity planning:-)07:53
froudyes I am familiar07:53
froudcaves your head in07:54
jsgotangcoyou think its worth it?07:54
froudThe concept, yes07:54
froudif you dont have it you should07:54
froudI say that if you are in a large organization07:55
jsgotangcooh yeah if you're large indeed07:55
froudsecurity management is key to business continuity07:55
froudFor a small business, it's overkill07:55
froudso cut down to just what you need07:56
jsgotangcoi dont get it nobody reacted to my email (not that its bad) i guess its too technical?07:57
froudwhich email07:57
froudObservations in packaged Ubuntu Documentation (Hoary)07:57
jsgotangcothe yelp/scrollkeeper thing07:57
froudI explained my position to you yesterday morning07:58
jsgotangcooh right07:58
jsgotangcoi forgot07:58
froudjsgotangco: I don't know why people don't just take my idea of scrapping yelp for our docs07:59
froudwe dont need yelp/scrollkeeper to deliver help08:00
jsgotangcoits taboo for gnome! heh08:00
froudto much religion dude08:00
froudnot enough lateral thinking08:00
jsgotangcoi don't mind the yelp/scrollkeeper thing but it really needs to be cleaned08:00
froudamazes me how in the box people think08:00
froudjsgotangco: yelp cant support a large number of requirements08:01
froudglossterms would be a start08:01
froudbibliography refs another08:01
jsgotangcoyes bibliography08:02
froudXInclude/XPointer the next08:02
froudcustomization08:02
froudsearch08:02
jsgotangcoisnt xpointer very basic to be missed08:02
froudnot if you have xi:fallback08:02
froudand if we want to use vendor drops, it will become a must08:03
froudjsgotangco: but you know, I am just doing my thing08:08
jsgotangcoits understandable but in my opinion its not so bad08:09
froudactually I was thinking, that perhaps I should not discuss these things, just go ahead and do it and then say to people here it is, like it or love it08:10
jsgotangcosome people believe we've done a good job08:10
froudseems when we discuss stuff that people get hooked on the technical stuff and not writing08:10
jsgotangcoso like i said its not so bad after all08:10
jsgotangcodespte the tools (or the lack of it) that we have08:11
froudno, not bad at all08:11
froudbut many of us know it can be better08:11
froudbut each time we discuss matters, we get bogged down08:12
jsgotangcoheh i remember a few months before hoary08:12
jsgotangcowe're all busy and stuff heh08:12
froudso I figure, just do it and then show it08:12
froudyeah08:12
froudanyway, I just dont want to get side tracked. If others want to, that is their baby08:13
froudfor me I just hack the src08:13
froudthose that join are welcome08:13
froudover time, the src will win, not wiki08:13
jsgotangcoyeah we seem to be more productive that way08:13
froudyep08:13
froudfar more08:13
Burgundaviahttp://lwn.net/Articles/135484/08:14
jsgotangcoluke use the src08:14
jsgotangcoheh08:14
froudyes seen that08:15
froudbut people here dont want a steering committee08:15
froudI suggested this route sometime back, and got bitch slapped08:16
Burgundaviajust thought I would mention it08:16
Burgundaviasent to the list as well08:16
froudno no good to know others know ofthese thing08:16
froudgood on you08:16
Burgundavianotice, the head of the steering committe is a RH employee08:16
froudyeah, that is exepect08:16
froudexpected08:16
jsgotangcodoc bounty?08:16
froudI offered management and steering for a retainer, but that was ingnored like mostthings are08:17
froudanyway, dont want to get depressing08:17
froudBurgundavia: I starting fixing the dialup doc08:18
froudstill need a few more patches08:18
froudand need to make it ISP neutral08:18
jsgotangcofroud, is the dial up doc good enough for testing for DialUpSupport BOF08:18
froudYeah, not bad at all08:18
jsgotangcoamu and I pulled some stuff from it but i haven't really tested yet08:19
jsgotangcobeause amu started a dialupresearch08:19
froudBurgundavia: the TCP/IP configure part of the install guide is at first draft08:19
froudjsgotangco: yeah saw that08:20
froudI will publish that doc over at kubuntu.org08:20
froudand the kubuntu install doc, soon08:20
froudjust got to do the disk partioning stuff08:20
froudand maybe the install without media doc to be integrated08:21
froudoh shucks, I lost the link to that08:21
froudBurgundavia: do you have the link it it08:21
froudjsgotangco: hows the kwicj guide going08:21
Burgundaviawhich link?08:21
froudthere was a doc about installing without cd or floppy08:22
Burgundaviaah08:22
jsgotangcohmmm kwickguide is almost done and will just need screenshots 08:22
jsgotangcobut im not putting screenshots yet08:22
froudOK, so you will be ready for checking collaboration soon08:22
froudpromise I will look at it this weekend, OK08:23
jsgotangcono problem with me as long as PDA Support doesn't eat up most of my time (i dont think so)08:23
froudok08:23
Burgundaviafroud, http://marc.herbert.free.fr/linux/win2linstall.html08:23
froudsee how much more productive we are when we focus on svn08:24
froudBurgundavia: thanks08:24
jsgotangcobah infrastructure "claptrap"08:24
=== jsgotangco winks at Burgundavia
froudBurgundavia: did you port it to xml?08:24
Burgundaviaabout half done08:25
=== froud just loves this "Control-Escape. A gentle introduction to migrating to Linux for newcomers."
froudBurgundavia: want me to do a checkin08:26
Burgundavialet me find it08:26
jsgotangcofroud, what do you use for editing docbook anyway08:26
froudOxygen XML Editor08:26
jsgotangcoooohhhhhhh08:26
froudI wrote the book and helped on the dev so I am biased08:26
froudbut i do think it is the best08:28
froudof cours eit is JAVA08:28
froudJAVA08:29
froudJAVA08:29
froudJAVA08:29
froudJAVA08:29
=== jsgotangco likes to be biased as well
froud;-)08:29
jsgotangcomy eyes! my eyes!08:30
jsgotangcowiki is so evil on the sidelines people just bow to it08:31
froudwiki is cool when used for the purpose it was intened08:31
jsgotangcoyeah but some think it can fix everything08:33
froudBurgundavia: send me the xml file, I will check it in and hack some more on it08:33
froudBurgundavia: what did we agree, to add it to the generic installation guide, right?08:33
jsgotangcoanyone know how good screem is for docbook?08:34
froudscreem?08:34
froudurl08:34
Burgundaviajsgotangco, bluefish works well, and is more mature08:35
jsgotangcowww.screem.org08:35
jsgotangcoi want to compare im still partial to kate08:35
froudouch there xml transformation has poor encoding08:36
froudjsgotangco: you can try Morphon08:36
froudit is JAVA08:36
froudJAVA08:37
froudJAVA08:37
froudJAVA08:37
jsgotangcoblasphemer!08:37
froudhttp://www.morphon.com/08:37
froudhttp://www.morphon.com/08:37
froudhttp://www.morphon.com/08:37
froudhttp://www.morphon.com/08:37
froudblasphemy08:38
froudlove it08:38
jsgotangcoi used to run xmlspy for rosettanet projects08:38
jsgotangcoits quite good08:38
froudnice for data orientated docs08:38
froudbut that is Windows08:39
froudWindows08:39
froudWindows08:39
froudWindows08:39
jsgotangcoits not so bad08:39
froudno very good for data docs08:39
froudnot doc docs08:39
jsgotangcohmm08:40
jsgotangcohold on08:40
jsgotangcobrb08:40
=== froud goes on school run
=== Skywind [~Skywind@218.94.37.185] has joined #ubuntu-doc
=== jsgotangco [~jsg@202.57.71.235] has joined #ubuntu-doc
froudwork starts, c ya, Burgundavia send me the file08:55
=== froud is now known as froud-work
jsgotangcoang dami kong email09:47
jsgotangcoooppss wrong chan09:48
jsgotangcothis is crazy my apps dont work09:51
jsgotangcogrr09:51
jsgotangconautilus wont run either09:51
jsgotangcoarggh09:51
jsgotangcowtf is wrong with this09:54
jsgotangcobbl09:54
=== mdke wakes up
=== mdke checks email
=== mdke lumbers off to have a shower
=== jsgotangco [~jsg@202.57.71.235] has joined #ubuntu-doc
=== enrico [~enrico@enrico.developer.debian] has joined #ubuntu-doc
jsgotangcoenrico!10:27
enricoHi!10:27
jsgotangcolong time no see man10:27
enricobeen quite busy10:27
mdkemorning guys10:28
enricoI tend to be on IRC only in case of need, recently10:28
jsgotangcoenrico, got a minute?10:28
enricoyes10:28
jsgotangcoits with the existing gnome docs and scrollkeeper10:28
jsgotangcois it possible to clean up those10:29
enricowhat do you mean clean up?10:33
jsgotangcohttp://lists.ubuntu.com/archives/ubuntu-doc/2005-May/002230.html10:34
enricoabout the ordering in Yelp, that's tricky to do.  I remember jdub worked on having our documents displayed there at all, maybe he can manage to do some reordering for breezy10:36
enricoPoint #2 is likewise10:36
enrico(sounds like a yelp bug)10:36
jsgotangcoit is10:37
jsgotangco:(10:37
enricofixing or improving existing documentation would be very nice10:38
enricoespecially if such improvements can be contributed upstream as well10:38
jsgotangcoyeah theres too much info its kinda hardto ignore10:38
enricoin the past we tried to see if there was an easy way of doing it, and we failed10:38
enrico(the idea was that one should spend time mainly in fixing the docs rather than in figuring out how to checkout the thing and submit the patch upstream)10:39
enricoThat does not mean that there isn't a way of doing it now10:39
froud-workno, any is fixable10:40
enricoThe problem is finding it.  The way I see of doing it is to involve Sean and some of the devels in finding out how to do this10:40
froud-workjust that it is a distraction10:40
enricothe problem I see is this:10:40
froud-workenrico: I wont get involved in any of these innitiative anymore :-)10:40
enricothe developers are used at doing all sorts of hacks for playing it nicely with upstream, and they see no problem if doing so is complex10:40
enricoI found it quite hard to work with them to find out an easy way for that 10:41
enricofroud-work:  :-))10:41
enricofroud-work: heyya!10:41
jsgotangcofroud-work, don't say that, this is long term not breezy goal10:41
froud-workmy focus is in svn10:41
froud-workenrico: hi10:41
jsgotangcodon't make me feel discouraged :(10:41
froud-workjsgotangco: not discouraging, just noting that itis a distraction10:41
froud-workbeing a bit harsh10:42
enricoI've never understood if it's simpler to learn baz or to drop the things into svn10:42
froud-workbut I plan to make a decision about scrapping yelp10:42
enricodropping the things into svn would be the best one, I guess (that means not changing any of the existing process)10:42
froud-workyeah, I have vendor drops ready10:43
froud-workbut have to teach10:43
jsgotangcoits just a matter of upgrading svn i guess to support that10:43
froud-workand yelp will break10:43
enricojsgotangco: file bugs on yelp for #1 and #210:43
jsgotangcook10:43
froud-workyou cant whip a dead horse10:43
mdkesure you can10:44
froud-workit wont feel it10:44
mdke:p10:44
mdketrue10:44
froud-workhello mdke 10:44
mdkemorning :)10:44
enricofroud-work: yum yum.  So, isn't it just the matter of trying dropping in just one upstream stuff and see how it works?10:44
enricomdke: hi!10:44
froud-workdudes my take on all this stunted technology is drop it10:44
enricofroud-work: maybe creating a StepByStep guide in the meantime10:44
mdkeciao enrico10:44
froud-workyes10:45
froud-workenrico: big checkout though 10:45
jsgotangcofroud-work, i see the logic in dropping yelp with a gecko-type browser or mozembed but question is are we just going to use browsers?10:45
froud-workfor now, yes10:45
enricofroud-work: maybe just one small piece?10:45
jsgotangcoi dont mind that hack10:45
froud-workyelp can still read the docs10:45
froud-workbut as html10:46
froud-workjsgotangco: you know ubuntu guide10:46
jsgotangcoyeah10:46
enricoyelp things are still to be negotiated with mdz and jdub, I guess10:46
froud-workyou know it is in svn10:46
jsgotangcofroud-work, yeah a part of it10:47
froud-workenrico: I am done negotiating with them10:47
enricofroud-work: oh, sounds negative10:47
froud-workjsgotangco: well help cant open it cause it does not support qanda sets10:47
froud-workenrico: it is10:47
froud-worklong story10:47
enricook10:47
froud-workjsgotangco: but ifyou transform it to html yelp can read it10:48
froud-workwe can do the same with all docteam stuff10:48
=== enrico wonders what is a qanda set
enricofroud-work: worst case, one can do yelpable about ubuntu and release notes, and html all the rest10:49
jsgotangcoits a docbook thing10:49
froud-work<qandaset>10:49
froud-work            <qandaentry id="sect-whatis">10:49
froud-work                <question>10:49
enricoAH Q and A :)10:49
froud-work                    <para>What is Ubuntu?</para>10:49
enricook :)10:49
froud-work                </question>10:49
froud-work                <answer>10:49
froud-work                    <para>10:49
froud-work                        <ulink url="&ubuntu-main;">Main Ubuntu site</ulink>10:49
froud-work                    </para>10:49
froud-work                </answer>10:49
froud-work            </qandaentry>10:49
froud-work            <qandaentry id="sect-downl">10:50
froud-work                <question>10:50
froud-work                    <para>Where to download Ubuntu?</para>10:50
froud-work                </question>10:50
froud-work                <answer>10:50
froud-work                    <para>10:50
enricoAt the beginning I thought it was an australian aboriginal word10:50
froud-work                        <ulink url="&ubuntu-download;">Ubuntu download link.</ulink>10:50
froud-work                    </para>10:50
froud-work                </answer>10:50
froud-work            </qandaentry>10:50
froud-workand GDP does not intend adding support for it10:50
froud-workI can understand why10:50
froud-workthey have no need for it10:50
froud-worknone of the gnome projects do10:50
froud-workanyway10:50
froud-work:-)10:50
jsgotangcoyeah10:50
froud-workso I dont really want to negotiate with canonical on a community effort10:50
jsgotangcothe one in svn was a nasty hack10:51
froud-workjsgotangco: no it is valid and well formed10:51
froud-worktransforme dto HTML looks good10:51
enricofroud-work: how about asking some of the devels to add it to yelp?  Like, since Ubuntu needs it, Ubuntu can add that support in it10:51
jsgotangcouphill battle10:51
=== froud-work feels a pain growing
=== enrico hands froud-work a pain killer
enricofroud-work: but you're right10:52
froud-workenrico: I plan to work in the walls of the docteam10:52
=== jsgotangco just noticed today that qanda set is just Q and A
jsgotangcoheh10:52
froud-workanything beyond is no go land10:52
enricofroud-work: I was paid to do this sorts of negotiation, so that was fine10:52
mdke*grins*10:52
enricofroud-work: but if one has to do things just for fun, then eh10:52
=== Burgundavia is playing with http://www.symphonyos.com/
enricofroud-work: better to focus on the fun and let who needs it follow10:53
mdkeenrico, you're not anymore?10:53
froud-workenrico: exactly, they want more they can pay me10:53
jsgotangcoi think doing these things for fun is of more importance rather than being paid10:53
jsgotangcoif you're having fun, that means you intend to do it10:53
jsgotangcobut then10:53
enricomdke: no, the contract expired at the end of february and I didn't sign a new one10:53
=== mdke nods
jsgotangcolong story10:53
jsgotangco*sigh*10:53
mdkeenrico, ah bummer10:53
enricomdke: the reason being that I have a full-time job now and I can't keep up with two10:53
froud-workenrico: welcome to the plbs10:54
=== mdke nods
jsgotangcoBurgundavia, maybe they need docteams heh10:54
froud-workok dudes, look out10:54
mdkeok i'm off to school10:54
mdkelater10:54
froud-workby month end I will have bibio and glossterm databases in svn10:54
froud-worknext month vendor drops, if elmo upgrades10:54
jsgotangcobiblio ang gloss are good10:55
froud-workmonth after that xml to html build with desktop and arch profiles10:55
enrico"Symphony is a [...]  linux distro based on Knoppix"10:55
enricobooh.  sounds like a dead end :(10:55
froud-workthe generic install guide is already enroute to this10:55
enricofroud-work: awesome!!10:56
froud-workinstead of debating this, I am just going to break protocol and do it10:56
jsgotangcoits a good risk10:56
froud-workif people who are not commiting scream I will pretend to be deaf10:56
froud-workhowever, if commiters have problems I will be all ears10:57
jsgotangcoyoure pumped up lately10:57
froud-workno just doing what I know will work and tired of listening to crap from people who have no clue what they are saying :-)10:57
froud-workand who do not write and commit10:58
enricofroud-work: doesn't sound like a bad approach10:58
jsgotangcohah10:58
jsgotangcoi dont mind doing this my way or the highway thing, we've done good weeks before hoary and it works for us10:58
froud-workso by focusing on the contents of svn I will screan out all outer noise10:58
enricowhat are the docteam plans for Breezy?10:59
froud-workany of these10:59
froud-workhttp://www.ubuntulinux.org/wiki/DocteamProjects10:59
jsgotangcohttp://www.ubuntulinux.org/wiki/DocteamProjects10:59
froud-workjsgotangco: on kwick guide10:59
froud-workme on install10:59
froud-workand some others11:00
Burgundaviajsgotangco, seen this? http://www.symphonyos.com/desktop.html11:00
froud-workmdke: the legal dude on User Guide11:00
froud-workBurgundavia: on faq11:00
froud-workI think11:00
froud-work:-)11:00
jsgotangcoheh11:00
jsgotangcoBurgundavia, yeah i don't like the UI11:00
jsgotangcocorner applets are terrible11:00
Burgundaviajsgotangco, interesting ideas11:00
froud-workwell first he need to get hs key back11:00
BurgundaviaI like the fact that windows cannot go outside the screen11:01
jsgotangcowell that's one thing11:01
enricois jiyuu0 back to business with his UbuntuGuide?11:01
froud-workyes, but it is still closed source :-(11:01
jsgotangcofroud-work, seen Andrew Zajac's post?11:02
froud-workand he did not work in svn11:02
froud-workwhich one11:02
jsgotangcoubuntuforums11:02
froud-workyeah11:02
enrico[symphony]  corner applets?  Cool!  Finally someone noticed what part of the screen is easier to click!11:02
jsgotangcoAs it is, the docs in SVN are not11:02
jsgotangcooffering the kind of documentation that many users need.11:02
jsgotangcoThe documentation that is currently there is either not indexed11:02
jsgotangcoadequately, or is too broad in scope and does not offer precise11:02
jsgotangcoanswers to common questions.11:02
froud-workI broke out of the talk11:02
jsgotangcojust scream: ITS YELP11:02
jsgotangcoheh11:02
froud-workno he has a bigger picture11:03
enricowow, that's a lot of projects11:03
froud-worksomething Burgundavia and I discussed long ago11:03
froud-workplenty of work11:03
jsgotangcothe portal11:03
jsgotangcoyeah11:03
jsgotangcoive read of that11:03
jsgotangcobah11:03
froud-workenrico: so we all need to focus in svn, not portals and wikis and crap like yelp11:04
froud-workwork small commit often11:04
froud-workand we will have ample time11:04
jsgotangcowe're stuck with that crap for now but we'll live11:04
enricoand [mainly]  have fun!11:04
froud-workyeah, loads of fun11:04
froud-workooh oh ho ha ra ra, yehaw11:05
froud-workBurgundavia: where is that file11:05
froud-workare you gonna send it?11:05
Burgundaviasomewhere in my files, I have no idea where11:05
froud-workOh dude shall I do it from scratch?11:06
jsgotangcooh he's become the doc team whip master11:06
froud-workwho me11:06
Burgundaviafroud-work, si tu veux11:06
=== froud-work has visions of leather and chains
froud-worken please11:06
=== Burgundavia runs away
froud-workSo dudes, I need ideas to a problem11:08
froud-workI have a docbook XML glossary database over at computerdictionary.tsf.org11:08
jsgotangcowhy do i feel deja vu on this chat right now11:08
froud-workhow the hell to process glossterms without forking that code base11:09
froud-workthe glossterms in our docs11:09
froud-workhttp://computerdictionary.tsf.org.za/11:09
froud-workneed a method to dynamically parse the above and add glossary entries to the docs at time of transformation11:10
froud-workany ideas11:10
jsgotangcoi dont get it11:11
froud-workok the above has over 21297 glossterms11:11
froud-workthat's a lot of code11:11
jsgotangcoim sure of that11:11
froud-workso how to process our docs and dynamically generate the glossary section11:12
froud-workwithout having to checkout the above11:12
froud-workor store it in our svn11:12
froud-workthe glossary mech will only add glossterms that are used by the doc11:13
froud-workso lets say11:13
enricofroud-work: XSLT to generate a wordlist needing a glossary on docteam stuff, then XSLT on computerdictionary.t.o.z to extract a subset?11:13
froud-workyou markup 50 terms11:13
froud-workthe glossary section will only have 50 words11:13
froud-workenrico: the docbook stylesheets to this11:13
froud-workbut it has to happen between two remote systems11:14
froud-workmaking processing slow11:14
jsgotangcoi see the point but i think the bottleneck will happen when parsing those glossterms11:14
jsgotangcoremotely11:14
jsgotangcoack11:14
froud-workthat is the problem11:15
froud-workmy current solution11:15
jsgotangcoproblem too is that we don't need all those glossterms11:15
froud-workI have a wc or the glossdatabase11:15
froud-workbut we never know when we do11:15
froud-workis it reasonabl eto expect people to checkout a wc of the above11:16
jsgotangcoif you have a wc you can upload it but it will have a huge impact on bandwidth during transmission/download11:16
froud-workto a specific location11:16
froud-workcommon to all of us11:16
enricofroud-work: package the glossary and use it as a build-depend?11:16
froud-workenrico: not much use as a package when building html11:16
enricofroud-work: I didn't get you: what do you mean?11:17
froud-workthe glossary section is automatically generated at the end of the document11:17
jsgotangcofroud-work, its not that much of an issue anyway except for the file size i guess so you can just commit it11:17
enricofroud-work: my point was: package the glossary like we do with our docs, so that the docbook sources of it are installed somewhere.  Then our build system can just point at the locally installed version, like we do with the docbook stylesheets11:18
jsgotangcoat least it was committed this early11:18
froud-workenrico: not clear, let me explain11:18
froud-workat end of our doc we put11:18
froud-work<glossary role="auto">11:18
froud-work        <glossentry>11:18
froud-work            <glossterm>Dummy</glossterm>11:19
froud-work            <glossdef>11:19
froud-work                <para>Now you see me, next you won't.</para>11:19
froud-work            </glossdef>11:19
froud-work        </glossentry>11:19
froud-work    </glossary>11:19
froud-workthen we process passing11:20
froud-work<xsl:param name="glossterm.auto.link" select="1"/>11:20
froud-work    <xsl:param name="firstterm.only.link" select="1"/>11:20
froud-work    <xsl:param name="glossary.collection">../../../common/glossary.xml</xsl:param>11:20
froud-work    <xsl:param name="glossentry.show.acronym" select="'primary'"/>11:20
froud-workin doc we mark terms as <glossterm>fooo</glossterm>11:20
froud-workon transformation the XSL goes and collects glossentry for each glossterm11:20
froud-workdynamic11:21
froud-workbut not in yelp11:21
jsgotangcoit will break in yelp methinks11:21
froud-workso we transform XML > HTML and the above happens11:21
jsgotangcobut transformed to html no problems11:21
enricoyes, right, I get this11:21
enricoAnd it's all very very cool!11:22
froud-workOK I must go to meetings, think it over.11:22
enricothe problem is that the glossary entries are remote, so it takes a lot to compile?11:22
=== k31th [~stealth@flashtek-uk.com] has joined #ubuntu-doc
enricomy proposal is to package the glossary entries so that they can be installed locally11:22
k31thHello 11:22
jsgotangcoupload it on svn then?11:22
froud-workenrico: yes, and we dontneed to package the xml, just html11:22
enricofroud-work: but we'd need to package the glossary's XML11:22
froud-workI was thinking that we ask people to do checkout to vendor11:23
=== odyssey [~mat@odyssey.user] has joined #ubuntu-doc
enricofroud-work: and as a side effect, everyone that wants to do that trick can reuse the same package11:23
jsgotangcohello k31th 11:23
k31this there a place on the ubuntu site where there is a document request ? 11:23
k31thjsgotangco: watsup11:23
jsgotangcok31th, there is none but we have breezy targets11:23
k31thkk11:23
jsgotangcohttp://www.ubuntulinux.org/wiki/DocteamProjects11:23
froud-workenrico: that makes the payload very big11:23
enricofroud-work: the glossary's XML files, once packaged, would be found in /usr/share/glossary/stuff11:23
k31thso what do you need making 11:23
=== Skywind [~Skywind@218.94.37.185] has joined #ubuntu-doc
enricofroud-work: no, because it's a build-depend, not a dependency of the package itself11:23
froud-workenrico: ah I see11:23
jsgotangcohmmm11:24
enricofroud-work: you need that to BUILD, but then the relevant parts are copied in your package and you don't need the full glossary anymore11:24
froud-worklike installing the dtd or xsl11:24
enricofroud-work: right11:24
k31thbrb11:24
froud-workHmm. can you do a deb packaging for this, please11:24
=== froud-work goes to his knees
enricofroud-work: sure.  point me at a tarball with upstream sources11:25
jsgotangcoyeah that can really help11:25
froud-workenrico: no tarball as yet, but checkout svn://computerdictionary.tsf.org.za/terms/trunk/dict11:26
froud-workI will send you a commit acount11:26
froud-workgive me a minute11:27
enricofroud-work: ok11:27
enricofroud-work: in change for the packaging, you'll write a short text file explaining how to use the glossary in other DocBook projects, and we'll put it in /usr/share/doc11:28
jsgotangcojjeeezz this site is huge11:28
enricofroud-work: do you mind if I upload it in Debian instead of Ubuntu?  That'll make it more generally useful as well11:28
enricoAnd it'll get into Ubuntu on its feet, then11:29
froud-worksent11:30
froud-workok I must go to meeting. Thanks dudes11:31
=== froud-work is now known as froud
=== froud is now known as froud-away
k31tham i right in thinking this is the doc team ?11:37
jsgotangcothis is the doc team11:37
jsgotangcoheh11:37
jsgotangcoyou think this is the devel channel?11:37
k31thlol no...11:38
jsgotangcoanyway welcome how can we help you11:38
k31thso for example.. if i want to help with the admin guide11:38
k31thdo i just go ahead and write sections ?11:38
jsgotangcohmmm would you like some adventure in doing docs?11:39
jsgotangcoyou can check out svn if you want11:39
k31thk ?11:39
k31thsvn ?11:39
=== Kejk_PL [~Kejk_PL@ark10.internetdsl.tpnet.pl] has joined #ubuntu-doc
jsgotangcoall our docs are in svn11:40
jsgotangcohttp://www.ubuntulinux.org/wiki/DocteamStepByStepRepository11:40
jsgotangcowe do all our work in DocBook11:40
jsgotangcoyou don't need to know this for now11:40
k31thk11:41
k31thso11:41
jsgotangcobecausewith the docbook format, we can transform the document into any format we may need like html, etc.11:41
k31thwat do you want me to do basically :p11:41
k31thwat guides etc need writing11:42
jsgotangcohmm take your pick and let's see if someone is doing stuff on it11:42
jsgotangcoyou're empowered to hack away docs11:42
jsgotangcofroud-away, your dial-up howto is not well formed11:44
=== Kejk_PL [~Kejk_PL@ark10.internetdsl.tpnet.pl] has left #ubuntu-doc []
k31thjsgotangco: ok what about Secure shell in the security section11:45
k31thhttp://people.ubuntu.com/~mako/docteam/adminguide/ch05s05.html11:46
k31thi presume you want it writen in manual layout on how to secure ssh servers and clients ?11:46
k31thwith an a section explaining it ?11:46
jsgotangcohmm let me check the docs11:47
k31thkk11:47
jsgotangcohmm svn is empty as well i guess sean has some stuff to include but you're free to write stuff about it and commit. We're all going to review them before freeze anyway11:49
k31thkk11:50
k31thso if i just write a guide on howto  secure ssh 11:50
k31ththen show you it, thats kool ?11:50
jsgotangcoyeah we'll commit it11:52
k31thnice11:52
k31thno doubt ull ripp it apart as this is going to be my first doc :D11:52
jsgotangcobut committing them doesn't mean it goes in ok but its up for review11:52
jsgotangcothere's always a first time :)11:53
jsgotangcojust take small steps and when you think you're ready, go check out svn11:53
jsgotangcowe're not rushing, we're all learning11:53
k31thkool11:54
jsgotangco(we're going to rush before freeze though)11:54
k31this that the next release ?11:55
jsgotangcoyeah are you familiar with ubuntu release dates?11:56
k31thno i think its every 6  months am i right ?11:56
jsgotangcothat is correct11:56
jsgotangcothat means we're releasing breezy in october11:56
k31thkool11:56
jsgotangcohence the 5.10 mark11:56
jsgotangco(200)5.10(October)11:57
k31thahh i get it ...11:57
jsgotangco5.0411:57
jsgotangcoget it?11:57
k31thup i  gets it 12:02
k31thdoes much change between release ?? 12:02
Burgundaviayes12:02
jsgotangcoof course12:02
k31thi see12:02
Burgundaviaas much as they possibly can12:02
k31thi mean doc wise12:02
jsgotangcowe'll have mono by default12:02
jsgotangcok31th, definitely12:02
k31thkool12:03
jsgotangcosome stuff gets retained, most change12:03
Burgundaviayes, becuase new programs are added, and old ones changed12:03
jsgotangcognomebaker i hate you12:03
Burgundaviaserpentine is very cool12:03
jsgotangcobah after they finish breaking stuff12:04
jsgotangcoi had to manually fschk my drive a few hours ago12:05
jsgotangcothings just dont work12:05
jsgotangcohmm12:05
jsgotangcolost some files too12:05
jiyuu0jsgotangco, u mean gnomebaker broke ur filesystem?12:06
jsgotangcono no12:06
jsgotangcoi was doing my planner thing on emacs in a seminar this morning12:07
jsgotangcothen i had my laptop  sleep12:07
jsgotangcowhen i turned it on again, things went hairy12:07
jsgotangcountil things wont run anymore syaing my fs is read only12:07
jsgotangcoim backing up some files atm12:08
jsgotangcojust in case12:08
jiyuu0that's weird12:08
jsgotangcoit is12:08
jsgotangcofirst time i experienced it12:08
jiyuu0one weird thing i encounter is... suddenly sudoer files got lock for no reason12:08
jiyuu0so can't sudo anymore12:08
jiyuu0and no root passwd12:08
k31thjsgotangco: i presume in the security section of ssh you dont want me to tell them how to install sshd ?12:09
jsgotangcok31th, nobody's stopping you just write what you want12:09
jsgotangcowe'll go to specifics later12:10
jsgotangcoits a guide after all12:10
k31thkk12:11
jsgotangcook im out12:23
jsgotangcolater12:23
jsgotangcok31th, you can just email your stuff on the ubuntu-doc list12:23
=== sladen_ [paul@starsky.19inch.net] has joined #ubuntu-doc
=== sladen_ [paul@starsky.19inch.net] has joined #ubuntu-doc
=== sladen [paul@starsky.19inch.net] has joined #ubuntu-doc
=== sladen_ [paul@starsky.19inch.net] has joined #ubuntu-doc
=== sladen [paul@starsky.19inch.net] has joined #ubuntu-doc
=== jjesse [~jjesse@mail.ftpb.com] has joined #ubuntu-doc
mdkesupsup04:09
mdkemako, around?04:14
mdkejdub, did you get round to writing those emails you spoke of?04:26
jdubnot today04:28
mdke:(04:35
mdkemmmmmmm i tell y'all what is fun05:32
mdkeconverting a page to moin which has been written in html with what looks like microsoft word05:32
=== mdke finishes doing that
mdkeahhhhhhhhhhhhhhhhhhhhh06:39
=== jiyuu0 [~jiyuu0@219.94.81.23] has joined #ubuntu-doc
froud-awayenrico08:40
=== froud-away is now known as froud
froudenrico you there08:45
enricofroud: for very much short08:48
frouddi dyou understand my message08:48
froudso long as the computer dictionary can be packaged from the svn://computerdictionary.tsf.org.za/terms/trunk/dict/ folder08:49
froudit will not be used for disply08:49
froudjust as a build08:49
frouddependancy08:49
enricook, so the images are not used for the dictionary itself08:49
froudnot required when it is used as a database08:50
froudin root of trunk you have website too08:50
froudwe dont need tha08:50
froudt08:50
froudI still have to insert 21297 unique id values to the files before can use them08:51
froudbut if we get the packaging ready it will be good08:51
froudk31th: see you want to hack admin guide, welcome08:57
k31thhey09:04
k31thwassup froud 09:04
=== Skywind [~Skywind@218.94.37.185] has joined #ubuntu-doc
froudk31th: hi09:07
froudk31th: I see you are going to write some things on admin guide09:08
k31thfroud: yeah thats the ideal 09:09
k31thgoing to make a start in a min09:09
froudk31th: what is in the admin guide files now is just an outline, so feel free to write any section, add or delete as you see fit09:09
froudnobody else is hacking it at the moment09:09
k31thok brilliant 09:09
k31thahhh excellant 09:09
froudhave you seen the SuSE Admin Guide09:10
k31thno09:10
froudWhat About RH09:10
froudor Fedora09:10
k31thi was going to look at some other documentation first09:10
froudwhen I wrote the outline I had someting like the SuSE Admin Guide in mind09:10
k31thiv seen gentoo docs09:10
k31thand debian09:10
froudit should bee a book09:10
froudnot an online help09:11
froudOK great, well feel free to go for it09:11
froudr u ok with svn and docbook09:11
froudyou know how to create patches etc?09:11
k31thahh svn no 09:11
froudOk you running Ubuntu I hope09:12
k31thna windows ME09:12
k31thof corse i am :p09:12
k31thHoary 09:12
froudOK do you have subversion installed09:12
k31thi run debian gentoo ubuntu09:12
k31thim just doing it now 2 secs09:12
=== mkde [~matt@mdke.user] has joined #ubuntu-doc
=== mkde nods to channel
froudOk once you have svn installed just do09:13
froudsvn checkout https://docteam.ubuntu.com/repos/trunk ubuntu-docs09:13
froudthat will create a folder named ubuntu-docs in your pwd09:13
mkdefroud what do you use for editing xml?09:14
k31thok its doig it09:14
k31thdoing09:14
froudmkde: frist I must say I like the new nick09:14
mkdeheh09:14
froudkde rocks09:14
froudmkde: I use Oxygen XML Editor09:15
mkdefroud, i've used this nick for a while when I come on with my laptop, it was your idea, remember?09:15
froudmkde:  is is not free09:15
mkdeoh right09:15
froudyeah09:15
mkdeis it your program?09:15
froudjust noticed09:15
froudmkde: not mine09:15
froudI just wrote the manual a long time ago09:15
mkdeah09:16
k31thfroud: ok its done that09:16
froudk31th: I trust you have docbook dtd and xsl installed09:16
mkdefroud, anything else you would recommend? i'm on emacs right now09:16
froudmkde: do you mind java09:16
k31thfroud: err no09:17
mkdei don't have it installed i don't think09:17
k31thhave docbook09:17
mkdenothing against it licence-wise09:17
froudk31th:  ok you should have the tool chain installed09:17
froudk31th: http://www.ubuntulinux.org/wiki/DocteamWork09:17
k31thkk09:18
froudk31th: what editor do you use for editing09:18
froudmkde: you can use eclipse09:18
froudmkde: any xml aware editor will do09:19
froudeven kate09:19
mkdewill emacs do?09:19
froudmkde: of course09:19
froudpsgmls mode installed?09:19
mkdei'm pretty unfamiliar with emacs tho, but I installed some kind of xml plugin for it, no idea if its activated09:19
froudyou will know09:20
mkdehow?09:20
froudbut emacs is cool09:20
froudmkde: syntax highlights will come on when you load an xml with xml mode on09:20
mkdeok i have that09:20
mkdeand there is an xml menu too09:21
froudyep09:21
mkdeits ugly as hell but I'm sure it will work fine ;)09:21
froudyou can also use VI09:21
froudor VIM09:21
froudGedit will do good too09:21
mkdeoh right09:22
froudk31th: you should read http://www.ubuntulinux.org/wiki/DocteamStepByStepRepository09:22
k31thfroud: this is the first time iv been on a doc team09:22
froudeverything is more or less explained there about working with svn09:22
k31thi use nano to edit txt normally ?09:22
froudHmm is nano xml aware?09:23
mkdegedit looks pretty good09:23
mkdek31th, try gedit09:23
k31thfroud: ill read it09:23
froudk31th: if you want cli checkout VI http://www.ubuntulinux.org/wiki/DocbookVim09:24
k31thchain etc arnt in the repository 09:24
froudotherwise default to gedit09:24
k31thiv not like vim and vi in past09:24
mkdeme neither09:24
k31thi like nano 09:24
froudsorry what is iv09:24
mkdefroud, userguide seems to overlap heavily with other guides09:24
k31thi can use that ?09:24
mkdefroud, s/iv/vi09:24
mkdefroud, s/iv/i've09:24
mkdedoh09:25
froudk31th: I dont think nano is xml aware09:25
froudk31th: but it can edit xml09:25
k31thahh09:25
froudxml is just a text file09:25
k31thok09:25
k31thyeah i know09:25
mkdek31th, you can use nano but the relevant sections won't be as clear. For gedit see http://mdke.mine.nu/gedit.png09:26
k31thill try gedit ?09:26
froudmkde: yes ther eis overlap, it is intended09:26
mkdefroud, so I should try and sync it with aboutubuntu and installguide?09:26
mkdeor not?09:26
froudmkde: no write a book09:26
k31thmkde: yes i have it on screen loaded up09:26
froudmkde: user and admin guides are not short things09:26
k31thnow i just need to get cracking 09:27
mkdefroud, what do you mean write a book09:27
froudk31th: you know docbook?09:27
froudmkde: think of the user manual as a book, not online help09:27
k31thfroud: nope i need to get reading09:27
froudk31th: kk09:28
froudmkde: ever seen a user manual for SuSE?09:28
froudor Fedora09:28
froudmkde: tink like this09:28
k31thnope 09:28
k31thshould i check them out ?09:28
froudk31th: huh?09:29
k31thsuse manual09:29
mkdefroud, what is the difference between a book and online help09:29
froudk31th: I was speaking to mkde , but yes if you can find a copy of the user/admin manuals fo rother distros they will giv eyou a good idea09:30
froudOnline help is short09:30
froudbook explains longer09:30
froudmkde: go into your local book shop and se eif you can find a book on Linux, that wil lgive you the idea09:30
mkdefroud, sure, but users will use our documentation to find solutions to individual problems too will they not?09:31
froudSomething like Linux (Fifth Edition)09:31
froudThere is FAQ Guide for quick stuff09:31
mkdehmm09:32
mkdeyes i see that09:32
froudBut that does not give newbies enough background information09:32
mkdeso what you're saying is that the userguide should be more like a book, whereas the faq guide should be more like online documentation?09:32
froudIn User Manual you will have to give intro, background etc09:32
mkdemm09:32
froudYes09:32
mkdeok i see09:33
froudThink like you will go to a book shop and buy a book on Linux for beginners09:33
froudk31th: mkde : the same goes for the admin guide09:33
froudbut this is just a little more technical09:33
mkdebut still surely there should be an element of synching between the aboutubuntu->userguide documents and the installguide->userguide documents09:33
froudadmin guide should assume the person has read user guide or has some experience with linux09:34
froudThere is09:34
froudbut for now, just hack the src and I will get to that part later09:34
mkdecouple more questions, hope you don't mind09:35
froudshoot09:35
mkdethe indenting thing09:35
mkdeits really awkward09:35
mkdesee that screenshot i posted above?09:35
froudyou will find it useful09:35
mkdewhen you add things to paragraphs, is it necessary to redo the indenting?09:35
mkdedelete all the whitespace, then add more in a different place?09:36
froudmkde: dont worry about keeping the indent perfect09:36
mkdenaturally I understand the indenting of <tags>, i'm just talking about the indenting of text09:36
froudso long as you have a start and close tag09:36
k31thfroud:  so aim is for beginners even tho its a admin manual ?09:36
frouddont worry about that, just let it wrap09:36
froudk31th: yes, many users are new and yet they need to do admin tasks09:37
k31thfroud: yeah tru.dat09:37
mkdefroud, so in this example, its ok that one of the lines doesn't indent? http://mdke.mine.nu/gedit.png (new screenshot)09:37
froudmkde: fine09:38
mkdeok cool09:38
mkdethanks09:38
froudyou just hack the src and make sure it is well-formed09:38
froudI will take care of the pretty indents for you09:38
mkdeyou have it automated?09:38
froud;-)09:39
mkdecool09:39
mkdei've forgotten the last question i had09:39
froudsee tidy09:39
froudmkde: k31th : I assume you both know how to make patches09:39
mkdei can upload right?09:39
k31thfroud: theres a man or admin kde and admin gnome right ?09:39
froudmkde: do you have a commit account09:40
mkdeyes09:40
froudok so you can do commits09:40
mkdeoh yeah, my last question was, why didn't the userguide ship already? its not in bad shape09:40
k31thfroud: patches for?? froud dont presume im new to docs 09:40
mkdek31th, on that page that froud posted it describes how to submit patches for your changes09:40
froudk31th: when you have a peice finished you create a patch09:41
k31thyeah imreading down that09:41
froudsend it to me or the list and we will check it and apply it09:41
k31thtell you wat ill just read that and get on and ask here if im stuck ?09:41
mkdek31th, basically when you make changes, you make a patch and send it to the list, and we can apply the patch for you to update the doc09:41
k31thsounds great09:41
mkdek31th, we're always here ;)09:41
froudmkde: k31th : tip from me, work small, patch often09:41
k31thbrilliant so am i09:41
k31that work or home lol09:41
k31thwat a geek !09:42
mkdefroud, presumably a commit every 5 minutes isn't appreciated tho... o.o09:42
froudmkde: k31th : aim to do a section and then commit it09:42
frouddo logical blocks09:42
=== mkde nods
mkdeoh yeah, my last question was, why didn't the userguide ship already? its not in bad shape <-- froud09:43
froudnot ready to ship09:43
mkdeshame09:43
froudmkde: k31th : suggest you subscribe to th ecommit list09:43
froudsee http://www.ubuntulinux.org/wiki/ForTheHasty09:43
froudThis will show you when people commit to svn09:44
froudmakes life easier09:44
mkdehow come?09:45
froudmkde: when a commit happens in svn a copy of the patch is sent to the commit list, so you can see who did what09:46
froudwithout having to check and search for stuff09:46
froudare you subscribed?09:46
mkdenot right now09:47
froudif not subscribe now and I will make a commit to show what I mean09:47
mkdedon't worry09:47
mkdei see the point :)09:47
mkdei'll subscribe09:47
froudOK09:47
froud;-)09:47
mkdeare the messages subject header tagged?09:47
froudyes09:48
k31thdone09:48
mkdeexcellent09:48
froudwe dont mail to that list though only get09:48
k31thnow... im going to read that ppage :D09:48
froudmkde: you may find it useful to use a gui front end to svn09:49
k31thfroud: such as?09:49
froudsudo apt-get install esvn09:49
mkdefroud, i quite like cli svn tbh09:49
k31thfroud when i get round to writing this guide not learning howto write the guide :p do you want me to use cmd line or gui for the admin tasks ?09:52
k31thfroud: im a cmd line person myself... 09:53
mkdeimo it depends on whether the guide is specific to gnome/kde or intends to be independent of the two09:54
froudk31th: some things can only be done on cli other on both09:57
frouddefault to cli09:57
froudand if there is a gui route, use that as additional method09:57
froudmkde: there is a gnome user guide and a kde user guide09:58
mkdei meant the admin guide09:58
froudmkde: same09:58
mkdebut now you're on the subject, how would i link to the kde userguide from the gnome one?09:59
froudI foresee some convergence of the two in the future09:59
froudDont do it for now09:59
froudSoon we will have this capability09:59
mkdei think there is a fairly strong argument for not having separate ones but dealing with the specifics of each in one document09:59
froudusing olinks09:59
froudmkde: agreed10:00
froudthere will be10:00
mkdei'm just reading the section of the gnome userguide which talks about kde10:00
froudYes, there will be content reuse10:01
froudand links between10:01
mkdehmm10:01
k31thoh i get it i dopwnload it to a dir in my home dir then edit the .xml with say gedit then send the patch when done ?10:01
froudeventually I forsse that we will have one file profiled10:02
froudk31th: :-)10:02
k31thbrilliant 10:02
froud;-) just just a pretty face10:02
mkdefroud, is the userguide is an introductory book, i think ubuntu users should be told everything about kde too so that they can choose, and vice versa :)10:02
k31thi was thinking it was more comlicated than that10:02
mkdes/is/if10:02
k31thnice i can get started then10:02
froudmkde: up to you, what would you want to see and learn10:03
froudremember writing is an open ended process10:03
froudk31th: nah, easy stuff10:03
froudmkde: I leave it up to your good judgement10:03
mkdeok thanks10:03
mkdei'll need to learn about kubuntu first10:03
froudmkde: well you dont have to10:04
froudJust add comments10:04
froud<!-- Talk about Kubuntu here-->10:04
k31thfroud: where is the online version i find it easyer to view10:04
mkdefroud, yeah but i'd like to :)10:04
froudk31th: no online10:04
froudmkde: do you have lots of disk space?10:05
mkdefroud, no, but enough for it10:05
k31thoh its not online i see10:05
k31thok10:05
froudyou can use qemu10:05
k31ththat pwns 10:05
mkdefroud, yes i was thinking about using qemu for breezy purposes10:05
froudk31th: transform it to html for viewing10:06
froudmkde: ;-)10:06
mkdeis the kde userguide fairly advanced?10:07
froudk31th: you can also do yelp10:07
froudmkde: no10:07
froudkwick guide is doing well though10:08
mkdefroud, *nods*10:08
froudmkde: you should take a look at the generic install guide10:09
froudthis will give you an idea on how to do profiling10:09
froudyou wont need it for gnome user guide10:09
froudbut it is good to know10:10
mkderight10:10
froudoneday we will have a single file for kde and gnome10:10
froudprofiled10:10
mkdethat will be cool10:10
froudand for each platform10:10
froudbut for now the whole profilingt thing is a bit much for people to digest10:10
froudsame with outside links10:11
froud(between docs)10:11
froudso it is kept simple10:11
froudI plan to introduce glossary and biblio soon10:11
froudonce people understand those mechanisms then I will push olinks10:12
froudand then profiles10:12
froudall of the above is not supported by yelp10:12
froudso the transform will be to html10:12
froudat which time we will add CSS10:13
froud and some bling, with search and index features10:13
froudI know it is hard for people to visualize right now10:13
mkdecool10:14
froudbut by not making yelp or khelpcenter our targets for viewing we open the whole power of docbook10:14
mkdesounds exciting10:14
froudin about three months from now people should begin to see the whole picture10:15
froudthe more text, the better the picture will be :-)10:17
froudwell I am off to bed, been a long day10:17
froudk31th: you ok now10:17
=== froud is now known as froud-away
mkdenight froud-away 10:19
k31thfroud-away: i should be fine10:19
froud-awayOk10:19
mkdewho is henry-meyerding?10:19
k31thwhen iv ate my tea ill make a start10:19
=== froud-away is now known as froud
froudauthor who contributed dialup doc10:20
mkdeoh yeah10:20
froudok by10:20
mkdebye :)10:20
=== froud is now known as froud-away
=== maskie [~maskie@196-30-108-163.uudial.uunet.co.za] has joined #ubuntu-doc
k31thdammit i have to go see some one tonihgt, whens the deadline for thiese docs ? i presume its asap10:40
mkdeyou have about 5 months10:42
k31thoh nice 10:42
mkde:)10:42
k31thso one night wont matter 10:42
mkdethe work is kind of continuous10:42
mkdek31th, no not at all10:42
k31ththats great10:42
k31thwell i will start it tonight 10:42
k31thprobly around 1110:42
k31thi can do quite a bit from work tbh10:42
k31ththey dont mind me using irc e-mails etc just so long the work is done 10:43
mkdeawesome10:43
k31thyeah it is really 10:44
k31thgood money to10:44
mkdemagic10:44
mkdewhat do you do?10:44
k31thIT Technician / consultant 10:44
mkdecool10:44
k31thim only 20 mind so pay isunt ubba10:44
k31thyou in US ?10:44
mkdeuk10:44
k31thah right kool same here10:45
mkdelondon10:45
k31thim on just under 16 k10:45
k31thso 15500 10:45
mkdepretty cool10:45
mkdewhere do you live?10:45
k31thwhich was better than before10:45
k31thonviously that would be fuck all for a london job10:45
mkdeyeah its expensive here10:46
k31thbut i live in melksham small town between bath and swindon 10:46
mkdegotcha10:46
k31thyeah we some contracts in london 10:46
k31thi have to go there some time10:46
k31thon that shitty tube10:46
mkdewhich one?10:46
k31thwhich tube10:46
k31thumm10:47
mkdethe underground ya mean?10:47
k31thi get on at hanslow west and go to blac fiers ?10:47
k31thyeah10:47
k31thi hate it 10:47
mkdeyeah that sucks10:47
mkdeme too10:47
mkdeits the only thing i really dislike about london10:48
k31ththe first time i got on there i thought this is cool wat do people moan abut then we got passed the bankment and central london and it was full of stinking people breathing in my face 10:48
mkdeheh10:48
k31thim there clinging onto mylaptop 10:48
mkdein rush hour its appalling10:48
k31thyeah terrible10:48
k31thi sit  (normally have to stand ina  fucking door way) i dont want to touch that bar its covered in skanky germs and mank lol10:49
k31thbut it is the fastest way to get around im told10:49
=== mkde nods
mkdeyeah its the only way i can get around10:49
k31thonly good thing is10:49
k31thplaying with bluetooth10:49
k31thand trying to spot fitt looking girls10:50
mkdeheh10:50
mkdethere are lots in london10:50
mkdedue to the fact that there are lots of foreigners ;)10:50
k31thha ha10:51
k31thyeah10:51
k31thLOADS10:51
k31thcompared to round here10:51
k31thmost of the london contracts i have setup vpns and VNC or RDP so i can do it remotly 10:52
mkdei can do without london tbh10:52
k31thmkde: wat you do for work10:53
k31thyeah it would fuck me off 10:53
k31thi could probly deal with the outskirts10:53
mkdei am at law school at the moment10:53
mkdestart work in october10:53
k31thyou have the  advantage of faster internet in london tho10:53
mkdeheh10:53
k31thah right kool10:53
mkdei'm on 250kbps pipex10:54
k31thim only on 2mbps here 10:54
mkdeonly...10:54
k31thdownload ?10:54
mkdepoor sod lol10:54
mkdeyes 250/12810:54
k31thhow much you pay 10:54
mkde15 quid or so10:54
k31thnot bad10:54
k31thi pay 25 quid10:54
k31thon nildram10:54
mkdepipex are pretty nice10:54
mkdei like em10:54
k31th50gig cap a month but unlimited offpeak10:55
mkdenot the best price, but there is no cable here10:55
k31thim pretty sure pipex and nildram are same routing10:55
k31thdo a traceroute to jolt.co.uk if its 3 or 4 hops its the same10:55
k31thcurrently im logged into a box in the telhouse london :p10:56
k31thits where i run my irc to 10:56
mkdewhere is that?10:56
k31thIrssi uptime: 66d 9h 32m 23s10:56
k31thmkde: do you know where docklands is10:57
mkdei live there10:57
k31thits there lol10:57
mkdetelhouse rings a bell...10:57
k31thiv been to ISPs in docklands as well10:57
mkde7 hops to jolt.co.uk from here10:57
k31thFrontier net & anoutherone some where else10:57
k31thMistral10:57
k31thmkde: different routing then10:57
mkdenot sure10:57
k31thright ill be back in an hour or so10:58
mkdeok have fun10:58
mkdewelcome to the team10:58
k31thgoing down the pub10:58
k31ththanks :D10:58
mkdeswitching out on this box11:01
=== Burgundavia [~corey@S010600065be02c07.du.shawcable.net] has joined #ubuntu-doc

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