bkerensa | :s | 07:59 |
---|---|---|
bkerensa | hi dpm | 08:00 |
dpm | hi bkerensa | 08:29 |
littlegirl | Hey there, bkerensa, can you give a bit more detail about https://lists.ubuntu.com/archives/ubuntu-doc/2013-September/017776.html as far as when to do it? I'm assuming you do it after a bzr commit and before a bzr push, but would rather know for sure than get it wrong. (: | 14:41 |
pleia2 | littlegirl: it's before the commit, since the changelog is an edited file that you commit too | 16:07 |
pleia2 | the 'dch' command just does some magic against the text-based changelog file to add your name, email, time+date automagically | 16:08 |
littlegirl | pleia2: Oh, thank you! I love understanding how things work and when to do them. (: | 16:46 |
littlegirl | pleia2: So it doesn't ask for anything (like a comment that you have to be ready to input)? | 16:46 |
pleia2 | littlegirl: running "dch" should open up a changelog file that you edit | 16:47 |
littlegirl | pleia2: Oh, okay. Do I need to add anything, or will it add it for me (the automagically part you mentioned above)? | 16:48 |
pleia2 | littlegirl: to the changelog, just add your changes, you can browse the changelog for examples | 16:48 |
littlegirl | pleia2: Okay, that sounds good. Thanks! I like making myself a step by step reference to use for what has to happen from start to finish when I make any changes to anything huge, like somebody else's project. (: | 16:49 |
pleia2 | littlegirl: that sounds great :) | 16:50 |
* littlegirl has been known to make the occasional mistake when committing or pushing, so better safe than sorry. (: | 16:50 | |
pleia2 | thanks for pushing through and asking questions, our docs docs is such a mess and the folks who know what's going on have a hard time seeing what isn't documented | 16:51 |
belkinsa | Would this idea work for wiki pages or is that the comment text book when you save changes to a wiki page? | 16:51 |
pleia2 | belkinsa: wiki pages and the docbook docs are quite different | 16:52 |
pleia2 | so not really :\ | 16:52 |
belkinsa | pliea2: Oh, I see. | 16:52 |
littlegirl | pleia2: Any time. I'm big on making documentation as detailed and simple (a conundrum, I know) as possible. The Documentation Teams both have waaay too much documentation and it's all over the place. (: | 16:53 |
pleia2 | littlegirl: indeed! | 16:53 |
belkinsa | pleia2: I guess that's what comments are for in the wiki pages. | 16:53 |
pleia2 | belkinsa: heh, everyone uses them for different things :) | 16:53 |
littlegirl | belkinsa: No, I was talking about your https://lists.ubuntu.com/archives/ubuntu-doc/2013-September/017776.html message in the mailing list, which I assume is for those of us who are pushing changes to lp:ubuntu-docs. | 16:53 |
pleia2 | belkinsa: in theory, I think we should use them like a changelog/commit message to say what you're changing | 16:54 |
belkinsa | littlegril: I see and sorry for butting in. | 16:54 |
pleia2 | belkinsa: not butting in at all :) it was a good question | 16:54 |
littlegirl | belkinsa: No, that's great that you did. I just needed to know when to do your command and what it would do. (: | 16:54 |
belkinsa | Right, thanks. | 16:55 |
littlegirl | belkinsa: You were the first one to ever mention that it even needed to be done, so it was a good thing you noticed it and mentioned it. (: | 16:55 |
belkinsa | :blushes | 16:55 |
* littlegirl has had a rather haphazard entry into Kubuntu/Ubuntu without ever getting a proper mentor. (: | 16:55 | |
littlegirl | I've just kind of latched onto any of you who would answer my questions and gone from there. (: | 16:55 |
belkinsa | Good thing that I spoke up. | 16:56 |
littlegirl | belkinsa: Yes! How hard was it for you to clean up all of our pushes? | 16:56 |
littlegirl | I think there's been rather a lot of activity recently. (: | 16:56 |
belkinsa | littlegirl: What pushes? | 16:57 |
littlegirl | belkinsa: All of our recent pushes to lp:ubuntu-docs. A few of us had been committing, and I know at least I was guilty of not doing that dch command. | 16:57 |
belkinsa | Oh, on the wiki? Yeah, but there were minor changes, mainly to fix some of the outdated-ness. | 16:58 |
littlegirl | No, not the wiki. the Ubuntu documentation. Oh! Is the dch command only for the wiki? Or do I need to do it if I'm editing the stuff in /ubuntu-docs/ubuntu-help/C/ ? | 16:59 |
pleia2 | littlegirl: no no, dch is only for docbook docs, not the wiki | 16:59 |
littlegirl | I haven't been doing any wiki commits (I didn't even know I could). (: | 16:59 |
pleia2 | belkinsa is working on wiki; littlegirl is working on docbook docs | 16:59 |
belkinsa | That's correct. I'm the wiki person. | 16:59 |
littlegirl | pleia2: Oh! LOL! Then I don't need to do it, or I do? | 16:59 |
pleia2 | littlegirl: as I said, everyone does things differently :) | 16:59 |
littlegirl | LOL | 17:00 |
belkinsa | ;) | 17:00 |
pleia2 | in theory we probably should leave a note in the Comment: box when we make a change on the wiki, but I am lazy too and don't often do it | 17:00 |
belkinsa | I only do it when it's needed. | 17:00 |
belkinsa | to explain the changes. | 17:00 |
pleia2 | (I'm actually at a work sprint now, should pay attention) | 17:00 |
littlegirl | I have a request for either or both of you, or anyone else who can do this. I found some validation errors in the docbook docs and fixed all but one. I can't, for the life of me, figure out how. Can you guys take a look at it? | 17:00 |
littlegirl | Okay, sorry about that! | 17:02 |
littlegirl | belkinsa: I try to put comments on everything, but once in a while I forget. (: | 17:02 |
belkinsa | Maybe we need some standard produce for changelogs/comments for the wiki when it's major change and make it required by code. Or would that be too much for us? | 17:03 |
littlegirl | It might alienate newbies. I suppose you could get it to do a quick pop-up that says, "Did you remember to leave a comment letting us know what you changed?" or something like that. But even that might turn people away. | 17:04 |
belkinsa | True, true. I guess the current way works fine. | 17:05 |
belkinsa | Research in Biotechnology is a place where a researcher needs to explain why they changed something in their lab note books. That's where the idea for doing that on the wiki came from. | 17:16 |
littlegirl | I see. (: | 17:28 |
belkinsa | littlegirl: I saw your reply. Is the reason why I don't need to give your credit? Is it because you just compiled the various things into one list? | 17:30 |
littlegirl | belkinsa: It's more that it's just a list. You can give me credit, but it's not like it's a published book or anything, so anyone could have made it. (: | 17:31 |
littlegirl | belkinsa: By the way, you've got a reply to your dch thing in the mailing list. I'm going to wait until you two duke it out before deciding whether I'll do the dch or not. (: | 17:31 |
belkinsa | Um, that wasn't me. | 17:32 |
littlegirl | Oh, I am an idiot. Never mind. (: | 17:32 |
belkinsa | It's okay. | 17:32 |
belkinsa | Some of us have very close usernames here. | 17:32 |
belkinsa | nicks* | 17:32 |
littlegirl | Yeah, and I got you confused with bkerensa. (: | 17:33 |
belkinsa | I'm already used to that, has happened to me in another channel. | 17:33 |
belkinsa | Maybe I should be using Barsook instead, which is my other username I use. | 17:34 |
littlegirl | Anything is fine. All of us will eventually learn it whichever way you go. (: | 17:34 |
belkinsa | Yup. | 17:34 |
belkinsa | Also, I guess my e-mail address doesn't match my nick name. | 17:46 |
belkinsa | But that will change soon. | 17:46 |
littlegirl | It doesn't have to. (: | 17:49 |
belkinsa | I know | 17:49 |
quantumpants | hi guys | 21:23 |
quantumpants | i need help7 | 21:24 |
Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!