/srv/irclogs.ubuntu.com/2013/09/17/#ubuntu-doc.txt

bkerensa:s07:59
bkerensahi dpm08:00
dpmhi bkerensa08:29
littlegirlHey 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
pleia2littlegirl: it's before the commit, since the changelog is an edited file that you commit too16:07
pleia2the 'dch' command just does some magic against the text-based changelog file to add your name, email, time+date automagically16:08
littlegirlpleia2: Oh, thank you! I love understanding how things work and when to do them. (:16:46
littlegirlpleia2: So it doesn't ask for anything (like a comment that you have to be ready to input)?16:46
pleia2littlegirl: running "dch" should open up a changelog file that you edit16:47
littlegirlpleia2: Oh, okay. Do I need to add anything, or will it add it for me (the automagically part you mentioned above)?16:48
pleia2littlegirl: to the changelog, just add your changes, you can browse the changelog for examples16:48
littlegirlpleia2: 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
pleia2littlegirl: 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
pleia2thanks 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 documented16:51
belkinsaWould this idea work for wiki pages or is that the comment text book when you save changes to a wiki page?16:51
pleia2belkinsa: wiki pages and the docbook docs are quite different16:52
pleia2so not really :\16:52
belkinsapliea2: Oh, I see.16:52
littlegirlpleia2: 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
pleia2littlegirl: indeed!16:53
belkinsapleia2: I guess that's what comments are for in the wiki pages.16:53
pleia2belkinsa: heh, everyone uses them for different things :)16:53
littlegirlbelkinsa: 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
pleia2belkinsa: in theory, I think we should use them like a changelog/commit message to say what you're changing16:54
belkinsalittlegril: I see and sorry for butting in.16:54
pleia2belkinsa: not butting in at all :) it was a good question16:54
littlegirlbelkinsa: No, that's great that you did. I just needed to know when to do your command and what it would do. (:16:54
belkinsaRight, thanks.16:55
littlegirlbelkinsa: 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:blushes16:55
* littlegirl has had a rather haphazard entry into Kubuntu/Ubuntu without ever getting a proper mentor. (:16:55
littlegirlI've just kind of latched onto any of you who would answer my questions and gone from there. (:16:55
belkinsaGood thing that I spoke up.16:56
littlegirlbelkinsa: Yes! How hard was it for you to clean up all of our pushes?16:56
littlegirlI think there's been rather a lot of activity recently. (:16:56
belkinsalittlegirl: What pushes?16:57
littlegirlbelkinsa: 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
belkinsaOh, on the wiki?  Yeah, but there were minor changes, mainly to fix some of the outdated-ness.16:58
littlegirlNo, 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
pleia2littlegirl: no no, dch is only for docbook docs, not the wiki16:59
littlegirlI haven't been doing any wiki commits (I didn't even know I could). (:16:59
pleia2belkinsa is working on wiki; littlegirl is working on docbook docs16:59
belkinsaThat's correct.  I'm the wiki person.16:59
littlegirlpleia2: Oh! LOL! Then I don't need to do it, or I do?16:59
pleia2littlegirl: as I said, everyone does things differently :)16:59
littlegirlLOL17:00
belkinsa;)17:00
pleia2in 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 it17:00
belkinsaI only do it when it's needed.17:00
belkinsato explain the changes.17:00
pleia2(I'm actually at a work sprint now, should pay attention)17:00
littlegirlI 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
littlegirlOkay, sorry about that!17:02
littlegirlbelkinsa: I try to put comments on everything, but once in a while I forget. (:17:02
belkinsaMaybe 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
littlegirlIt 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
belkinsaTrue, true.  I guess the current way works fine.17:05
belkinsaResearch 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
littlegirlI see. (:17:28
belkinsalittlegirl: 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
littlegirlbelkinsa: 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
littlegirlbelkinsa: 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
belkinsaUm, that wasn't me.17:32
littlegirlOh, I am an idiot. Never mind. (:17:32
belkinsaIt's okay.17:32
belkinsaSome of us have very close usernames here.17:32
belkinsanicks*17:32
littlegirlYeah, and I got you confused with bkerensa. (:17:33
belkinsaI'm already used to that, has happened to me in another channel.17:33
belkinsaMaybe I should be using Barsook instead, which is my other username I use.17:34
littlegirlAnything is fine. All of us will eventually learn it whichever way you go. (:17:34
belkinsaYup.17:34
belkinsaAlso, I guess my e-mail address doesn't match my nick name.17:46
belkinsaBut that will change soon.17:46
littlegirlIt doesn't have to. (:17:49
belkinsaI know17:49
quantumpantshi guys21:23
quantumpantsi need help721:24

Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!