=== zach is now known as Guest93969 === zach_ is now known as Zachk18 === zach_ is now known as Zachk18 [18:47] mdke, if I post a patch for bug 377039 this weekend, will it make it in before string freeze? [18:47] Launchpad bug 377039 in ubuntu-docs "Firewall documentation is outdated" [Medium,In progress] https://launchpad.net/bugs/377039 [18:48] i have a patch ready to go, I'm just waiting for bodhi to review it before i post it [18:53] In tagging Docbook, is there a macros type thing for the Ubuntu download website? [18:54] I saw &ubuntu-web; for the Ubuntu website, is there something specific for the download site? [18:54] Rocket2DMn: hi what's up [18:56] Rocket2DMn: yep, subject to review [18:56] missaugustina: yes, we use entities, you should have a look in libs/global.ent for those [18:59] missaugustina: or libs/gnome-menus.ent for the menu entries [18:59] missaugustina: feel free to add an entry for usb-creator if not there already [19:01] mdke, 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] Rocket2DMn: sure [19:01] i didnt want to explain UFW in the patch since it is command line, and the Gufw page has screenshtos [19:02] hi dhillon-v10 , not much up here, what about you [19:02] nothing really, waiting for Phil to show up, he was going to talk to me today :) [19:08] Great, 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] I do have a question about uploading the branch. I created a usb-creator branch under my username [19:08] Do the sysadmins ever get to RT tickets? [19:08] I have been pushing just the single files to that branch without including the full ubuntu-docs stuff [19:09] I have another branch set up on my system labeled ubuntu-docs.usb-creator [19:09] Can I push that to my usb-creator branch? [19:10] I am still a little confused by bzr but I've used other version control systems before. [19:14] Also 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:15] philbull: what's up [19:15] hey dhillon-v10 [19:16] finally got in touch with you [19:17] so should we get started the personas [19:18] sure [19:18] sorry I'm late, traffic [19:19] so I need to work on targetting my audience better [19:19] I think so, yes [19:19] you need to understand why people might be looking in the help [19:19] this was for gnome-display-manager, wasn't it? [19:20] yes, 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 that [19:21] what version of Ubuntu do you have installed? [19:22] 9.04 [19:22] OK, I have some example docs which will only work with the version of Yelp installed with 9.10 (latest development) [19:23] I have 9.10 in a virtual machine [19:23] yay! [19:23] i can fire that up if its necessary [19:23] any chance you could download the tarball from here? [19:23] http://mail.gnome.org/archives/gnome-doc-list/2009-September/msg00053.html [19:24] (into the 9.10 VM) [19:24] alright, just a sec. thanks [19:24] also, did I send you a copy of some example personas? [19:25] missaugustina: 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 up [19:26] yes indeed I am looking at them [19:26] missaugustina: (to a new branch) [19:28] hey philbull [19:28] hey mdke [19:28] just going through some persona dev with dhillon-v10 [19:28] hey what's up [19:28] hi dhillon-v10 [19:28] dhillon-v10: ok, did you take a look through the personas? [19:29] yes, I did but i am a little confused [19:29] OK, what are you confused about? [19:30] dual monitoring is popping up a lot but I can't possibly explain it in a few paragraphs [19:30] that's normal [19:30] what you're seeing is that dual-monitoring is a "theme" rather than one topic [19:30] lots of people are having lots of dual-monitoring problems [19:31] so, how should I got about including that in [19:31] well, let's start off with the most common questions [19:31] alright [19:31] did you collect a list of common dual-monitor (DM) questions? [19:32] most people actually don't know how to set it up, that's why i addressed it in general [19:32] do you have an example of a user asking that question? [19:32] the question were regarding monitors not being detected [19:32] just a sec. [19:33] it's important to see how users are phrasing the question [19:33] here'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 manually [19:34] that's not really phrased as a question, more as advice [19:34] do you have a simpler example, phrased more like a question? [19:34] e.g. "i can't get both of my monitors to work" [19:35] does 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 properly [19:35] ok, and another one or two? [19:37] just a sec. something unexpected poped up, sorry [19:39] phil, 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 mail [19:40] no problem, how is some time in the week for you? [19:40] I'll try to come up with something a bit more organised next time [19:40] (just drop me an email) [19:41] thank you very much and sorry for wasting your time, next saturday will be fine [19:45] dhillon-v10: no problem, not a waste of time at all! [19:46] thanks bye [20:22] I'm pushing my branch of ubuntu-docs with the usb-creator docs added in, and the entity entry added for usb-creator [20:22] The branch is lp:~missaugustina/ubuntu-docs/usb-creator [20:27] I think bug 138288 can be closed - the pag ein question is linked from the front page of the community docs [20:27] Launchpad bug 138288 in ubuntu-docs "Eye Candy page not easily accessible" [Wishlist,Confirmed] https://launchpad.net/bugs/138288 [20:27] mdke, what do you think? [20:27] or do we want links to it from inside the system docs? [20:34] Rocket2DMn: 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 say [20:34] missaugustina: great, thanks - I'll take a look shortly [20:34] its still pushing [20:34] ok mdke , you want to close it or shall I? Fix Released? [20:35] missaugustina: cool [20:35] I decided to do a push --overwrite to my branch and it's still working [20:35] Rocket2DMn: I'll do it, I think it's a "won't fix" [20:36] ok, thanks mdke [20:39] nm it hung so i ctl-c'ed out of it. now trying to break the lock on it. [20:40] I did a merge from the ubuntu-doc branch to make sure my stuff was current and now bzr is hanging when trying to push [20:41] I should just delete my branch and re-create it [20:47] ok did that now its updating [21:11] Rocket2DMn: can you run the validate script from our repo on the newtoubuntu file that gives you a problem? [21:11] seems ok in our repo [21:11] you mean the bug i just filed against gnome-user-docs? [21:12] yes (it's actually an ubuntu-docs file) [21:12] ah, oops, it was in the foo/bar/gnome path [21:12] they all are :) [21:12] what do you mean from the repo? [21:13] scripts/validate.sh [21:13] or just the command "xmllint --noout --xinclude --noent --postvalid" [21:13] (followed by the path to the file) [21:14] i 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:15] if we are to debug the bug, you need to try the livecd again, sorry [21:15] ok ill reboot it now, np, that laptop is used for dev testing [21:16] thanks [21:17] seems to work ok in my vbox with karmic [21:19] I 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] https://code.launchpad.net/~missaugustina/ubuntu-docs/usb-creator [21:19] missaugustina: I don't think it is, I'm just trying to merge your branch and am having some trouble [21:19] Everything is up there including the revision history for ubuntu-docs [21:19] missaugustina: what seems to have happened is that you got the wrong ubuntu-doc karmic branch, unfortunately [21:19] Yarr [21:20] Which karmic branch do i need to get? [21:20] you got lp:ubuntu/ubuntu-docs rather than lp:ubuntu-docs [21:20] it's not your fault at all [21:20] ohhh ok [21:20] unfortunately, the former one was created by the people working on importing ubuntu source packages in bzr [21:20] np i will try again. Is that the right workflow? [21:20] so it's rather confusing, nothing you could be blamed for [21:21] everything we use is at code.launchpad.net/ubuntu-doc-project [21:21] mdke, 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 session [21:21] missaugustina: yes, the workflow is exactly right [21:21] Rocket2DMn: weird [21:22] mdke: awesome. Should my branch be ~missaugustina/ubuntu-docs/usb-creator or ~missaugustina/ubuntu-doc-project/usb-creator [21:24] mdke, problem with squashfs not setting up the filesystem correctly? [21:24] missaugustina: the former [21:24] Rocket2DMn: possibly but I have no idea how that works [21:24] me neither [21:24] missaugustina: FWIW you can push directly to that location without setting it up in the web browser first [21:25] Rocket2DMn: I'd say close the bug unless you can reproduce it again, the file is ok in karmic [21:25] k [21:30] mdke: I don't have to do the "Register a branch" dialogue to push my changes? [21:30] missaugustina: nope, just "bzr push lp:~missaugustina/etc" [21:31] missaugustina: but in this case, delete the existing branch first through the web interface [21:33] mdke: yeah I already deleted it. wow that's good to know! [21:33] :) [21:35] mdke, any idea if bug 118741 was ever implemented? [21:35] Launchpad bug 118741 in ubuntu-docs "External links in stable docs should be under Ubuntu control" [Wishlist,Confirmed] https://launchpad.net/bugs/118741 [21:35] i dont see anything on the spec to think that it has [21:35] no, don't think so [21:35] I was never really convinced by it [21:36] I 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:37] implementing it could mean that you could block a site from showing though, say if it become a porn site like we saw earlier. [21:38] yeah, but I'm not convinced that the end result justified the work involved [21:38] would 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 goes [21:38] mdke, do you still want to keep the bug open? [21:39] hum [21:40] guess not, I'll post there shortly [21:42] mdke, 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 it [21:42] Launchpad bug 139246 in ubuntu-docs "Suspend help files are outdated" [Undecided,Confirmed] https://launchpad.net/bugs/139246 [21:42] OK got the right branch dl'ed and am now pushing to my branch lp:~missaugustina/ubuntu-docs/usb-creator [21:47] mdke: ok it's been pushed [21:58] missaugustina: great, I'll check it out probably tomorrow [21:58] thanks [21:58] Rocket2DMn: I don't see how that can go in the system docs [21:59] mdke: 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 :D [22:01] agreed mdke , do you want to keep the bug open for the wiki pages (which are tagged)? [22:02] I 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] Rocket2DMn: up to you [22:04] ok, I guess we'll leave it open until we can centralize some decent documentation on suspend/resume [22:04] at least something to tie in with the kernel team's pages on it [22:08] fair enough [22:11] Rocket2DMn: thanks for catching up on some of these aged bugs :) [22:21] missaugustina: something for you to work on if you like as a "get used to docbook test" [22:21] missaugustina: if you run "scripts/validate.sh usb-creator/C/usb-creator.xml" you will be shown some errors in the docbook [22:22] missaugustina: understanding them is the tricky bit... [22:22] missaugustina: each error tells you the line number in the xml which has a problem [22:23] missaugustina: the good news is that most of the problems have the same cause - you need to nest a tag inside a tag [22:24] mdke: 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:29] sorry, computer crashed, now back [22:29] missaugustina: yelp is a bit kinder, it displays invalid docbook too [22:29] missaugustina: the good news is that most of the problems have the same cause - you need to nest a tag inside a tag [22:31] the error message looks horrible but it's nice and simple in the end [22:33] yeah I'm trying to output the results to a file so I can read it [22:33] adding --output FILE to the xmllint command isn't working nor is > FILE [22:34] once you've been through and added tags to all the listitem tags, then there are only like 3 errors or so [22:34] not sure why the pipe doesn't work I'm afraid [22:36] > output_file 2>&1 [22:36] that works [22:37] ok, your command line skills are way better than mine :) [22:37] nah i just googled it ;) [22:38] I 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 reason [22:38] *opened, not hoped [22:38] wasn't working [22:46] Fixing those things now. [22:46] awesome [22:55] fixed. [22:55] pushing changes now [22:55] re-ran xmllint and it validated [22:56] well, didn't have any output so I assume that means it validated ;) [22:56] yes [22:56] good job :) [22:56] Hey everyone, I was guided here from the wiki page so I can re-join the documentation page. Are there any openings? [22:57] XDevHald: we have infinite openings!! [22:57] all contributions are welcomed [22:57] Excellent. I have been in the group before about 3 years ago, so this should be fun. [22:57] What's the initial project? [22:58] have you changed your nick? [22:58] maybe I'd remember you [22:58] I sure have, first name and last is Steven Myers [22:59] * mdke searches his memory banks [23:06] XDevHald: 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 on [23:09] Found my dirt mound. Thanks Matt :-) [23:10] no worries [23:18] missaugustina: looking very good [23:19] hi mdke [23:19] j1mc: hi! [23:20] :) [23:20] i'm committing some Xubuntu doc stuff today. [23:20] not a lot of changes this go-round, but . . . at least some updates [23:20] i'll be reviewing the Ubuntu docs for applicable changes, too. [23:20] missaugustina: 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:21] j1mc: great stuff [23:23] mdke: you are right, the package is called usb-creator which is why I called it that. [23:23] missaugustina: you can mark your branch as "merged" now btw, awesome :) [23:23] mdke: OK thx :D [23:24] http://bazaar.launchpad.net/~ubuntu-core-doc/ubuntu-docs/ubuntu-karmic/revision/351 :) [23:24] yay! Yeah it's already labeled as merged. Sweet! [23:25] Now to finish up my Install Guide Docs and then finish editing the Packaging Guide [23:26] is the install guide going ahead? [23:27] I haven't heard anything about it on the mailing list [23:27] Me 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 wiki [23:28] The 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:29] Do 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:31] missaugustina: dholbach is the guy to talk to, he runs the wiki version of the PG as far as I know [23:31] but Nathan too [23:31] that sounds right [23:32] OK I will shoot him an email just to let him know I've been working on it. [23:32] :) [23:32] With wiki stuff it can get a little crazy because you can have 3 or 4 people working on the same thing. [23:33] yeah [23:33] the PG has an insane structure of includes and stuff which makes it rather odd [23:33] but there is a "Complete" version [23:33] Yep [23:34] Yeah I was working with the complete text and need to propose restructuring the sections [23:34] Typos in the commands, references to tools that are obsolete [23:34] also incomplete instructions [23:34] wow, great project [23:34] I completely rewrote the Basic section and simplified it [23:34] definitely something to take up with Daniel and the motu team generally [23:35] Yeah 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] missaugustina: you can see the changes I've quickly made to the usb-creator doc at revision 352 of the ubuntu-docs branch [23:37] I've changed a couple of the admonitions, which might be a bit subjective, but I hope that's ok [23:38] mdke: Looks good to me! [23:39] mdke: I just guessed at the "notes" [23:39] :) [23:39] cool [23:39] mdke: seriously, I have no ego with my work. I care more about consistency with the other docs and overall usability than anything else. [23:40] you rock [23:40] ok, so that will be in the next upload of ubuntu-docs and you'll see it in karmic [23:40] thanks again [23:40] Yay! :D [23:40] Np, I am just working on going down my list to help out in anyway I can. [23:41] I am working on my tech writing cert so anything I can do to help out helps me too :) [23:41] cool [23:42] Also I am unemployed right now so this is like my full time job ;) haha [23:43] I remember the days... [23:44] ok, time for bed, see yall soon [23:45] Gnite! Thx for your help! [23:45] you too