/srv/irclogs.ubuntu.com/2009/09/26/#ubuntu-doc.txt

=== zach is now known as Guest93969
=== zach_ is now known as Zachk18
=== zach_ is now known as Zachk18
Rocket2DMnmdke, if I post a patch for bug 377039 this weekend, will it make it in before string freeze?18:47
ubot4Launchpad bug 377039 in ubuntu-docs "Firewall documentation is outdated" [Medium,In progress] https://launchpad.net/bugs/37703918:47
Rocket2DMni have a patch ready to go, I'm just waiting for bodhi to review it before i post it18:48
missaugustinaIn tagging Docbook, is there a macros type thing for the Ubuntu download website?18:53
missaugustinaI saw &ubuntu-web; for the Ubuntu website, is there something specific for the download site?18:54
dhillon-v10Rocket2DMn: hi what's up18:54
mdkeRocket2DMn: yep, subject to review18:56
mdkemissaugustina: yes, we use entities, you should have a look in libs/global.ent for those18:56
mdkemissaugustina: or libs/gnome-menus.ent for the menu entries18:59
mdkemissaugustina: feel free to add an entry for usb-creator if not there already18:59
Rocket2DMnmdke, in the patch i put together, i included a couple links to community docs pages (like Gufw and UFW) since they have good documentation on using those tools, is that ok?19:01
mdkeRocket2DMn: sure19:01
Rocket2DMni didnt want to explain UFW in the patch since it is command line, and the Gufw page has screenshtos19:01
Rocket2DMnhi dhillon-v10 , not much up here, what about you19:02
dhillon-v10<Rocket2DMn> nothing really, waiting for Phil to show up, he was going to talk to me today :)19:02
missaugustinaGreat, I just have to add the entities and it will be tagged! I have been testing it in yelp to make sure my XML is correct. So far so good.19:08
missaugustinaI do have a question about uploading the branch. I created a usb-creator branch under my username19:08
Rocket2DMnDo the sysadmins ever get to RT tickets?19:08
missaugustinaI have been pushing just the single files to that branch without including the full ubuntu-docs stuff19:08
missaugustinaI have another branch set up on my system labeled ubuntu-docs.usb-creator19:09
missaugustinaCan I push that to my usb-creator branch?19:09
missaugustinaI am still a little confused by bzr but I've used other version control systems before.19:10
missaugustinaAlso another question, should I be setting usb-creator up as a standalone article with an article info tag like about-ubuntu, or should I use a chapter tag?19:14
dhillon-v10philbull: what's up19:15
philbullhey dhillon-v1019:15
dhillon-v10finally got in touch with you19:16
dhillon-v10so should we get started the personas19:17
philbullsure19:18
philbullsorry I'm late, traffic19:18
dhillon-v10so I need to work on targetting my audience better19:19
philbullI think so, yes19:19
philbullyou need to understand why people might be looking in the help19:19
philbullthis was for gnome-display-manager, wasn't it?19:19
dhillon-v10yes, I tried to include dual monitoring but its about 5 pages long so it can't be condensed in 3 paras. I need help with that19:20
philbullwhat version of Ubuntu do you have installed?19:21
dhillon-v109.0419:22
philbullOK, I have some example docs which will only work with the version of Yelp installed with 9.10 (latest development)19:22
dhillon-v10I have 9.10 in a virtual machine19:23
philbullyay!19:23
dhillon-v10i can fire that up if its necessary19:23
philbullany chance you could download the tarball from here?19:23
philbullhttp://mail.gnome.org/archives/gnome-doc-list/2009-September/msg00053.html19:23
philbull(into the 9.10 VM)19:24
dhillon-v10alright, just a sec. thanks19:24
philbullalso, did I send you a copy of some example personas?19:24
mdkemissaugustina: yes, as an article. on the bzr question, the best thing would be to add it to an ubuntu-docs branch and push the whole thing up19:25
dhillon-v10<philbull> yes indeed I am looking at them19:26
mdkemissaugustina: (to a new branch)19:26
mdkehey philbull19:28
philbullhey mdke19:28
philbulljust going through some persona dev with dhillon-v1019:28
dhillon-v10<mdke> hey what's up19:28
mdkehi dhillon-v1019:28
philbulldhillon-v10: ok, did you take a look through the personas?19:28
dhillon-v10yes, I did but i am a little confused19:29
philbullOK, what are you confused about?19:29
dhillon-v10dual monitoring is popping up a lot but I can't possibly explain it in a few paragraphs19:30
philbullthat's normal19:30
philbullwhat you're seeing is that dual-monitoring is a "theme" rather than one topic19:30
philbulllots of people are having lots of dual-monitoring problems19:30
dhillon-v10so, how should I got about including that in19:31
philbullwell, let's start off with the most common questions19:31
dhillon-v10alright19:31
philbulldid you collect a list of common dual-monitor (DM) questions?19:31
dhillon-v10most people actually don't know how to set it up, that's why i addressed it in general19:32
philbulldo you have an example of a user asking that question?19:32
dhillon-v10the question were regarding monitors not being detected19:32
dhillon-v10just a sec.19:32
philbullit's important to see how users are phrasing the question19:33
dhillon-v10here's one: hmmm, i had a similar problem, but i have an nvidia card and bypassed the ubuntu control panel and used the nvidia control panel directly to force it to work with my dual monitors (which were displaying at an improper resolution like yours). but since you're running ATI, i'm not sure how to help you. i suspect you'd have to go in and fiddle with the xorg config files manually19:33
philbullthat's not really phrased as a question, more as advice19:34
philbulldo you have a simpler example, phrased more like a question?19:34
philbulle.g. "i can't get both of my monitors to work"19:34
dhillon-v10does anybody have display problems with intel graphics and dual monitors? i can't access the top panel on my left screen, and the wallpaper on my right screen is not displayed properly19:35
philbullok, and another one or two?19:35
dhillon-v10just a sec. something unexpected poped up, sorry19:37
dhillon-v10phil, I am really sorry but I have to go, can we talk about this sometime later or you can send me some general instructions in mail19:39
philbullno problem, how is some time in the week for you?19:40
philbullI'll try to come up with something a bit more organised next time19:40
philbull(just drop me an email)19:40
dhillon-v10<philbull> thank you very much and sorry for wasting your time, next saturday will be fine19:41
philbulldhillon-v10: no problem, not a waste of time at all!19:45
dhillon-v10thanks bye19:46
missaugustinaI'm pushing my branch of ubuntu-docs with the usb-creator docs added in, and the entity entry added for usb-creator20:22
missaugustinaThe branch is lp:~missaugustina/ubuntu-docs/usb-creator20:22
Rocket2DMnI think bug 138288 can be closed - the pag ein question is linked from the front page of the community docs20:27
ubot4Launchpad bug 138288 in ubuntu-docs "Eye Candy page not easily accessible" [Wishlist,Confirmed] https://launchpad.net/bugs/13828820:27
Rocket2DMnmdke, what do you think?20:27
Rocket2DMnor do we want links to it from inside the system docs?20:27
mdkeRocket2DMn: I agree. The general point in the bug about the separation between h.u.c and h.u.c/c is something for a spec, I'd say20:34
mdkemissaugustina: great, thanks - I'll take a look shortly20:34
missaugustinaits still pushing20:34
Rocket2DMnok mdke , you want to close it or shall I?  Fix Released?20:34
mdkemissaugustina: cool20:35
missaugustinaI decided to do a push --overwrite to my branch and it's still working20:35
mdkeRocket2DMn: I'll do it, I think it's a "won't fix"20:35
Rocket2DMnok, thanks mdke20:36
missaugustinanm it hung so i ctl-c'ed out of it. now trying to break the lock on it.20:39
missaugustinaI did a merge from the ubuntu-doc branch to make sure my stuff was current and now bzr is hanging when trying to push20:40
missaugustinaI should just delete my branch and re-create it20:41
missaugustinaok did that now its updating20:47
mdkeRocket2DMn: can you run the validate script from our repo on the newtoubuntu file that gives you a problem?21:11
mdkeseems ok in our repo21:11
Rocket2DMnyou mean the bug i just filed against gnome-user-docs?21:11
mdkeyes (it's actually an ubuntu-docs file)21:12
Rocket2DMnah, oops, it was in the foo/bar/gnome path21:12
mdkethey all are :)21:12
Rocket2DMnwhat do you mean from the repo?21:12
mdkescripts/validate.sh21:13
mdkeor just the command "xmllint --noout --xinclude --noent --postvalid"21:13
mdke(followed by the path to the file)21:13
Rocket2DMni booted off the livecd on the laptop, do you want me to boot back into it? or just test in my local copy of the ubuntu-docs dev branch on my desktop here?21:14
mdkeif we are to debug the bug, you need to try the livecd again, sorry21:15
Rocket2DMnok ill reboot it now, np, that laptop is used for dev testing21:15
mdkethanks21:16
mdkeseems to work ok in my vbox with karmic21:17
missaugustinaI am not sure if my workflow in bzr is correct. I created a branch from the ubuntu-doc karmic branch. I added the usb-creator stuff and pushed that branch to the one I created under my username in Launchpad.21:19
missaugustinahttps://code.launchpad.net/~missaugustina/ubuntu-docs/usb-creator21:19
mdkemissaugustina: I don't think it is, I'm just trying to merge your branch and am having some trouble21:19
missaugustinaEverything is up there including the revision history for ubuntu-docs21:19
mdkemissaugustina: what seems to have happened is that you got the wrong ubuntu-doc karmic branch, unfortunately21:19
missaugustinaYarr21:19
missaugustinaWhich karmic branch do i need to get?21:20
mdkeyou got lp:ubuntu/ubuntu-docs rather than lp:ubuntu-docs21:20
mdkeit's not your fault at all21:20
missaugustinaohhh ok21:20
mdkeunfortunately, the former one was created by the people working on importing ubuntu source packages in bzr21:20
missaugustinanp i will try again. Is that the right workflow?21:20
mdkeso it's rather confusing, nothing you could be blamed for21:20
mdkeeverything we use is at code.launchpad.net/ubuntu-doc-project21:21
Rocket2DMnmdke, it seems that I'm not able to reproduce the problem on this boot into the livecd.  I was able to reproduce it during my last session21:21
mdkemissaugustina: yes, the workflow is exactly right21:21
mdkeRocket2DMn: weird21:21
missaugustinamdke: awesome. Should my branch be ~missaugustina/ubuntu-docs/usb-creator or ~missaugustina/ubuntu-doc-project/usb-creator21:22
Rocket2DMnmdke, problem with squashfs not setting up the filesystem correctly?21:24
mdkemissaugustina: the former21:24
mdkeRocket2DMn: possibly but I have no idea how that works21:24
Rocket2DMnme neither21:24
mdkemissaugustina: FWIW you can push directly to that location without setting it up in the web browser first21:24
mdkeRocket2DMn: I'd say close the bug unless you can reproduce it again, the file is ok in karmic21:25
Rocket2DMnk21:25
missaugustinamdke: I don't have to do the "Register a branch" dialogue to push my changes?21:30
mdkemissaugustina: nope, just "bzr push lp:~missaugustina/etc"21:30
mdkemissaugustina: but in this case, delete the existing branch first through the web interface21:31
missaugustinamdke: yeah I already deleted it. wow that's good to know!21:33
mdke:)21:33
Rocket2DMnmdke, any idea if bug 118741 was ever implemented?21:35
ubot4Launchpad bug 118741 in ubuntu-docs "External links in stable docs should be under Ubuntu control" [Wishlist,Confirmed] https://launchpad.net/bugs/11874121:35
Rocket2DMni dont see anything on the spec to think that it has21:35
mdkeno, don't think so21:35
mdkeI was never really convinced by it21:35
Rocket2DMnI can see the argument behind it, I'm also not sure if there is worth implementing though.  If a link is broken, it's broken.21:36
Rocket2DMnimplementing it could mean that you could block a site from showing though, say if it become a porn site like we saw earlier.21:37
mdkeyeah, but I'm not convinced that the end result justified the work involved21:38
Rocket2DMnwould be less useful on the h.u.c version of the syste mdocs though, people would complain about redirecting links and not being able to see where the link actually goes21:38
Rocket2DMnmdke, do you still want to keep the bug open?21:38
mdkehum21:39
mdkeguess not, I'll post there shortly21:40
Rocket2DMnmdke, I'm also looking at bug 139246.  Are we planning on updating anythin gin the system docs for that?  We can still try to update the community docs, I'm mostly curious about the sys doc side of it21:42
ubot4Launchpad bug 139246 in ubuntu-docs "Suspend help files are outdated" [Undecided,Confirmed] https://launchpad.net/bugs/13924621:42
missaugustinaOK got the right branch dl'ed and am now pushing to my branch lp:~missaugustina/ubuntu-docs/usb-creator21:42
missaugustinamdke: ok it's been pushed21:47
mdkemissaugustina: great, I'll check it out probably tomorrow21:58
mdkethanks21:58
mdkeRocket2DMn: I don't see how that can go in the system docs21:58
missaugustinamdke: awesome, feel free to offer any suggestions or make any changes to the XML. I just want to make sure what I'm submitting is consistent with what's there :D21:59
Rocket2DMnagreed mdke , do you want to keep the bug open for the wiki pages (which are tagged)?22:01
Rocket2DMnI dont really have any opinion about it, we do allow bug reports on community docs pages.  Is anything going to change now that we have the Tag system?22:02
mdkeRocket2DMn: up to you22:02
Rocket2DMnok, I guess we'll leave it open until we can centralize some decent documentation on suspend/resume22:04
Rocket2DMnat least something to tie in with the kernel team's pages on it22:04
mdkefair enough22:08
mdkeRocket2DMn: thanks for catching up on some of these aged bugs :)22:11
mdkemissaugustina: something for you to work on if you like as a "get used to docbook test"22:21
mdkemissaugustina: if you run "scripts/validate.sh usb-creator/C/usb-creator.xml" you will be shown some errors in the docbook22:21
mdkemissaugustina: understanding them is the tricky bit...22:22
mdkemissaugustina: each error tells you the line number in the xml which has a problem22:22
mdkemissaugustina: the good news is that most of the problems have the same cause - you need to nest a <para> tag inside a <listitem> tag22:23
missaugustinamdke: oh ok, forgot to validate. I opened them in Yelp to make sure they displayed correctly and thought that's all I needed to do.22:24
mdkesorry, computer crashed, now back22:29
mdkemissaugustina: yelp is a bit kinder, it displays invalid docbook too22:29
mdkemissaugustina: the good news is that most of the problems have the same cause - you need to nest a <para> tag inside a <listitem> tag22:29
mdkethe error message looks horrible but it's nice and simple in the end22:31
missaugustinayeah I'm trying to output the results to a file so I can read it22:33
missaugustinaadding --output FILE to the xmllint command isn't working nor is > FILE22:33
mdkeonce you've been through and added <para> tags to all the listitem tags, then there are only like 3 errors or so22:34
mdkenot sure why the pipe doesn't work I'm afraid22:34
missaugustina> output_file 2>&122:36
missaugustinathat works22:36
mdkeok, your command line skills are way better than mine :)22:37
missaugustinanah i just googled it ;)22:37
missaugustinaI hoped the sh script and saw it was calling xmllint so looked at the man page which showed an arg --output FILE but that was working for some reason22:38
missaugustina*opened, not hoped22:38
missaugustinawasn't working22:38
missaugustinaFixing those things now.22:46
mdkeawesome22:46
missaugustinafixed.22:55
missaugustinapushing changes now22:55
missaugustinare-ran xmllint and it validated22:55
missaugustinawell, didn't have any output so I assume that means it validated ;)22:56
mdkeyes22:56
mdkegood job :)22:56
XDevHaldHey everyone, I was guided here from the wiki page so I can re-join the documentation page. Are there any openings?22:56
mdkeXDevHald: we have infinite openings!!22:57
mdkeall contributions are welcomed22:57
XDevHaldExcellent. I have been in the group before about 3 years ago, so this should be fun.22:57
XDevHaldWhat's the initial project?22:57
mdkehave you changed your nick?22:58
mdkemaybe I'd remember you22:58
XDevHaldI sure have, first name and last is Steven Myers22:58
* mdke searches his memory banks22:59
mdkeXDevHald: ok so our team documentation is all at https://wiki.ubuntu.com/DocumentationTeam - hopefully there is enough material to get you started and find a task you are interested on23:06
XDevHaldFound my dirt mound. Thanks Matt :-)23:09
mdkeno worries23:10
mdkemissaugustina: looking very good23:18
j1mchi mdke23:19
mdkej1mc: hi!23:19
j1mc:)23:20
j1mci'm committing some Xubuntu doc stuff today.23:20
j1mcnot a lot of changes this go-round, but . . . at least some updates23:20
j1mci'll be reviewing the Ubuntu docs for applicable changes, too.23:20
mdkemissaugustina: I'm going to make a few small tweaks if that is ok, but nothing much. One point to raise with you is that you refer to the app as "USB Creator" throughout. Shouldn't it be called "USB Startup Disk Creator" as with the menu entry?23:20
mdkej1mc: great stuff23:21
missaugustinamdke: you are right, the package is called usb-creator which is why I called it that.23:23
mdkemissaugustina: you can mark your branch as "merged" now btw, awesome :)23:23
missaugustinamdke: OK thx :D23:23
mdkehttp://bazaar.launchpad.net/~ubuntu-core-doc/ubuntu-docs/ubuntu-karmic/revision/351 :)23:24
missaugustinayay! Yeah it's already labeled as merged. Sweet!23:24
missaugustinaNow to finish up my Install Guide Docs and then finish editing the Packaging Guide23:25
mdkeis the install guide going ahead?23:26
mdkeI haven't heard anything about it on the mailing list23:27
missaugustinaMe either. I figure I might as well finish my docs. I think the last thing I heard was that it should at least be on the wiki23:27
missaugustinaThe docs I have to finish are basically mish mash of stuff that's already been written in other places. I can get them done in an afternoon, so might as well.23:28
missaugustinaDo you know what team manages the Packaging Guide? is that us? Nathan Handler is the one who I was originally working with with regards to editing.23:29
mdkemissaugustina: dholbach is the guy to talk to, he runs the wiki version of the PG as far as I know23:31
mdkebut Nathan too23:31
j1mcthat sounds right23:31
missaugustinaOK I will shoot him an email just to let him know I've been working on it.23:32
j1mc:)23:32
missaugustinaWith wiki stuff it can get a little crazy because you can have 3 or 4 people working on the same thing.23:32
mdkeyeah23:33
mdkethe PG has an insane structure of includes and stuff which makes it rather odd23:33
mdkebut there is a "Complete" version23:33
missaugustinaYep23:33
missaugustinaYeah I was working with the complete text and need to propose restructuring the sections23:34
missaugustinaTypos in the commands, references to tools that are obsolete23:34
missaugustinaalso incomplete instructions23:34
mdkewow, great project23:34
missaugustinaI completely rewrote the Basic section and simplified it23:34
mdkedefinitely something to take up with Daniel and the motu team generally23:34
missaugustinaYeah good point. I was working with Nathan on it and wasn't sure if there was anyone else I should be talking to.23:35
mdkemissaugustina: you can see the changes I've quickly made to the usb-creator doc at revision 352 of the ubuntu-docs branch23:35
mdkeI've changed a couple of the admonitions, which might be a bit subjective, but I hope that's ok23:37
missaugustinamdke: Looks good to me!23:38
missaugustinamdke: I just guessed at the "notes"23:39
mdke:)23:39
mdkecool23:39
missaugustinamdke: seriously, I have no ego with my work. I care more about consistency with the other  docs and overall usability than anything else.23:39
mdkeyou rock23:40
mdkeok, so that will be in the next upload of ubuntu-docs and you'll see it in karmic23:40
mdkethanks again23:40
missaugustinaYay! :D23:40
missaugustinaNp, I am just working on going down my list to help out in anyway I can.23:40
missaugustinaI am working on my tech writing cert so anything I can do to help out helps me too :)23:41
mdkecool23:41
missaugustinaAlso I am unemployed right now so this is like my full time job ;) haha23:42
mdkeI remember the days...23:43
mdkeok, time for bed, see yall soon23:44
missaugustinaGnite! Thx for your help!23:45
mdkeyou too23:45

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