[00:11] <emmajane> question about bzr... how do I know what the name of the package is that I want to download to fix up?
[00:12] <Kamping_Kaiser> emmajane, pardon?
[00:12] <emmajane> I found an error in the documentation that I'd like to fix.
[00:12] <emmajane> I will need the XML files so that I can edit them and submit a patch.
[00:13] <Kamping_Kaiser> have a look at https://wiki.ubuntu.com/DocumentationTeam, it should link to instructions
[00:14] <emmajane> I've read that. it gives a sample, but I don't understand how to find the specific document that I want to fix.
[00:14] <emmajane> it gives a kde example...
[00:14] <emmajane> I have a different page I want to fix.
[00:14] <Kamping_Kaiser> so have you done a bzr checkout?
[00:14] <emmajane> previously for different documents, yes.
[00:14] <emmajane> but I was told which package to download.
[00:15] <emmajane> This time I just have a URL that I want to fix, but I don't know how to download the related XML files.
[00:15] <Kamping_Kaiser> if you want to provide a patch to the documentation you'll need to do it on the bzr source, the shipped documentatino wont change, other then translations afaik
[00:15] <emmajane> yes....
[00:16] <dsas> emmajane: you probably want one of the -hardy bzr branches on https://code.edge.launchpad.net/ubuntu-doc/+branches
[00:16] <dsas> which one depends on what variant the bug is on edubuntu/kubuntu/ubuntu/xubuntu
[00:17] <emmajane> do I have to download the whole thing though? when I got the accessibility pages there was a sub-set that I downloaded.
[00:17] <emmajane> https://help.ubuntu.com/7.10/internet/C/troubleshooting.html
[00:17] <emmajane> that's the page I want to fix.
[00:17] <emmajane> I don't know how to translate that page into the right location for the source files though.
[00:19] <emmajane> https://help.ubuntu.com/community/EasyBazaar is the instructions I used last time to checkout the source. the kubuntu stuff was replaced with a different [branch?] name.
[00:19] <Kamping_Kaiser> kgoetz@wesnoth:~/public_html/ubuntu-doc$ find ./ -name troubleshooting*
[00:19] <Kamping_Kaiser> ./ubuntu-hardy/ubuntu/internet/C/troubleshooting.
[00:19] <Kamping_Kaiser> ./ubuntu-hardy/ubuntu/internet/C/troubleshooting.xml
[00:19] <Kamping_Kaiser> even.
[00:20] <Kamping_Kaiser> afk 15 min.
[00:20] <emmajane> um.
[00:20] <emmajane> The last time I downloaded documentation I only grabbed a sub-set.
[00:20] <emmajane> (see above)
[00:21] <emmajane> so this command doesn't help me, I don't think.
[00:21] <emmajane> surely we documentation people can give one another better instructions than this? :)
[00:21] <Kamping_Kaiser> if you havent checked out the ubuntu internet section, you will need to if you want to edit that xml file
[00:22] <emmajane> YES
[00:22] <Kamping_Kaiser> *or* download it directly (if you can, i'm not sure though)
[00:22] <emmajane> how do I do that?
[00:22] <emmajane> The instructions say, "Locate the branch that you would like to work on. " I don't understand how to do this part of the instructions.
[00:23] <Kamping_Kaiser> https://wiki.ubuntu.com/DocumentationTeam/Repository
[00:23] <Kamping_Kaiser> really afk for 15 min
[00:23] <dsas> emmajane: you locate via the link I gave above. (Though yes, that page could be slightly clearer)
[00:23] <dsas> as for just checking out one or two file, I didn't know that was possible.
[00:24] <emmajane> the EasyBazaar gives the instructions for it and recommends it against checking out the whole tree because that takes a long time (IIRC that was the logic)
[00:25]  * emmajane looks at the link again. I click on "ubuntu-hardy   Current development focus"
[00:25] <emmajane> and get a list of revisions...
[00:25] <emmajane> with a URL at the top...
[00:25] <emmajane> hm.
[00:26] <emmajane> last time I downloaded just: https://code.launchpad.net/~ubuntu-core-doc/gnome-user-docs/ubuntu-hardy
[00:27] <dsas> ah, those are the gnome docs + ubuntu alterations. you want the ubuntu-hardy branch listed on that page.
[00:28] <dsas> oh sorry, you've got that far already
[00:28] <emmajane> :)
[00:29] <emmajane> ok, I think I've found the files... from the URL you first gave me you have to click on "browse code"
[00:29] <dsas> the quickest way as far as I remember is to do a lightweight checkout using http://bazaar.launchpad.net/~ubuntu-core-doc/ubuntu-doc/ubuntu-hardy url
[00:29] <emmajane> and then you can wander around and find the exact file...
[00:29] <emmajane> where URL is local dir?
[00:30] <dsas> the command is bzr checkout --lightweight http://bazaar.launchpad.net/~ubuntu-core-doc/ubuntu-doc/ubuntu-hardy localdir
[00:30]  * emmajane nods
[00:31] <dsas> you can browse the code online via the link on the left
[00:32] <emmajane> downloading now, thanks!!
[00:33] <emmajane> next question: https://help.ubuntu.com/7.10/internet/C/troubleshooting.html open "Device Manager" ... in my 7.10 it's System -> Preferences -> Hardware Information
[00:34] <emmajane> there's no such thing as "Device Manager" in the System menu. is that true for you as well?
[00:34] <dsas> that bug has been reported and fixed in bzr I believe.
[00:34] <emmajane> hm. I searched for it, but maybe I'm not searching correctly either...
[00:36] <emmajane> https://bugs.launchpad.net/bugs/+bugs?field.searchtext=device+manager+documentation&search=Search+Bug+Reports&field.scope=all&field.scope.target=
[00:40] <dsas> bug 141941 perhaps
[00:40] <ubotu> Launchpad bug 141941 in zope2 "KeywordIndex and FieldIndex subclassing" [Medium,Fix released] https://launchpad.net/bugs/141941
[00:40] <dsas> bug 141491 even
[00:40] <ubotu> Launchpad bug 141491 in ubuntu-docs "ubuntu-docs internet string 24 - Device manager is under Preferences not Administration" [Low,Fix committed] https://launchpad.net/bugs/141491
[00:40] <emmajane> cool that it's fixed. what was wrong with my search that it didn't find the bug?
[00:41] <dsas> the bug report doesn't include the string "device manager documentation"
[00:42] <dsas> (I found the bug by checking the changelog)
[00:42] <emmajane> it's not smart enough to just do BOOLEAN "OR" searching?
[00:44]  * dsas shrugs
[00:45] <emmajane> ok. So let's pretend it wasn't fixed and I still wanted to find the file...
[00:45] <emmajane> I went to: /ubuntu/internet/C/troubleshooting.xml
[00:45] <emmajane> sorry full URL: http://codebrowse.launchpad.net/~ubuntu-core-doc/ubuntu-doc/ubuntu-hardy/annotate/asommer70%40gmail.com-20080108215830-oiy3me2cd15s9byf?file_id=4337%401e033ed4-87e8-0310-8703-d68c7bbd86c9%3Atrunk%3Aubuntu%252Finternet%252FC%252Ftroubleshooting.xml
[00:45] <emmajane> gah
[00:45] <dsas> right
[00:45] <emmajane> I followed the links in the "browse code" and found that file.
[00:46] <emmajane> but that file doens't match: https://help.ubuntu.com/7.10/internet/C/troubleshooting.html
[00:46] <emmajane> so now I'm back to my original question: how would I find the source file for that Internet page?
[00:46] <jjesse_> the source would be in the bzr branch
[00:47] <emmajane> "browse code" is the source files though...
[00:47] <jjesse_> hold on getting caught up w/ scroll
[00:47] <dsas> emmajane: right, that file on lp is the development version, the help.ubuntu.com file is the released 7.10 version. it's been modified.
[00:47] <jjesse_> dsas is correct
[00:47] <emmajane> but it's *completely* different.
[00:48] <jjesse_> emmajane thats because people have been working on making changes to it
[00:48] <jjesse_> everything oon help.ubuntu.com is frozen in place for the life of the documentation
[00:48] <jjesse_> and on launchpad is the developmental version
[00:49] <emmajane> so when my friend (who's just installed Ubuntu for the first time) calls me in a panic because he's missing a "Device Manager" found on that Web page I gave you... I, um, have to tell him that the online docs for 7.10 will never match his system?
[00:50] <jjesse_> if you wanted to look at the source of what is in 7.10 it is found http://codebrowse.launchpad.net/~ubuntu-core-doc/gnome-user-docs/ubuntu-gutsy/files
[00:50] <jjesse_> emmajane: what probablly happened is there was a bug reported and it got fixed
[00:50] <jjesse_> but we don't do stable release updates for documents that i am aware of
[00:51] <emmajane> but I got an engineer to READ documentation!
[00:51] <emmajane> and it's going to always be wrong?
[00:51] <jjesse_> yay for engineers reading documentation
[00:51] <emmajane> totally yay!! :)
[00:51] <jjesse_> emmajane: it will be updated in the next release
[00:52] <jjesse_> as it is changed in the bzr branch
[00:52] <emmajane> 7.10 docs will too, or just the 8.04 docs?
[00:52] <jjesse_> emmajane: i think we don't do stable release updates for documents
[00:52] <jjesse_> would have to double check with mdke or something
[00:52] <emmajane> bad documentation is just wrong.
[00:52] <jjesse_> emmajane: i agree
[00:53] <emmajane> good :)
[00:53] <emmajane> can I register a complaint somewhere? :)
[00:53] <jjesse_> sure
[00:53] <emmajane> excellent... where? :)
[00:53] <jjesse_> mailing list
[00:53] <emmajane> kay
[00:54] <jjesse_> ask there if we do updates for documents  that have already been released
[00:54] <emmajane> yup
[16:03]  * marcx is away: Gone away for now.
[19:09]  * marcx_away is back.
[19:48] <cdm10> I'm wondering how the documentation team maintains the application documentation in Yelp... I'd like to contribute, but I'm not sure how to get started.
[19:49] <posingaspopular> cdm10: you can check out the getting started page
[19:49] <posingaspopular> http://www.mdke.org/?p=67
[19:49] <cdm10> ok
[19:49] <posingaspopular> oops i think it's the other one...
[19:49] <posingaspopular> https://wiki.ubuntu.com/DocumentationTeam