| emmajane | question about bzr... how do I know what the name of the package is that I want to download to fix up? | 00:11 |
|---|---|---|
| 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:12 |
| Kamping_Kaiser | have a look at https://wiki.ubuntu.com/DocumentationTeam, it should link to instructions | 00:13 |
| 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:14 |
| 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:15 |
| 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:16 |
| 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:17 |
| 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:19 |
| 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:20 |
| 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:21 |
| 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:22 |
| 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:23 |
| 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:24 |
| * 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:25 |
| emmajane | last time I downloaded just: https://code.launchpad.net/~ubuntu-core-doc/gnome-user-docs/ubuntu-hardy | 00:26 |
| dsas | ah, those are the gnome docs + ubuntu alterations. you want the ubuntu-hardy branch listed on that page. | 00:27 |
| dsas | oh sorry, you've got that far already | 00:28 |
| emmajane | :) | 00:28 |
| 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:29 |
| dsas | the command is bzr checkout --lightweight http://bazaar.launchpad.net/~ubuntu-core-doc/ubuntu-doc/ubuntu-hardy localdir | 00:30 |
| * emmajane nods | 00:30 | |
| dsas | you can browse the code online via the link on the left | 00:31 |
| emmajane | downloading now, thanks!! | 00:32 |
| 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:33 |
| 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:34 |
| emmajane | https://bugs.launchpad.net/bugs/+bugs?field.searchtext=device+manager+documentation&search=Search+Bug+Reports&field.scope=all&field.scope.target= | 00:36 |
| 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:40 |
| dsas | the bug report doesn't include the string "device manager documentation" | 00:41 |
| dsas | (I found the bug by checking the changelog) | 00:42 |
| emmajane | it's not smart enough to just do BOOLEAN "OR" searching? | 00:42 |
| === nivek_ is now known as nivek | ||
| * dsas shrugs | 00:44 | |
| 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:45 |
| 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:46 |
| 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:47 |
| 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:48 |
| 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:49 |
| 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:50 |
| 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:51 |
| 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:52 |
| 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:53 |
| jjesse_ | ask there if we do updates for documents that have already been released | 00:54 |
| emmajane | yup | 00:54 |
| === Admiral_laptop is now known as Admiral_Chicago | ||
| === chaos is now known as eddieftw | ||
| === eddieftw is now known as posingaspopular | ||
| === FlannelKing is now known as Flannel | ||
| * marcx is away: Gone away for now. | 16:03 | |
| === marcx is now known as marcx_away | ||
| * marcx_away is back. | 19:09 | |
| === marcx_away is now known as marcx | ||
| 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:48 |
| 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 | 19:49 |
| === posingaspopular is now known as tychesucks | ||
| === tychesucks is now known as posingaspopular | ||
Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!