/srv/irclogs.ubuntu.com/2007/10/22/#ubuntu-doc.txt

=== Flannel_ is now known as Flannel
seisenWhen does the documentation for Hardy start?14:24
nixternalnot for a while14:27
nixternalI would say at a minimum, if a lot of stuff doesn't change and the specs have been approved at UDS, we could probably start working on documentation in 2 months14:28
nixternalbut we tend to wait until the last couple of months, that way there we no stuff won't change drastically...14:28
jjessehopefully at UDS Boston I can get a start on things14:30
nixternalme too :)14:37
nixternalschoolio time...back later14:37
seisenI was just wondering so I could help with some of the little stuff14:48
jjesseseisen: you can start cleanning up th wiki14:56
jjessewhich would be a great help14:57
seisenI have been cleaning the wiki up but lately I haven't had time14:57
seisenI know the wiki is a mess, but I do have two days off so maybe I can get some cleaning done this week14:58
jjessecool good luck14:59
seisenI think some of the pages might just need the category cleanup tags removed because they have been cleaned up but the tags not removed15:00
jjessewouldn't be suprised if that was all it took15:04
seisensome of them do need cleaned up like the one's for beryl because the repository are no longer available15:05
seisenthen some are just a mess15:06
billycinahi there15:35
jjesse_hello15:35
billycinaanybody know about new dtd requirements from  Gutsy15:35
billycinaie as of gutsy?15:35
billycinanew version of docbook it seems15:35
jjesse_so the dtd that all the docs are getting is wrong/15:36
billycinayes15:36
jjesse_intersteing was not awaare of that15:36
billycinait's a real pain15:37
jjesse_so all the docs don't lookright?15:37
billycinaerrors all over the shop15:37
jjesse_grumble grumble15:37
billycinathey can't 'make'15:37
jjesse_are they built correctly on a gutsy install?15:37
* jjesse_ is at work and not on a gutsy box right now15:37
billycinathey were built on feisty15:37
billycinaand now we are reviewing on gutsy15:37
billycinaand the doc are just not happy15:38
jjesse_that sucks15:38
billycina i know15:38
billycinaany solution you can think of?15:38
jjesse_not off the top of my head15:39
billycinaany idea where i can look?15:39
jjesse_umm give me a bit to think15:40
billycinak - thanks15:40
jjesse_just to make sure i understand if i run the validate.sh script in the docteam svn it will give a ton of errors?15:41
billycinasounds about right - yes15:46
billycinayou guys must use a different way of checking15:46
billycinai'm using bluefish15:46
jjesse_whenever i need to validate my docbook files i run the script that is in trunk15:47
jjesse_validate.sh15:47
billycinai think we are doing the same but in different means15:47
popey:(15:49
billycinapopey: this is very annoying15:49
TeTeTjjesse_: I'll take a look at it20:57
=== jjesse_ is now known as jjesse
TeTeTjjesse: after commenting out some, but not all <figure>s it compiles again22:25
mdkewhat's the error from validate.sh? The dtd in our documents hasn't changed, so upgrading to gutsy shouldn't change anything22:31
mdkeI haven't seen any errors with making or validating22:32
mdkeTeTeT: still around?22:35
TeTeTmdke: yes, I'm there, sorry22:35
mdkenothing to be sorry for :)22:35
TeTeTmdke: the validate.sh points to a number of issues22:35
mdkeall documents?22:36
TeTeTmdke: one with use of para inside of screen, the other on figure22:36
TeTeTmdke: yep, maybe dblatex became more rigorous in 7.1022:36
TeTeTe.g. on feisty it builds, on gutsy it stops22:36
mdkeTeTeT: can you give me an example of a document which gives the error with validate.sh?22:37
mdkei can't see any22:37
TeTeTmdke: I'm writing about the training course - basically none of the training documents validates ...22:37
mdkeoh. The discussion above with jjesse seems to have been on the understanding that you were talking about our documents...22:38
mdkeI suppose it's possible that your training documents use a different dtd declaration to ours...22:39
TeTeTmdke: nope, I was referring to the one with billycina22:39
TeTeTmdke: I hope not :)22:39
mdke15:41:52 < jjesse_> just to make sure i understand if i run the validate.sh script in the docteam svn it will give a ton of errors?22:39
mdke15:46:15 < billycina> sounds about right - yes22:39
mdkeperhaps I misunderstood. So the dtd declaration is identical?22:39
mdke(to our documents)22:40
TeTeTmdke: seems we're using version 4.2 instead of 4.1.222:40
mdkeright22:40
mdkeeven so, shouldn't be radically different22:41
TeTeTyep22:41
mdkehow were the documents created originally?22:42
mdkecan I have a look at one?22:42
TeTeTmdke: sure, it's all on launchpad22:42
TeTeThttps://code.edge.launchpad.net/~canonical-training/ubuntu-desktop-course/ubuntu-desktop-course-beta22:42
TeTeTmdke: we've advised our training partner to use the doc teams docbook tags and stay with this22:43
TeTeTmdke: unfortunately it's a rough ride for everybody involved22:43
mdkeI wonder if the documents were created using a program or something which has made a mistake22:43
TeTeTe.g. in concern to content as well as xml22:43
TeTeTI'm pretty sure they have a human editing them, working from a template22:43
TeTeTI'm also pretty sure that the human editor is unaware of 'validation' or xmllint or anythinbg22:44
mdkeI see.22:45
mdkewe seem to use 4.3 in our documents22:45
mdkehttps://docteam.ubuntu.com/repos/trunk/ubuntu/internet/C/internet.xml22:45
TeTeTok22:46
TeTeTgrep -rh DOCTYPE * | sort | uniq22:47
mdkei wonder if there is a bug in the gutsy declaration of 4.2. Try 4.322:47
TeTeTok, most are 4.322:47
TeTeTmdke: no change22:48
mdkeperhaps the documents are just invalid22:49
mdkemaybe they built on feisty notwithstanding the errors?22:49
TeTeTmdke: seems so22:49
mdkeyou're not using xsltproc?22:49
TeTeTmdke: I tend to agree, the docs were bad from the start and now gutsy has something more strict22:50
TeTeTmdke: we use xsltproc for the html and dblatex for PDF22:50
TeTeThttp://codebrowse.launchpad.net/~canonical-training/ubuntu-desktop-course/ubuntu-desktop-course-beta/annotate/training%40canonical.com-20071022180423-h3gwq5lotyxdvwgz?file_id=makefile-20070927154211-pp53f1hz3isw2jtg-122:50
TeTeTmdke: I'll probably take a look at the generated tex and see if I find the prob22:51
mdkeyes, was just looking at that, sorry22:51
mdkexsltproc works?22:51
TeTeTanyway, need to call it a day, otherwise I'll have someone unhappy at home22:51
TeTeTmdke: yes, the HTML is there22:51
mdkeah, ok. blame dblatex definitely then22:51
mdkegood night22:52
TeTeTmdke: will do :)22:52
TeTeTbye, and thanks!22:52

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