/srv/irclogs.ubuntu.com/2005/03/14/#ubuntu-doc.txt

=== Burgundavia [~Burgundav@S0106000000cc07fc.gv.shawcable.net] has joined #ubuntu-doc
froudAfrican Greetings07:01
froudenrico: I have added OMF files for FAQ and QG. Build needs to install them.07:21
=== enrico [~enrico@enrico.developer.debian] has joined #ubuntu-doc
froudenrico: you got the updates11:11
enricohello froud!11:12
froudhello11:12
froudyou got the message re OMF11:12
enricoYou mean, yesterday's changes?  Yes, I've seen them last night11:12
froudno todays11:12
froudcheck list11:12
enricoI fixed the makefile to point xsltproc to DocBook 4.2.1's catalogs11:12
froud:-) thannks11:12
=== enrico checks list
enricooh, great!11:14
froudso the build needs four omfs and registration11:15
froudwe can't get it into array 6, Kamion already just released it11:16
froudArray 6 does install the doc packages though :-)11:17
froudso users will get our updates11:17
enricooh, so we're already in the main seed and stuff11:17
enricoor desktop seed11:18
froudsure11:18
enrico(I still haven't gotten around so know these seeds things very well)11:18
froudonce we have the new build it will show in Yelp11:18
froudAt present they dont show11:19
enricofroud: is faq.omf about the FAQ Guide?11:21
froudyes11:21
froudrename if you need11:21
enricook, I'll change the title then (It's the Unofficial Ubuntu Guide)11:21
froudPerhaps we can work on that for Grumpy and make it official :-)11:22
enricoAnd the creator is more like Chua Wen Kiat11:22
froudyes11:22
enricoAnd it's (argh) for Warty11:23
enrico(now that I see the title on ubuntuguide.org11:23
enrico)11:23
froudyes, I know11:23
enricoNow that the quickguide is almost finished, we could coordinate with Chua about upgrading the guide for Hoary11:23
froudyes but it must be done in svn11:23
froudotherwise plovs work was for nothing11:24
enricosure. It could be the moment in which we converge11:24
enricoAnother thing I had in mind for post-quickguide was to get access to some document in /usr/share/doc/<package>11:24
enricoI'll make a wikipage for post-hoary docteam ideas11:25
froudyes, it bothers me that everyone is off doing their own thing. We need a focused effort11:25
enricolike a brainstorming page11:25
enricowhich calls for a meeting soon11:25
froudlike there is an Unofficial User Guide :-(11:26
froudAll this defocused stuff will get confusing for the user11:26
froudb'side we need the help11:26
enrico2 new people subscribed to our commits mailing list today11:42
froudI asked ari if he will be staying with us for grumpy develop. If he is we should create him an account.11:43
froudenrico: did you manage to build it and see it in yelp11:45
enricoI built.  Now I try to install it11:45
sivangmorning all11:45
froudboker tov11:46
enricomorning sivang !11:46
sivanghey enrico, froud 11:46
sivangfroud: did you get along with making the docs appear in yelp?11:46
froud:-) yep11:46
froudwe're cooking with gas now11:47
froudsivang: enrico is just testing the packaging build11:47
enricofroud: Ok, I get them inside the "Generic" category"11:48
=== froud sets reminder to file bug for mdz about scrollkeeper, db 4.3 and xml catalog problem
froudenrico: ok let me build an dtest it too11:48
froudall your commits in11:49
enricoThings show up nicely, except the image in the "Abount Ubuntu" page11:50
enricofroud: there's a very new commit fixing the title in the QUickGUide OMF11:50
sivangfroud: yep, it's mportant :)11:50
sivangenrico: Howdy!11:50
froudenrico: nice, all there and working. Now it would be better if we can get the Ubuntu Docs on the default yelp page11:56
enricofroud: yes... dunno how to do it, though11:57
froudthat make two of us11:57
enricobut I can try to figure out11:57
froud:-)11:57
froudgimme a hint and I will help11:57
enricoI'm reporting some tons of bug atm11:58
sivangenrico: I think I can help here11:58
enricosivang: Please do11:58
sivangenrico: (wrt your last question in -devel)11:58
froudsivang: go on then what do we need to do11:58
sivangenrico: is the omf file available from the source pkg?11:58
enricofroud: and how about the image in the about ubuntu document?  Does it show up in your yelp?11:58
sivangthom appears to hav already helped you 11:59
froudno yelp is to stupid11:59
enricosivang: yes, but his help is not accessible11:59
sivangenrico: oh how come? :-/12:00
enricosivang: the mail has not reached the list (possibly moderated)12:00
sivangenrico: anyway , svn co url is the way to go if you just want to checkout the doc repor without having an account right? (I'm doing a couple of thins in between and can't set up my account now)12:00
enricosure: plese svn co the thing12:01
sivangenrico: k, thanks.12:01
sivanghttp//docs.ubunut.com right?12:02
froudsivang: https://docteam.ubuntu.com/repos/trunk12:02
sivangfroud: tnx12:03
sivangchecking out12:04
sivangenrico: where in trunk are the omf files?12:09
enricosivang: debian/12:09
sivangeh found12:09
sivangenrico: yes, sorry12:09
=== enrico goes for lunch
sivangenrico: I'm trying something at it , let's see what comes out :)12:19
enriconice snow storm here12:46
enricosivang: thanks!12:46
sivangenrico: hey I envy you for being in Italy in a nice snow storm12:49
sivang:)12:49
=== enrico feels too cold to be envied
sivangenrico: ping again01:04
enricopong01:04
sivangenrico: I think I can creat a topleve catagory for our docs , still checking :)01:04
=== sivang is building a new yelp with the elleged catagories in
sivangbah it takes long to build01:07
enricosivang: sure it does :(01:07
sivangfinished :)01:08
sivanginstalling (over my system)01:08
sivangnow let's check 01:08
sivanggot it!01:08
sivangI did it :)01:08
enricoit works?  WOW!  I want to see01:09
sivangenrico: it's only an catagory addition, would you like to take on from here?01:09
sivangenrico: I have some bugs I'm fighting with at moment besides that01:09
sivang:)01:09
enricosivang: just show me what you did01:09
sivangenrico: but that was satisfactory01:09
sivangenrico: sure :)01:09
enricoa patch (svn diff) or something01:09
enricoif it's short, paste it here01:09
enricofroud: do you still need a hand for those validity errors?01:10
sivangenrico: how do I hand install file to scrollkeepr database?01:11
froudenrico: yes01:11
enricofroud: gnam gnam, let's see...01:11
enricosivang: scrollkeeper-install?01:13
enricosivang: post that patch! :)01:13
froudenrico: http://scrollkeeper.sourceforge.net/documentation/writing_scrollkeeper_omf_files/ar01s08.html#skomf-registering01:14
enricosivang: that link is for oyu01:14
froudyou can also test it01:15
froudscrollkeeper-install -i -p foo_db_dir foo.amf01:15
froudomf01:15
sivangenrico: eh, I see now I only managed to add a toplever catagory in yelp, but there is apparently more work to do to make it a "section" with the docs underneath it 01:16
froudenrico: dunno if I will get to those valid errors in FAQ01:16
enricofroud: what would the 'base' attribute do in the <chapter> element?01:16
enricosivang: would you mind telling us HOW you did it?01:17
sivangenrico: ok, I don't think you would need a patch for that, here goes:01:17
sivangenrico: go to /usr/share/yelp01:17
sivangenrico: then edit the file toc.xml01:17
sivangenrico:  <toc id="UbuntuDocs">01:18
sivang    <title>Ubuntu Documentation</title>01:18
sivang    </toc>01:18
sivangadd this01:18
sivangand you get a nice toplevel catagory in yelp01:18
sivangnow, how do you make it corrospond to a scrollkeeper databse entry..01:18
enricooh, ok.  That's a problem for me anyway, because my .debs can't change a file belonging to another package01:19
sivangenrico: a patch for this file should go into yelp source package,01:19
sivangenrico: if you want it to get installed. and yelp is the package which installs it01:20
enricooh, yes, trye01:20
enricooh, yes, true01:20
sivangenrico: I hope I helped a bit :-/01:20
enricoI forgot that we have the freedom of patching the other packages :)01:20
sivangenrico: hehehe01:20
froudenrico: where do you have a @base?01:21
sivangenrico: I can patch it for you if you like, I am just still trying to figure how to match between yelp toc.xml and the db catagories01:21
sivangenrico: and seb would review/upload01:21
enricosivang: sounds good, let's try that.  When you got how to have an "Ubuntu" cagetory, we can just use that01:22
enricothat'd be really nice!01:22
enricofroud: it's when validating things: it tells me "faqs/GettingStarted.xml:9: element chapter: validity error : No declaration for attribute base of element chapter"01:23
enricoI'll start fixing all of them, as soon as I can understand the error message :)01:23
enricofroud: ops.  While googling I see that someone asked the same question, but got few results01:25
enricofroud: and he was some "Sean Wheller" :)01:25
enricoit's happened to me before to look for my problem in Google and to find... my problem, reported by me (or someone working with me) months ago already01:27
froudHmm the xml base problem.01:29
froudDocbook 4.1.2 did not know what to do if xinlcude docs are not in the same dir as the including file01:31
froudObviously that was one of the reasons why I used Docbook 4.3 :-)01:31
enricouhm... thinking01:31
froudso solve this we can mv all docs in faqs to ..01:31
froudthen change the fileref values01:31
enricothat was what I was thinking01:31
froudyou want to do it or shall I01:32
enricoI do it01:32
froudok01:32
froudenrico: more of a problem is what is the sect-general that all those xrefs link to01:34
froudI don't see any section called General Notes01:34
enricofroud: that is?01:34
enricoOh.  You can see it in ubuntuguide.org01:34
enricoit's like a disclaimer01:35
enricostrange it's not in the repo01:35
froudHmm ok01:35
froudfound it01:36
froudwierd it is in the document &general-notes;01:37
enricofroud: committed: now it works01:38
enricoI'll also rename faq2.xml in something else01:38
enricoI'm checking Chua Wen Kiat's blog: he appeared in another 2 newspaper articles!01:41
sivangenrico: any progress?01:44
enricosivang: the FAQ Guide now validates01:45
enricofroud, sivang: DocteamPostHoary !01:45
sivangenrico: what?01:49
enricosivang: it's a wiki page01:49
sivangenrico: I can't figure out what needed to be done furhter to make the yelp catagory valid01:49
sivangenrico: sorry01:49
enricosivang: no problem01:49
sivangenrico: darn, this yelp --> scrollkeepr relationships stuff is pretty complex01:49
=== froud wants to kill yelp altogether. The days of help viewer apps is gone
froudOh and Jeff agrees01:51
froud:-)01:51
enricoI don't know what to say: at the conf they liked the idea of the about page showing up in yelp...01:52
froudabout page and ubuntu docs should be under firefox01:53
frouduse mono to create a toc01:53
froudmuch easier01:53
froudpeople who use man, use cli01:53
froudenrico: did you rename faqqqq2.xml01:54
froudenrico: did you rename faq2.xml01:54
sivangfroud: since when did he agree with that?01:57
froudsince he sent mail yesterday01:57
=== froud knows sivang does not actually read the list
enricofroud: no, I didn't rename it01:58
sivangfroud: you mean to the doc list?01:58
froudare you going to01:58
sivangfroud: I don't get how mono creates documentation tocs :)01:58
froudsivang: the one and only01:58
enricofroud: i thought about doing so, if that is not a problem01:58
sivangfroud: or how it can be used to created documentation either01:58
froudenrico: let do it01:58
froudsivang: huh now you lost me01:59
sivangwell, I can't give hand to this :) I'm a shaunm fanboy and on his mub ;-))01:59
sivangtoo bad his not around at the moment, otherwise he would help us alot 01:59
froudsivang: most of the packaging problems we are having are caus eof yelp/omf/scrollkeeper01:59
enricofroud: "faqguide.xml", allright?01:59
sivangwe just don't know them too well :)02:00
froudenrico: not particular just give it a name02:00
froudbut remember to update the build02:00
froudI will adjust  the makefile02:00
enricofroud: renamed.  Testing...02:01
enricofroud: committed.  Makefile should be ok as well02:04
enriconow I'm considering renaming the OMF files adding the language code02:05
froudI think it is a good idea. thom is right about that02:05
enricoI'm on it, then02:05
froudthanx dude you're a star. I just don't have much time now to get into new things02:06
froudTrying to prepare for Linux World JHB02:07
froudbut I had a brain fart and cant think waht to write02:08
enricofroud: white page panic?02:08
froudenrico: brain fart two para then stop02:09
frouddelete02:09
froudtwo para02:09
frouddelete02:09
froudtwo para02:09
frouddelete02:09
enricofroud: take some playing cards, and some post-it notes02:09
enricofroud: brainstorm silly ideas for contents on the post-it notes, and stick one idea to one playing card02:10
enricofroud: (use the back of the card, so that the image doesn't distract you)02:10
enricofroud: after you have your deck of ideas, spread it on the table02:10
enricofroud: then, group them without thinking, according to your instinct02:10
froudits always easy to write for everyone else but never easy to write for ones self02:11
enricofroud: don't ask yourself questions and don't think while you group them (also while you brainstorm them, if you want)02:11
enricofroud: after you're satisfied with grouping, turn your rational mind back on and look at what you have and what are the groups02:11
enricofroud: this is called "Card sorting" and it's very useful02:11
frouddoes that work02:12
enricofroud: very well for me02:12
froudmust be an Italian thingy02:12
enricoit allows you to "touch" your ideas, work on them freely on a large surface with two hands02:12
froudnever heard of it02:12
froudlets try02:12
=== froud goes to get a deck of card
enricofroud: They do it, for example, when deciding which action goes on which menu on a user interface02:13
froudand that's why the GUI is so confusing :-)02:13
enricothey prepare the cards, one card per program function, then ask a sample of users to group them02:13
froudI didnt know that02:13
enricothat allows to have the actions sorted according to the brain model of the users and not the one of the developers02:13
froudcool ide02:14
froudidea02:14
enricoI don't know, however, which applications have been designed like this02:14
froudOK I am going back to the drawing board. Is there anything else left before I move02:17
enricoI'm quite satisfied with today.  I could upload the new packages to Hoary and then look for mdz02:18
froudsounds good02:18
enricoI have tons of things to ask him: freeze dates, yelp or not yelp, post-hoary goals, docteam meeting, notify us when app features change...02:18
enrico:w02:18
enricoops02:19
froudwe still need to close some of those new menu items02:19
froudI posted about them to the list02:19
enricoSeen it02:19
froudpitty if we did not finish them02:19
froudonce we have done that we can do a final check and then final package02:19
enricoyes02:20
froudthen tag02:20
froudand meet02:20
enricoI'll post a recap of things needing help in the list02:20
enricoyes!02:20
froudand decide new directions for grumpy02:20
sivangare you guys planning a meeting?03:06
=== froud nods
sivangah ok, I'll have to catch up a lot on -doc to see when and where.03:07
=== froud looks at kubuntu and wonders how this will impact docteam
=== froud [~froud@ndn-165-131-148.telkomadsl.co.za] has joined #ubuntu-doc
enricofroud: around?04:48
=== dand [~dand@gw.datagroup.ro] has joined #ubuntu-doc
=== dand [~dand@gw.datagroup.ro] has left #ubuntu-doc ["Leaving"]
=== maskie [~maskie@196-30-108-208.uudial.uunet.co.za] has joined #ubuntu-doc
froudenrico: what's up07:44
=== froud just got back from 3 hours of lectures. enrico I am off for the night. send mail for the morning.
enricofroud: ok.  I had a chat with mdz, I'll post the results07:56
=== abelli [~abelli@adsl-ull-150-5.41-151.net24.it] has joined #ubuntu-doc
abellisivang: enrico: ChrisH 09:36
abelliping09:37
abelliKinnison: ciao r you here?09:37
sivangabelli: pong09:38
abellisivang: http://socrates.homedns.org/cms/09:38
abellitell me what you think09:38
abelliplease09:38
abelli:))09:38
sivangabelli: A M A Z I N G ! ! ! !09:42
abellisivang: is it this bad?09:42
abelliahh.. right ;)09:42
sivangabelli: I want this also for my local website, simple CMS?09:42
abelliyes09:42
sivangabelli: amazing, really.09:43
abellisivang: but let's see if ill be the italian loco leader anymore :(09:43
sivangabelli: why?09:44
abellisivang: a person, complained about how, he said, i do direct the community..09:44
abelli:((09:44
sivangeh I se09:44
sivangsee09:44
sivangwell , what can say09:44
abellithe problem is, i didnt direct anything..09:44
sivanghmm09:44
sivangwell, then start directing :)09:45
abellibecause ive been working on a proper website09:45
abellito give support and blah blah blah..09:45
abellii did only one big mistake..09:45
abelli:(09:45
abellibecause i didnt want to leave user without a website..09:45
abelliwe had www.ubuntuitalia.it, opened up some weeks ago, 09:45
abelliand this person helped with forums09:46
abelli...now he goes here and there, saying hes ubuntuitalia..09:46
abelliwhen i asked him to respect the code of conduct, he just complained with smurfix..09:46
abelliim so sad09:47
abelli..let make things clear..09:47
abellithe other 99% of the ppl that worked in ubuntuitalia is with me..09:47
abellibut im still sad09:47
sivangwell, talk to smurfix and you would be alright09:49
sivang:)09:49
abellisivang: he has no time for me today, hes going in london to tomorrow09:49
sivangabelli: eh, good for him :)09:49
sivangabelli: what's going on in london?09:49
abellihmm dunno09:50

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