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

TheLordOfTimeif there's a bug in the apt manpage, does the Doc team handle fixing it, or should the person file a bug against the `apt` package and report the manpage issue?02:43
TheLordOfTimejust curious, it's a question that popped up on Ask Ubuntu and i'm curious what would be preferred.02:44
pleia2bah, sorry for top-posting on the list, my brain is in work mode (and work people top post)17:14
pleia2email is hard :)17:15
godbykpleia2: I'll forgive you... this time.17:15
pleia2hehe17:15
pleia2it's been a long wek17:16
pleia2week too17:16
pleia2weeeeeeeeek17:16
pleia2^^ long17:16
godbykI hear ya. It's been a long week here, too.17:16
godbykI'll be out of town this next week at a conference (in San Diego).17:16
godbykSo I won't get much done then either.17:16
pleia2ooh, have fun17:17
godbykI'm hoping it'll be fun. I generally enjoy conferences. If nothing else, it's a change of scenery. :)17:18
pleia2san diego should be nice this time of year17:18
godbykYou're in San Francisco, right?17:19
pleia2yep17:19
pleia2far away from san diego :)17:19
godbykCool. I had a conference in SF a few years ago that was a lot of fun. I enjoyed SF.  I haven't been to San Diego before.17:20
pleia2SF is my favorite place17:20
pleia2I've been to SD once, last year for a conference in December17:20
pleia2stayed a couple days longer to go to the zoo and wild animal park17:21
godbykThat sounds fun.17:21
pleia2it was amazing :)17:21
godbykI have a conference in Orlando in December.17:21
pleia2I did disney during my last orlando conference17:21
godbykIt'll be a nice reprieve from the Iowa winter. :)17:21
pleia2see, when someone is paying for my flight, I go all out with add-on vacations :)17:22
godbykI don't blame you! I'd take advantage of that, too, if I had the time.17:22
* pleia2 nods17:22
pleia2time certainly can be an issue17:22
pleia2heading to the Sierra Nevada mountains this weekend for my birthday \o/17:23
pleia2driving up tonight17:23
godbykHopefully once I finish grad school, I'll have more time on my hands. :)17:23
godbykOh, well, happy birthday!17:23
godbykMy birthday was earlier this week.17:23
pleia2the plan had been hiking, but I'm on the tail end of a sprained ankle, so I think the plan now is fireplace and pool :)17:23
pleia2thanks, and happy birthday to you too!17:23
pleia2most popular time of year for birthdays17:24
godbykBoth plans sound great.17:24
godbykYeah, I can't imagine why that is. ;-)17:24
pleia2agreed, no disappointment here with change of plans17:24
pleia2hehe17:24
godbykA couple of my siblings have birthdays this week, too.  Sept. 23, 25, and 26.17:24
pleia2hah17:25
pleia2nice planning, get all the kiddo birthdays done with at the same time ;)17:25
godbykI have a young cousin (he's 5 now I think?) who shares my birthday. Last year at his party, we had a bit of a disagreement over who's birthday it was. :)17:25
pleia2hehe17:25
godbykSomething I'd like to pick your brain on sometime (probably after Ubuntu 13.10 is released) is how the docs team can work more closely with the designers and developers.17:29
godbykI'd like the designers and developers to start alerting the docs team when they make changes that are likely to affect the docs.17:29
godbykOr at least find a better way to keep track of changes.17:29
godbykHaving to review all the docs at each release is quite time-consuming and a nearly impossible task.17:30
pleia2yeah, I know bkerensa tried to do some of that this cycle for new features by pinging them about it but they were somewhat unresponsive17:31
pleia2need to figure out a better strategy I think17:31
godbykYeah. He was trying to sort out what should appear on the 'what's new' page, I think.17:31
* pleia2 nods17:32
godbykI'm hoping that we can coerce some people involved in key projects (e.g., Unity) to help keep us informed.17:32
godbykOr figure out which mailing lists and IRC channels we should be eavesdropping on.17:33
pleia2yeah, that would be good17:34
godbykThe manual project has the same issue.17:35
godbykOn the plus side, I haven't noticed and freeze exception requests yet. So that's good.17:36
pleia2yeah :)17:38
bkerensagodbyk: The developers are not going to do that17:54
bkerensaI am a dev17:54
bkerensaand there are lots of others17:54
bkerensaand then there are Canonical devs and there is just no way with the amount of work that full time developers do that they can notify the doc team17:55
godbykbkerensa: Do you have any other ideas of how the docs team can more easily keep up with changes?17:55
godbykAre there any pertinent mailing lists of IRC channels that we should attend to?17:56
bkerensagodbyk: The ideal situation would be for someone from Jono's team or the Desktop Team to provide a summary of things they plan in the cycle17:56
bkerensaand then maybe a final summary just before freeze in case things are rushed in17:56
godbykbkerensa: Yes, that would be a great help.17:56
bkerensagodbyk: sure ubuntu-devel, ubuntu-desktop,  releasename-changes17:56
bkerensaall good mailing lists to watch17:57
godbykCurrently, we're stuck reading each page of documentation and running through the procedures on that page to see if they still hold true in the newer version of Ubuntu. And that's quite time-consuming.17:57
bkerensasure17:57
bkerensaand also another issue is Canonical carries deltas in some Gnome apps17:57
bkerensathey have customized some of them17:57
bkerensaso17:57
bkerensawhen we import GNOME doc17:57
bkerensafeatures in GNOME may not exist in Ubuntu17:58
bkerensaand vice versa17:58
bkerensasome level of fragmentation17:58
bkerensaand I believe the gap will grow as Canonical continues to bake features they think are important to the end user17:58
bkerensaI know there was plans at one point to revamp network-manager17:58
godbykYeah, I've noticed that.17:59
bkerensathis is not unique to just GNOME17:59
godbykWhat's the best way to discover those deltas?17:59
bkerensaCanonical also ships a non-Vanilla Firefox and Chromium by baking in stuff17:59
bkerensagodbyk: you have to just be a daily user of the development release17:59
bkerensaand notice changes17:59
bkerensatry to monitor the mailing lists I suppose18:00
bkerensaI think next cycle of doc will be a significant opportunity to get things even fresher then this release18:00
godbykbkerensa: I agree. That's why I'd like to try to get these things in place so we don't have all these changes fall through the cracks.18:02
bkerensagodbyk: I think we just need to consider making a internal workflow for doc18:02
bkerensaregular health checks of pages18:02
bkerensaon certain dates and a todo list18:02
godbykbkerensa: Agreed.18:02
bkerensagodbyk: I did tell you I plan to continue contributing to doc right?18:02
godbykbkerensa: For example, track the upstream GNOME docs more closely so we're dealing with smaller deltas.18:02
bkerensaI guess pleia2 had not originally been clear on that but I do plan on staying at least another full cycle18:03
godbykbkerensa: I wasn't sure. I knew you were stepping back from a lot of your other Ubuntu work, but wasn't sure if you were sticking around for docs.18:03
bkerensayeah18:03
godbykbkerensa: I'm glad to hear it, though!18:03
bkerensaI wanted to seem that I would be mostly unavailable as a go to person18:03
bkerensaI have too much on my plate right now to be a go to person ;)18:03
godbykbkerensa: I also want to make sure we update our internal documentation. I think a lot of procedures are underdocumented or out of date.18:04
bkerensagodbyk: indeed we should plan to meet maybe in about two weeks18:04
bkerensagodbyk: I would like to get regular meetings back18:04
pleia2++18:04
godbykbkerensa: Regular meetings definitely help keep everyone on track.18:04
godbykWe discovered that with the manual team, too.18:05
bkerensaBut like I said I cannot always drive them18:05
bkerensaother people need to step up and lead too18:05
bkerensa:)18:05
godbykbkerensa: No problem. :)18:05
bkerensamaybe we could plan a certain day every month?18:05
godbykMonthly meetings seem doable.18:05
bkerensagodbyk: Maybe you could e-mail the list and ask folks what day and time of the week usually works best for everyone when iit comes to availability?18:06
bkerensaand then we can just make it so18:06
godbykbkerensa: Yeah, I'll try to get it set up.18:06
bkerensacool18:06
bkerensathanks for that18:06
godbykWe should try to have a meeting not long after Ubuntu 13.10 is released.18:06
bkerensagodbyk: your work has been amazing18:07
bkerensajono: send this guy some swag ^18:07
pleia2godbyk rocks!18:07
bkerensa:P18:07
godbykThat'll give us a chance to assess how our work during the Saucy cycle went, what we could do better, etc. before everyone forgets.18:07
pleia2yeah18:07
bkerensaexactly18:07
bkerensawe could do a SWOT18:07
godbykThen we can also work on outlining what we'd like to accomplish for 14.04.18:07
* godbyk things bkerensa has taken too many management courses. ;-)18:07
bkerensaI have18:07
bkerensa:)18:07
pleia2lol18:07
godbykBut really, it is a good way to assess things.18:08
pleia2I don't even know what a SWOT is18:08
* pleia2 googled18:08
bkerensapleia2: you should have come to the Moz office18:08
godbykstrengths, weaknesses, opportunities, and threats.18:08
bkerensathey were filling my mind with SWOT18:08
pleia2hehe18:08
bkerensaand "Team Building Excercises"18:08
bkerensaI feel like it was a Tony Robbins seminar18:08
* godbyk has a degree in technology management, though he tries not to let people know that. ;-)18:08
pleia2bkerensa: hahah18:09
pleia2I am surprisingly productive given my relative lack of formal education about anything18:09
pleia2imagine if I was trained, I'd be killing it :)18:09
godbykpleia2: I'm not sure said formal education is worth much. :)18:09
godbykEspecially with tech stuff.. it changes so fast that by the time they create a course about it, it's out of date.18:10
bkerensapleia2: http://cdn.benjaminkerensa.com/wp-content/uploads/2013/08/DSC_1829.jpg18:10
bkerensathats Whoosh18:10
bkerensahttp://improvencyclopedia.org/games/Whoosh.html18:10
belkinsapleia2: Thanks for fixing the header on Ubuntu wiki home page.18:10
bkerensawell18:10
bkerensaWhoosh + T-Rex18:10
bkerensa:)18:10
pleia2belkinsa: I top-posted on that thread, my bad :) was in work mode and everyone at work uses outlook and top posts18:11
belkinsaHeh, it's cool.18:11
pleia2good golly, bkerensa and belkinsa in channel at once, my brain asplode18:11
belkinsaYup.18:11
belkinsa:)18:11
belkinsa(I didn't even  notice that it was top-posted)18:12
bkerensapleia2: lucky bkero is not here :)18:12
pleia2hehe18:12
bkerensaBenjamin Kero my arch open source nemesis18:12
pleia2plars is fun for me in -release18:12
pleia2I was once in a channel with a pleiades, that was also fun18:13
pleia2I have quite the fondness for that constellation18:13
godbykAnd it's just a cool name.18:14
pleia2yeah :)18:14
belkinsaI'm off, see ya all.18:15

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