[19:19] <missaugustina> Howdy! I need some help with bzr
[19:19] <missaugustina> I created a branch in lp and I'm trying to create the branch on my system.
[19:19] <missaugustina> When I run the bzr branch command it keeps saying "Error not a branch"
[19:20] <missaugustina> This is my branch: https://code.launchpad.net/~missaugustina/ubuntu-docs/usb-creator
[19:21] <missaugustina> I need to create a local branch so I can push my changes to it
[19:23] <missaugustina> bzr: ERROR: Not a branch: "bzr+ssh://bazaar.launchpad.net/~missaugustina/ubuntu-docs/usb-creator/".
[19:24] <missaugustina> bzr: ERROR: Not a branch: "https://code.launchpad.net/~missaugustina/ubuntu-docs/".
[19:26] <missaugustina> ok nm i have to create it as a new branch, i was following the wrong instructions
[20:44] <missaugustina> Alright! got it working! https://code.launchpad.net/~missaugustina/ubuntu-docs/usb-creator
[20:44] <missaugustina> I'll have the docbook tagged stuff up there soon.
[22:13] <mdke> missaugustina: nice, I'll take a look when it is ready
[22:13] <mdke> probably this weekend so we can get it into the ubuntu-docs branch
[22:15] <mdke> 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] <mdke> that will also allow you to check it using our validate tool (scripts/validate.sh in the branch)
[22:16] <missaugustina> OK I will definitely need help to make sure I'm doing it right.
[22:17] <missaugustina> I created my own usb-creator branch just to have a place to put the tagged doc.
[22:17] <mdke> missaugustina: no problem, I'm happy to help, and I'm sure others will be too
[22:17] <missaugustina> Right now just the text is up there, untagged, in OpenOffice format
[22:17] <mdke> yep
[22:17] <mdke> do you also have a local copy of the ubuntu-docs karmic branch?
[22:17] <missaugustina> yeah I am re-dowloading that now
[22:17] <mdke> awesome
[22:18] <missaugustina> I had to reinstall my system and getting bazaar re-set up took all morning haha
[22:18] <mdke> ouch
[22:18] <missaugustina> 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] <missaugustina> The version of bazaar I had from the repositories was incompatible so I had to re-set up from the Bazaar PPA
[22:19] <missaugustina> 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] <mdke> the bzr guide should be here - https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Repository
[22:20] <mdke> if there is something you think could be added, feel free to suggest - we can always improve the info
[22:20] <mdke> hmm, annoying that you couldn't use the ordinary bzr. I wonder if that is our fault
[22:21] <missaugustina> 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] <missaugustina> Second thing is setting up the Bzr PPA
[22:21] <missaugustina> Since the versions were incompatible, or i was getting errors when trying to get the ubuntu docs branch
[22:22] <mdke> the second thing is more worrying, for me. we're doing something wrong if the branch isn't compatible
[22:22] <mdke> on the first thing, it's maybe a marginal user case, or something which we could link to another document for
[22:22] <missaugustina> I will post the errors I got, I'm on Jaunty and was running Bzr .98
[22:22] <missaugustina> or whatever is in the repositories
[22:23] <missaugustina> KeyError: 'Bazaar repository format 2a (needs bzr 1.16 or later)\n'
[22:23] <mdke> hmm
[22:23] <missaugustina> Looks like it was Bazaar 1.13
[22:23] <mdke> we should definitely fix that
[22:23] <mdke> thanks for pointing it out
[22:24] <missaugustina> 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] <mdke> one way or the other we should fix it :)
[22:25] <missaugustina> That wiki you linked is perfect, I think it's what I used the first time I set everything up.
[22:28] <missaugustina> Yay finally got it all downloaded. OK so you were saying I should make my branch look like "about-ubuntu"
[22:28] <mdke> I think that you should make changes directly to the branch you just downloaded
[22:28] <mdke> so you would add a directory "usb-creator"
[22:29] <mdke> and then you put your document in usb-creator/C/usb-creator.xml
[22:29] <missaugustina> Oh right and the tools create the other docs
[22:29] <mdke> how do you mean?
[22:30] <missaugustina> In about-ubuntu there's a "po" folder
[22:30] <mdke> oh yeah, don't worry about that
[22:30] <missaugustina> with a *.pot document
[22:30] <mdke> I'll deal with it
[22:30] <missaugustina> What are those?
[22:30] <mdke> those are for translations
[22:30] <missaugustina> Ah ok
[22:31] <missaugustina> And the *.omf file in the C directory ?
[22:31] <mdke> 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] <missaugustina> I'll give it a shot
[22:32] <mdke> about-ubuntu.xml is a good document to use as an example for yours because it is an <article> and will show you the header format that we use for our documents
[22:32] <missaugustina> Where is the Doc Book tagging guide for Ubuntu docs?
[22:32] <missaugustina> Yeah that's what I was going to draw from
[22:32] <mdke> there is a sort of basic intro here: https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Editing
[22:32] <mdke> and here for checking: https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Checking
[22:33] <missaugustina> I know HTML and I used Docbook like 10 yrs ago so it's just figuring out what tags you guys use
[22:33] <missaugustina> Excellent! Thanks
[22:33] <mdke> details of the tags are here: https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/DocbookConventions
[22:33] <mdke> that's not entirely complete, unfortunately, but if you read it, you're in good shape :)
[22:34] <mdke> thanks very much for your work on this
[22:35] <missaugustina> hey no problem! thx for letting me contribute!
[22:35] <mdke> we love contributions :)
[22:36] <mdke> ok, i'm off to bed, catch you again soon
[22:36] <missaugustina> Thx for your help! Gnite!