[19:19] Howdy! I need some help with bzr [19:19] I created a branch in lp and I'm trying to create the branch on my system. [19:19] When I run the bzr branch command it keeps saying "Error not a branch" [19:20] This is my branch: https://code.launchpad.net/~missaugustina/ubuntu-docs/usb-creator [19:21] I need to create a local branch so I can push my changes to it [19:23] bzr: ERROR: Not a branch: "bzr+ssh://bazaar.launchpad.net/~missaugustina/ubuntu-docs/usb-creator/". [19:24] bzr: ERROR: Not a branch: "https://code.launchpad.net/~missaugustina/ubuntu-docs/". [19:26] ok nm i have to create it as a new branch, i was following the wrong instructions [20:44] Alright! got it working! https://code.launchpad.net/~missaugustina/ubuntu-docs/usb-creator [20:44] I'll have the docbook tagged stuff up there soon. [22:13] missaugustina: nice, I'll take a look when it is ready [22:13] probably this weekend so we can get it into the ubuntu-docs branch [22:15] missaugustina: probably the simplest way for you to do it would be to create a branch from the ubuntu-docs karmic branch, add your document using the same structure/format as similar documents (about-ubuntu is probably a good example) and then push that branch so that it can be easily merged [22:16] that will also allow you to check it using our validate tool (scripts/validate.sh in the branch) [22:16] OK I will definitely need help to make sure I'm doing it right. [22:17] I created my own usb-creator branch just to have a place to put the tagged doc. [22:17] missaugustina: no problem, I'm happy to help, and I'm sure others will be too [22:17] Right now just the text is up there, untagged, in OpenOffice format [22:17] yep [22:17] do you also have a local copy of the ubuntu-docs karmic branch? [22:17] yeah I am re-dowloading that now [22:17] awesome [22:18] I had to reinstall my system and getting bazaar re-set up took all morning haha [22:18] ouch [22:18] There are so many great quickstart guides for bazaar out there but nothing specific for ubuntu-docs, unless I just don't know where it is [22:19] The version of bazaar I had from the repositories was incompatible so I had to re-set up from the Bazaar PPA [22:19] I'm writing something up for myself as a reminder in case I ever have to do this again and can post it to the wiki somewhere when I'm done [22:19] the bzr guide should be here - https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Repository [22:20] if there is something you think could be added, feel free to suggest - we can always improve the info [22:20] hmm, annoying that you couldn't use the ordinary bzr. I wonder if that is our fault [22:21] k I will definitely. 2 things offhand is a quick note on how to back up from an existing rsa key. I backed mine up when I reinstalled so I didn't have to set that stuff up again. [22:21] Second thing is setting up the Bzr PPA [22:21] Since the versions were incompatible, or i was getting errors when trying to get the ubuntu docs branch [22:22] the second thing is more worrying, for me. we're doing something wrong if the branch isn't compatible [22:22] on the first thing, it's maybe a marginal user case, or something which we could link to another document for [22:22] I will post the errors I got, I'm on Jaunty and was running Bzr .98 [22:22] or whatever is in the repositories [22:23] KeyError: 'Bazaar repository format 2a (needs bzr 1.16 or later)\n' [22:23] hmm === lukjad007 is now known as ShadowChild [22:23] Looks like it was Bazaar 1.13 [22:23] we should definitely fix that [22:23] thanks for pointing it out [22:24] NP I just thought we were supposed to be using the Bazaar PPA, not the official repositories and thought wow why isn't that documented anywhere?? [22:25] one way or the other we should fix it :) [22:25] That wiki you linked is perfect, I think it's what I used the first time I set everything up. [22:28] Yay finally got it all downloaded. OK so you were saying I should make my branch look like "about-ubuntu" [22:28] I think that you should make changes directly to the branch you just downloaded === ShadowChild is now known as lukjad007 [22:28] so you would add a directory "usb-creator" [22:29] and then you put your document in usb-creator/C/usb-creator.xml [22:29] Oh right and the tools create the other docs [22:29] how do you mean? [22:30] In about-ubuntu there's a "po" folder [22:30] oh yeah, don't worry about that [22:30] with a *.pot document [22:30] I'll deal with it [22:30] What are those? [22:30] those are for translations [22:30] Ah ok [22:31] And the *.omf file in the C directory ? [22:31] that's used by yelp to show documents - you can create that too if you fancy giving it a go, otherwise I'm happy to do that [22:31] I'll give it a shot [22:32] about-ubuntu.xml is a good document to use as an example for yours because it is an

and will show you the header format that we use for our documents [22:32] Where is the Doc Book tagging guide for Ubuntu docs? [22:32] Yeah that's what I was going to draw from [22:32] there is a sort of basic intro here: https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Editing [22:32] and here for checking: https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Checking [22:33] I know HTML and I used Docbook like 10 yrs ago so it's just figuring out what tags you guys use [22:33] Excellent! Thanks [22:33] details of the tags are here: https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/DocbookConventions [22:33] that's not entirely complete, unfortunately, but if you read it, you're in good shape :) [22:34] thanks very much for your work on this [22:35] hey no problem! thx for letting me contribute! [22:35] we love contributions :) [22:36] ok, i'm off to bed, catch you again soon [22:36] Thx for your help! Gnite!