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

=== _froud [~froud@ndn-165-138-57.telkomadsl.co.za] has joined #ubuntu-doc
=== jsgotangco [~jsg@202.57.71.235] has joined #ubuntu-doc
jsgotangcohello03:34
=== BeerDump [~jsg@202.57.71.235] has joined #ubuntu-doc
=== jgotangco wonders what's the fuzz about yelp anyway, it works so far although there is more desirable features
=== robitaille [~robitaill@d154-5-117-228.bchsia.telus.net] has joined #ubuntu-doc
mptjsgotangco: I think we've reached the "show us the code" point of the discussion :-)06:17
jsgotangcohah07:45
jsgotangcompt, by chance, have you checked out the sytleguide in svn?07:49
mptjsgotangco: no07:50
jsgotangcoyou want me to make an html for you and send it by email?07:50
mptWhat format is it in currently?07:50
jsgotangcodocbook07:50
mpt"svn up" updates me, right?07:50
jsgotangcoright07:51
=== venda [~sean@ndn-165-138-57.telkomadsl.co.za] has joined #ubuntu-doc
jsgotangcoon the styleguide folder just execute the script07:51
jsgotangco"make html"07:51
jsgotangcoit will make a styleguide.html in the folder07:52
jsgotangcovenda, hi07:52
vendahi07:52
vendairclog is still stuck ;-(07:53
jsgotangcoyes07:54
vendawhat we speaking about this morning07:54
jsgotangcoit has been quiet07:54
vendaAh ok07:55
jsgotangcoso far the natives have been peaceful07:55
jsgotangco(interesting exchange on the list though)07:55
=== jsgotangco has sworn not to go online during weekends with family
vendaHmm, I know the problem07:56
jsgotangcoyou do?07:57
vendajsgotangco: I am looking for help on merging kudos into faqguide07:57
vendajsgotangco: sure, my mrs, calls me an addict07:57
vendasays I should spend less time online07:57
vendaSo I spent most of the weekend reading Python Programming:-)07:58
jsgotangcoi've been reading Ruby07:59
venda he he07:59
vendajsgotangco: how's the kwickguide08:00
jsgotangcoi have been busy but i did some small hacks08:00
vendaOK did you get all the screenshots?08:01
jsgotangconot all yet08:02
vendait always amazes me how long taking screenshots takes :-)08:02
jsgotangcoblame my existing contract08:03
vendano contracts are good08:03
vendascreenshots take time08:03
vendadunno why, just the way it is08:04
jsgotangcomy shots arent clean either08:04
vendaHmm why?08:04
jsgotangcomaybe i should take them at a low resolution then clean them up after08:04
jsgotangcoinstead of taking them in a hig-rez08:04
vendado you use imagemagic like we described08:06
jsgotangcoyep08:06
vendathat will give you the right res08:06
vendalooking at the screenshots I see you always have the Kubuntu desktop wall-paper in the background. Why?08:07
vendaimagemagic should capture just the window08:08
jsgotangcovenda, because the first shots werent made with imagemagic08:08
vendaAh ok08:09
jsgotangcothe new hack should fix it08:09
vendaOK08:09
vendajsgotangco: about messages on list. Is there anyting you want to say/ Do you agreee/disagree with the current strategy we are using?08:10
vendaI am just interested to know whether or not those ppl committing are happy with the direction or not?08:13
jsgotangcovenda, i like our current setup and would rather stick to yelp for now to deliver docs for breezy08:14
jsgotangco(sorry i think our current setup just needs housekeeping)08:14
vendathat's fine08:15
vendaso you prefer to dumb down the xml to support yelp08:15
jsgotangcolike jdub said before, what we need to do docs for now are already in our system let's just improve on it08:16
vendawhat kind of housekeeping 08:16
vendayes our focus is on writing the docs08:17
jsgotangcomy gripe is with the current state of gnome docs which is catalogued by scrollkeeper08:17
vendabut that is upstream work08:17
jsgotangcoif we can fix that, we can contribute that to upstream then08:18
vendawell then I would suggest that we all move to GNOME docs08:18
vendano point working at ubuntu on gnome docs08:18
vendamuch better to move upstream and work there08:18
vendabut that would mean ubuntu docs suffer08:19
jsgotangcoheh it doesnt have to be that way08:20
jsgotangcoi mean what can we do with existing stuff08:20
jsgotangcounless ubuntu really goes by itself08:20
vendaHmm not sure I undersatnd08:20
vendaGNOME has a Desktop Manual and app docs08:21
jsgotangcoi still like the current setup probably because i am learning from it08:22
vendaSo you want yelp to view the xml or the HTML08:23
jsgotangcoeither whatever works08:23
jsgotangco(although some xml still isnt being recognized by yelp)?08:23
vendaOK did you understand why I am saying to direct at HTML08:24
jsgotangcoummm..not entirely sure but i would guess when rendering it?08:24
vendaI am not saying lose Yelp I am saying instead of using XML under yelp we will have yelp view HTML08:25
vendathis obviates the need to dumb down the xml to support yelp08:25
vendaenables more features08:25
jsgotangcowill it make yelp faster?08:25
vendaYelp will still load in th etime it takes, but viewing individual pages in faster08:26
vendasince it will not be transforming and then rendering 08:26
vendait will just be rendering08:26
vendathere is some confusion about the term "web-based" app08:27
vendathe web-based app I speak of in really an HTML frameset, pages, CSS, jscript08:27
vendaYelp will not load the frameset08:28
vendaand no jscript, unless the new release will support it08:28
jsgotangcowill the packaging be the same?08:28
vendathe packaging is the same, except we package HTML08:28
vendausers can optionaly install the src package08:29
vendabut the src will not always be supported by yelp08:29
jsgotangcowill the html pages in yelp still show the pages catalogued by scrollkeeper?08:29
vendayelp toc does that08:30
vendaor are you talking aboutthe main page08:30
jsgotangcomain08:30
vendathe main pag eof yelp is not touched by us08:30
jsgotangcoyes i know that, i mean will it still be the same for now08:31
vendayes08:31
jsgotangcoi wouldn't mind that, but we still have to write in docbook for obvious reasons and just transform it during packaging08:31
vendayes, instead of shipping xml that yelp wont support at present, we ship static HTML08:32
jsgotangcoi like that08:32
jsgotangco(we can probably save some space on the disc as well)08:33
vendayes it does08:33
jsgotangcoi think this is a more acceptable solution for now08:33
vendaI would howver like the About Ubuntu link to open our HTML frameset08:33
vendathat is what we are saying08:34
vendawell me08:34
vendaThe About Ubuntu menu option currently opens FF08:34
vendain 5.10 instead of just showing About Ubuntu Doc there will be an HTML frameset with TOC access to all our docs08:35
vendarelease notes etc08:35
jsgotangcohmm08:35
jsgotangcothey don't want that?08:35
vendaI think people do not understand or cannot see the vision08:36
jsgotangcoi think that is so simple if you ask me08:36
jsgotangcoit would render the same pages anyway08:36
jsgotangcoright?08:36
vendayes. I need to build a demo08:37
vendabut now I am sidetracked into merging kudos into faq guide08:37
jsgotangcovenda, that frameset is just one html page it shouldn't be that much of an issue08:38
vendayes08:38
vendathe toc is also html08:38
vendajust styles with css and made interactive with jscript08:38
jsgotangcoi dont see it even go beyond 5kb08:38
jsgotangcovenda, i dont see any problem with this, it is very much doable and promotes reuse of existing packaged stuff08:39
vendayes, because it is a frameset, individual pages can be accessed one at a time08:39
vendaso yelp will have access to individual pages08:40
jsgotangcohmmm what's the fuzz with the thread then08:41
vendaI think ppl think that we are looking to replace yelp08:41
vendabut that is not so08:41
vendayelp will just be viewing html from us and not transforming xml08:42
jsgotangcoi say we go that path08:42
jsgotangconobody needs the xml anyway08:42
vendabut we will enable access to ubuntu doc collection under a html frameset08:42
jsgotangcovenda, will the collection be in the cd or online?08:43
vendawell xml is not meant for presentation08:43
vendayelp tries to transform the xml to html on the fly08:43
jsgotangcoyes i noticed that08:43
vendabut it does not support all docbook08:43
jsgotangco(and not very good at it)08:43
vendait supports only what gnome docteam need08:44
vendathe docs will be packaged as normal on the cd08:44
vendaand will be available online at help.ubuntu.com08:44
vendawell that is the idea08:45
vendaneed to hear back from Hendrik on this08:45
jsgotangcoi think that is doable and acceptable to the brass08:45
vendafor preview during devel we will hopefully have use of docteam.ubuntu.com08:45
vendawell we will see08:45
vendawhat does this mean for kwick guide08:46
jsgotangcohmmm08:46
vendait means that you will be able to use interdoc references08:46
jsgotangcoi dont see any problem considering kde does khtml08:46
vendayes, KHelpcenter uses HTML08:46
vendabut in general in means that we will be able to link between our docs08:47
vendawe will not be able to link to docs under yelp08:47
vendathis is the weak link08:47
vendathe tradeoff is a balance between greater functional support of docbook and support of yelp08:48
vendaI think it is a worthwhile tradeoff08:48
vendaif we can use links between our docs08:48
jsgotangcohmmm08:49
vendaand freatures such as glossary and index can be used08:49
jsgotangcowe can probably worry about that later if yelp really gets ugly for us08:49
vendawell we hope that jdub and shaunm can improve on yelp08:49
jsgotangcomaybe you can email this again and explain it further in detail08:51
vendajsgotangco: but staying true to docbook, I think that oneday, help will be able to support all docbook xml08:51
vendawell I am mostly interested in ppl who are comtting08:52
vendaat present that is you, mdke and I08:52
jsgotangcowell you forgot jeffsh08:53
vendaoops and jeffsh and jjesse08:53
jsgotangco(what can 4 people do at the moment)08:53
jsgotangcowith 1M users08:54
jsgotangco(1M is conservative based on the no of warty cds shipped)08:54
vendaallot if they focus on writing and do not get derailed by all these discussions08:54
vendalook at yourself how well you have done with kwickguide08:54
jsgotangcoheh its not much at the moment, but i agree it has come a long way08:55
vendaWhat I have found is that we get more done if we focus on writing the docs and just use what docbook has given us instead of trying to figure out work arounds to helpviewer limitations and desktop incompatabilities08:56
vendabut I want the commiters to understand the HTML strategy08:56
vendaAt present this is the only way I see of negating the problems08:57
vendaI hope yelp will oneday support full docbook08:58
vendaI know that Shaunm wants this, but without help from other developers he cannot do it all alone08:58
vendahopefully now that jdub is getting involved and there is some traction at freedesktop.org we will see greater support for docbook as a standard08:59
jsgotangco(shouldn't it be in the first place)08:59
vendain a perfect world09:00
vendawell gotta go get dressed09:00
jsgotangcook i gotta grab a sandwhich09:00
vendacoffee finished day must start09:00
vendac ya09:00
=== venda [~sean@ndn-165-138-57.telkomadsl.co.za] has left #ubuntu-doc ["work"]
=== _froud is now known as froud
froudlife gets interesting when you get .Net on Linux http://www.codeproject.com/showcase/Mainsoft_grasshopper.asp11:36
jsgotangcojava?11:42
=== froud loves java
jsgotangcoblasphemy!11:42
froudI take an open approach to technologies, if it works I use it.11:43
froudfree from religios questions I can do more11:44
jsgotangcoi condemn thee to be hang, drawn, and quartered11:45
froudhold on I have not got my black leathers on11:45
=== jsgotangco wonders what Burgundavia has been up to lately
=== froud also notices he is awfully quiet ;-)
mdkethere is so much crap on the wiki11:46
mdkesometimes I'm tempted just to delete hundreds of pages11:46
jsgotangcoahhh my favorite barrister is now awake11:46
mdkemorning m'lud11:47
jsgotangco(the only barrister i know of anyway)11:47
mdkehey11:47
mdkei preferred "my favorite"11:47
jsgotangcohow long will you be one anyway11:47
mdkefor ever!11:47
jsgotangcoackk11:47
jsgotangcois a barrister the same as a solicitor11:48
mdkenot quite11:49
mdkea barrister speaks in court11:49
mdkea solicitor does the stuff behind the scenes, like taking the client out to dinner etc11:49
jsgotangcohmm11:50
jsgotangcoi like the solicitor then11:50
mdke;)11:50
=== froud likes the barrister job
jsgotangcoespecially if the client is a young widow of an 90-year old oil baron11:50
froudmmmmmm11:51
=== mdke nods
mdkejsgotangco, i told you to stop going out to dinner with young ladies11:52
mdkehave you guys seen the page http://wiki.ubuntu.com/EverydayUsage11:52
mdkeit sucks SO bad11:52
froudmdke: watch what you say soon he will focus on little boys :-(11:52
froudbut there are nice ideas there for User Guide11:53
froudlike I never thought of having a section on compiling11:54
mdkenor did i11:54
froudI wonder if that is a good idea or not11:54
mdkewhy in gods name is he telling people to compile mplayer11:54
frouddunno11:54
mdkeno not for beginners imo11:54
froudmplyer is in the repos11:55
mdkequite11:55
froudguess if you want specific codecs11:55
mdkestill don't think that is necessary11:56
mdkealso telling users to compile kde?11:56
mdkecrazy shit11:56
froudsometimes I build kde from CVS11:57
froudbut that is for development11:57
froudnot averageuser11:57
mdkequite11:57
jsgotangcolet's just nuke the wiki one time11:58
froudnot before we have ported the stuff we need :-)11:58
mdkeyes11:58
mdkethat's why I have left that page11:58
=== froud is reminded that we still need a list
mdkejust in case it has something that would be useful11:58
jsgotangcoi dont even use our wiki to search for something useful11:59
mdkeBe RiGhT bAcK12:06
=== warthylog [~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
=== #ubuntu-doc [freenode-info] help freenode weed out clonebots, please register your IRC nick and auto-identify: http://freenode.net/faq.shtml#nicksetup
froudInteresting concept and perhaps a tool12:50
froudwould be nice to see how this works.12:51
froudBTW. The LFS book is great12:51
froudNice use of docbook 4.412:51
froudnice use of xinclude and entities12:52
froudand very neat custom layers12:53
jsgotangcohmm12:53
froudimpressive12:53
jsgotangcoill check it out later12:53
jsgotangcoi gotta go12:53
froudok12:53
=== Seveas [~seveas@seveas.demon.nl] has joined #ubuntu-doc
=== jjesse [~jjesse@mail.ftpb.com] has joined #ubuntu-doc
=== enrico [~enrico@enrico.developer.debian] has joined #ubuntu-doc
=== jjesse [~jjesse@mail.ftpb.com] has joined #ubuntu-doc
=== mpt [~mpt@203-167-186-88.dsl.clear.net.nz] has joined #ubuntu-doc
Burgundaviamorning all06:26
BurgundaviaI have had a busy weekend, and have not been at the computer much06:27
=== jeffsch [~jeffsch@fatwire-203-84.uniserve.ca] has joined #ubuntu-doc
jjessemorning burgundavia06:49
jjesseor afternoon as it is here :)06:52
=== froud [~froud@ndn-165-138-57.telkomadsl.co.za] has joined #ubuntu-doc
=== venda [~sean@ndn-165-138-57.telkomadsl.co.za] has joined #ubuntu-doc
vendaelo08:35
=== froud [~froud@ndn-165-138-57.telkomadsl.co.za] has left #ubuntu-doc ["Konversation]
=== venda [~sean@ndn-165-138-57.telkomadsl.co.za] has joined #ubuntu-doc
=== sivang [~sivang@box79162.elkhouse.de] has joined #ubuntu-doc
Burgundaviavenda, here10:30
vendaBurgundavia: in a minute10:30
vendaBurgundavia: catch you in the morning10:35
=== venda [~sean@ndn-165-138-57.telkomadsl.co.za] has left #ubuntu-doc ["Konversation]
Burgundaviaok10:37
=== Seveas [~seveas@seveas.demon.nl] has joined #ubuntu-doc
mdkeaha11:33
mdkebravo enrico11:33

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