/srv/irclogs.ubuntu.com/2013/12/06/#ubuntu-meeting.txt

=== freeflying_away is now known as freeflying
=== shuduo_afk is now known as shuduo
=== jono is now known as Guest52213
=== funkyHat_ is now known as funkyHat
=== penghuan_ is now known as penghuan
=== ochosi_ is now known as ochsoi
=== ochsoi is now known as ochosi
=== cjwatson_ is now known as cjwatson
=== czajkows1i is now known as czajkowski
=== yofel_ is now known as yofel
=== shuduo is now known as shuduo_afk
=== ivoks_ is now known as ivoks
=== freeflying is now known as freeflying_away
=== freeflying_away is now known as freeflying
=== freeflying is now known as freeflying_away
=== doko_ is now known as doko
=== retoaded is now known as retoaded_biab
=== retoaded_biab is now known as retoaded
GunnarHjHello docs folks! :)21:56
belkinsaHello there21:56
knomehello GunnarHj21:58
GunnarHjknome: Hi, and welcome in this context.21:59
knometa ta21:59
* pleia2 waves21:59
pleia2ok, who wants to play chair?22:00
pleia2#startmeeting22:00
meetingologyMeeting started Fri Dec  6 22:00:15 2013 UTC.  The chair is pleia2. Information about MeetBot at http://wiki.ubuntu.com/meetingology.22:00
meetingologyAvailable commands: #accept #accepted #action #agree #agreed #chair #commands #endmeeting #endvote #halp #help #idea #info #link #lurk #meetingname #meetingtopic #nick #progress #rejected #replay #restrictlogs #save #startmeeting #subtopic #topic #unchair #undo #unlurk #vote #voters #votesrequired22:00
godbykHello, everyone.22:00
pleia2#chair godbyk22:00
meetingologyCurrent chairs: godbyk pleia222:00
dsmythiesHello.22:00
* belkinsa is here for the meeting22:00
knomeo/22:00
GunnarHjme to22:00
GunnarHjo22:01
pleia2#link https://wiki.ubuntu.com/DocumentationTeam/MeetingAgenda22:01
pleia2meeting agenda :)22:01
knomepleia2, pure links are #linkified without #link22:01
pleia2dsmythies: ok to start off with your items from the blueprint?22:01
pleia2#chair dsmythies22:01
meetingologyCurrent chairs: dsmythies godbyk pleia222:01
pleia2knome: neat22:01
eagles0513875hey all :)22:02
eagles0513875hey belkinsa22:02
pleia2#topic Inter-group collaboration / cooperation22:03
=== meetingology changed the topic of #ubuntu-meeting to: Inter-group collaboration / cooperation
eagles0513875hey pleia222:03
pleia2so if everyone wants to browse to the blueprint: https://blueprints.launchpad.net/ubuntu/+spec/community-1311-docteam-roundtable22:03
pleia2dsmythies left a bunch of comments on this topic :)22:03
pleia2eagles0513875: welcome to the meeting!22:03
pleia2there was a possible solution and a work around for the translations workflow that currently leaves the server docs behind, any comments?22:04
dsmythiesI am looking for help with this one: "For the DeskTop help documentation, there is a jpeg file that includes the entity of the release name. This file has not been updated since Quantal, because nobody in the doc team knows the procedure. "22:04
knomeis it used anywhere?22:05
pleia2(I don't really know much about translations, so I don't really understand the workings here)22:05
pleia2dsmythies: I can take an action item to figure that out22:05
godbykdsmythies: Which file is it?22:06
dsmythiesO.K. thanks.22:06
pleia2#action pleia2 to figure out where the release name jpg comes from22:06
meetingologyACTION: pleia2 to figure out where the release name jpg comes from22:06
dsmythiesI supply the file name in a moment...22:06
pleia2thanks :)22:06
knomeaiui, the "workaround" mentioned in the blueprint is *the* solution22:07
godbykdsmythies: ./ubuntu-help/C/figures/ubuntu-quantal.jpg?22:07
knomeyou *need* to update the package from project at doc string freeze22:07
knomethough the translations could be done against the product22:07
godbykhttps://help.ubuntu.com/13.10/ubuntu-help/figures/ubuntu-quantal.jpg22:07
knomewhich would mean translators could start working on the translations as soon as the strings change in the product22:08
knomethen all of that would be pushed in the package (at least on the translation freeze)22:08
dsmythies./ubuntu-help/C/figures/ubuntu-quantal.jpg? yes. thanks.22:09
dsmythiesyou *need* to update the package from project at doc string freeze: Yes, thanks.22:09
knome(and/)or the translation string freeze, if the translations are done against the project22:10
GunnarHjCould the package be updated more frequently, to make it easier for the translators, and also make it easy for everyone to follow the progress with the docs?22:11
knomeif the translations are done against the project, there is no reason why it couldn't be done with every push22:11
knomeas long as people update the .pot file(s)22:12
dsmythiesI could update help.ubuntu.com more often if people want.22:12
dsmythiesWe don't typically update the .pot file often.22:12
knomethat would be the solution though22:13
belkinsaMay I ask what is a .pot file is?22:13
knomebelkinsa, a translation template file22:13
belkinsaThank you.22:13
godbykbelkinsa: It's the 'translation template' file. It contains the list of text that the translations should translate.22:13
knomethe issue with updating the .pot file often is that people who are translating actively might translate many strings that are dropped from the final version as further fixes and additions are made22:14
knomethe issue with not updating the .pot file often is that a lot of new strings become translatable at the same time22:15
knomeand it might be a burden that the translators can't handle, especially if that happens really close to the release22:15
GunnarHjknome: The sooner we do our part, the better - still applies, right?22:16
knomesure22:16
dsmythiesI agree, but tranlations drag on, and we want to be able to publish later trnalations without folding back in a new .pot file, if possible.22:16
pleia2yeah, the docs evolve through the cycle so we don't want people translating *similar* strings 5 times because we keep changing wording22:17
pleia2I believe strings that remain between releases remain translated, right?22:17
GunnarHjpleia2: But, to be honest, how often does that happen?22:17
godbykThat's the basic reason why we have a string freeze.22:17
knomeone of the things you can do is keep reviewing the strings before they land in the docs to make sure they are of high quality and do not need changing22:17
knomepleia2, yes.22:17
pleia2GunnarHj: historically, not often because there was one guy working on docs :) but we're reviving the team22:18
GunnarHjpleia2: Ok, point taken. ;-)22:18
knomedocumentators should take care of their wording.22:18
knomeif they mess it up, that's too bad, but it shouldn't happen again and again22:18
pleia2GunnarHj: it may be a non-issue, but I just don't know yet22:18
knomeyou probably want to talk with the translators to hear what they think22:19
dsmythiesO.K., lets move on.22:19
belkinsaI agree on that.22:19
knomethey might either appreciate all-at-once or do not mind about having to translate certain strings multiple times22:19
pleia2do we want to talk about upstream issues? (see the blueprint)22:20
godbykUpstream issues referring to gnome-docs or something else?22:20
pleia2"During the 13.10 cycle, the docs (both the serverguide and Ubuntu DeskTop help) uncovered a number of issues where the root causes are really upstream GNOME yelp issues."22:20
pleia2etc22:20
pleia2so I'm thinking yes :)22:20
godbykpleia2: Ah! Gotcha.22:20
godbykYeah, one problem we encountered early on was that some docs have conditional text in them.22:21
dsmythiesYesm gnome stuff. I think Shaune McCance22:21
godbykThe text varies depending on if you view the docs in Unity or GNOME Shell or LXDE, etc.22:21
knomeComment from Little Girl with my apologies if this is in the wrong place - feel free to delete or move it (2013-11-03): ...22:21
knomesee the blueprint! :)22:21
godbykAnd there was a bug where the Yelp app wouldn't detect Unity properly.22:21
godbykSo it'd always display GNOME Shell docs instead of Unity docs.22:21
GunnarHjHas anyone filed a yelp bug?22:22
godbykI think we got the Unity bug patched and fixed, however. Did that patch make its way into the 13.10 repositories, dsmythies? Or were there other Yelp issues, too?22:22
pleia2knome: ah yes! good catch, LittleGirl chatted with Shaun22:22
godbykGunnarHj: I filed the one about Unity (along with a patch).22:22
dsmythiesYes, I filed upstream bug reports22:22
pleia2bottom of blueprint whiteboard22:22
dsmythiesOne upstream bug is fixed, but the fixed has yet to propagate down.22:23
GunnarHjNot much more to talk about now then, or?22:24
godbykOkay. Who do we pester to get it propagated down?22:24
dsmythiesI do not know, and am not certain that is hasn't. I don't know what revision number to look for.22:25
godbykdsmythies: Ah, I found the upstream bugs you sent me in an email:22:27
godbykhttps://bugzilla.gnome.org/show_bug.cgi?id=70995122:27
godbykhttps://bugzilla.gnome.org/show_bug.cgi?id=70994322:27
godbykhttps://bugzilla.gnome.org/show_bug.cgi?id=70994122:27
ubottuGnome bug 709951 in yelp-build "yelp build ignores conditionals when creating file copy list" [Normal,Resolved: fixed]22:27
ubottuGnome bug 709943 in DocBook "yelp-xsl/xslt/common/html.xsl missing a fundamental docbook tag conversion" [Normal,Unconfirmed]22:27
ubottuGnome bug 709941 in yelp-build "html looks for yelp-code.png which is not there" [Normal,Unconfirmed]22:27
GunnarHjRobert Ancell seems to have updated yelp (ubuntu) with upstream news lately.22:27
godbykI'll take a look at those again.22:27
dsmythies709943 has a workaround.22:28
dsmythies709941 is not the end of the world.22:28
dsmythiesgodbyk: If you could help woth communications with Shaun? He seems to help from the gnome side sometimes.22:29
godbykdsmythies: Yeah, I'll get into it.22:30
dsmythiesThanks.22:30
pleia2\o/22:30
pleia2ok, I think that's it for the blueprint topics, looks like we talked about the others during the vuds session22:31
pleia2#topic What's new - should cover 12.04->14.04 (GunnarHj)22:31
=== meetingology changed the topic of #ubuntu-meeting to: What's new - should cover 12.04->14.04 (GunnarHj)
pleia2GunnarHj: can you share some thoughts here?22:32
GunnarHjI think that most people stick with LTS, so it would make sense that the "What's new" page covers everything since last LTS.22:32
godbykdsmythies: You can find a yelp-code.png file at /usr/share/yelp-xsl/icons/hicolor/watermarks/yelp-code.png provided by the yelp-xsl Ubuntu package. (Just FYI.)22:32
pleia2GunnarHj: yeah, that makes sense22:33
GunnarHjThat's the whole point from my side. ;-)22:33
godbykWe could split it into two sections, too. "Since [previous LTS]" and "Since [previous release]".22:33
pleia2godbyk: yeah22:33
belkinsaThat works.22:34
GunnarHjgodbyk: +122:34
dsmythiesgodbyk: I know, but we don't actually want a watermakr at all.22:34
pleia2#topic Sync with gnome-user-docs early22:34
=== meetingology changed the topic of #ubuntu-meeting to: Sync with gnome-user-docs early
knomedsmythies, add an empty png22:34
godbykdsmythies: Ah, okay. I see what you're saying then.22:34
dsmythiesI did, last cycle.22:34
GunnarHjMe again... I think we should do that sync as early as possible, so we then have sufficient time to review the result and finalize ubuntu-docs.22:35
godbykGunnarHj: +122:35
dsmythies+122:35
godbykLast cycle we didn't even finish syncing. :-(22:35
GunnarHjThere is no reason to fear very much late GNOME changes anyway.22:35
belkinsaGunnerHj: +122:36
pleia2hooray, consensus :)22:36
godbykGunnarHj: Especially since I think we may be lagging behind a GNOME release for 14.04.22:36
GunnarHjgodbyk: Precisely22:36
knomeno, Trustily22:36
pleia2do we want to decide upon a date (or month) for this?22:36
pleia2knome :P22:37
knomeASAP = now?22:37
GunnarHjknome: +122:37
godbykDo you know which version of GNOME we're using for 14.04?22:37
godbyk(Not that I expect it'll change things too much for us anyway...)22:37
GunnarHjMostly 3.8, but as regards gnome-control-center, which heavily affects the docs, 3.6.22:38
godbykGunnarHj: Okay, thanks.22:38
dsmythiesEnd of January target?22:38
godbykdsmythies: Seems reasonable.22:38
godbykThen we can start modifying everything that's Ubuntu-specific.22:39
pleia2ok great22:39
pleia2#topic Community Help Wiki (knome)22:39
=== meetingology changed the topic of #ubuntu-meeting to: Community Help Wiki (knome)
pleia2https://help.ubuntu.com/community/FrontPageRefresh22:39
pleia2ooh pretty :)22:39
knomeyep, i've worked on that for a replacement for the community help wiki22:40
belkinsaIt's cleaner for sure.22:40
GunnarHjIndeed great work so far. :)22:40
knomein addition, i've created https://help.ubuntu.com/community/OtherResources (WIP) for the purposes of replacing the signpost22:40
knomeall feedback is welcome.22:40
belkinsaI think the Other Resources page is a better choice then that signpost, since it lists the links that people may be looking form22:41
belkinsafor*.22:41
knomeit doesn't need to be an exhaustive list of all URLs in the internet22:41
knomejust some of the most used/useful ones22:42
belkinsaI agree.22:42
knomethe people can find the useless ones without our help, believe me22:42
belkinsaEnough for people to get started.22:42
pleia2lol22:42
knomeand that's basically it22:42
pleia2ok, thanks knome :)22:42
knomethis is not the agenda, but...22:43
knomei'd like to become an admin in the community help wiki22:43
GunnarHjPossibly we should try to find a *short* list of other resources that we recommend.22:43
belkinsa+122:44
knomeGunnarHj, yep, also https://help.ubuntu.com/community/ExternalGuides is linked from that page22:44
knomeso there is plenty of links22:44
belkinsa#link https://wiki.ubuntu.com/DocumentationTeam22:44
knomeand tbh, how much else do we need than;22:44
pleia2knome: right, I'll send a +1 to the list on that (I'm not a wiki admin, but there are precious few of them, so anything will help I think)22:44
GunnarHjknome: Possibly too many of them...22:44
knomeaskubuntu, ubuntu forums, mailing list, irc, manpages, guides22:44
knomeand flavor support links22:44
knomeGunnarHj, sure, i agree, but that's a content problem, and not the main area of my interest :)22:45
belkinsaThose is enough, I think.22:45
knome(don't get me wrong...)22:45
belkinsaare*22:45
godbykI'm fairly ignorant of how the Ubuntu wiki is set up. What superpowers do wiki admins have?22:45
knomeGunnarHj, delete/move pages/attachments22:45
knomegodbyk, ^22:45
belkinsaRenaming too22:45
knomewell doesn't that equal to move? :)22:46
GunnarHjknome: To make a difference, we should point at resources with good quality. People know how to google anyway.22:46
belkinsaSomewhat22:46
knomeGunnarHj, yep.22:46
knomeGunnarHj, same problem around the help wiki though; some of the content in there is not quality content either22:46
godbykknome: Ah, okay. Thanks.22:47
GunnarHjknome: True.22:47
knomefrom my pov, once we get https://help.ubuntu.com/community/OtherResources finished, we can drop https://help.ubuntu.com/community/FrontPageRefresh as the front page22:47
belkinsaYeah, developers just don't doc, they just develop.22:47
knomeand then we can keep on reviewing and enhancing it22:47
knomeslickymaster expressed his concerns of the topic list gettting too long22:48
knomebut i don't think i know the wiki enough to judge if there is something we could drop or not.22:48
belkinsaMost of us don't have that skill.22:49
belkinsaTechnical skill, I mean.22:49
knomei guess the right way to go forward is to keep on digging deeper in the wiki and clean up page by page.22:49
* pleia2 nods22:49
GunnarHjI think we should encourage knome to keep on his work with front page and other resources. It will be a step in the right direction IMO.22:49
knomewhat will ultimately tell us what's useful and what not22:49
* belkinsa nods22:50
godbykCan we get any statistics as to how many visits each wiki page gets?22:50
belkinsa+1 on that idea22:50
godbykThat'd help us focus our efforts there, I think.22:50
pleia2we can ask IS22:50
knome#action knome to finish OtherResources and then send an email to the -doc list to propose the new frontpage layout22:50
meetingologyACTION: knome to finish OtherResources and then send an email to the -doc list to propose the new frontpage layout22:50
belkinsaAlso it could tell us how many are using the wiki also22:51
pleia2I suppose I can submit a ticket to see about that (they LOVE me, I bug them all day long!)22:51
knomesame here22:51
knomehey littlegirl22:51
pleia2#action pleia2 to ask Canonical IS about getting help wiki stats22:51
meetingologyACTION: pleia2 to ask Canonical IS about getting help wiki stats22:51
pleia2#topic Redundancy of Community Wiki and Other Forms of Support (belkinsa)22:52
=== meetingology changed the topic of #ubuntu-meeting to: Redundancy of Community Wiki and Other Forms of Support (belkinsa)
pleia2is there more to discuss here?22:52
godbykOr have we already covered this sufficiently on the mailing list?22:52
belkinsaI think we may of covered it well on the mailing list.22:52
pleia2ok, cool22:53
pleia2#topic Any other business22:53
=== meetingology changed the topic of #ubuntu-meeting to: Any other business
* belkinsa raises my hand22:53
pleia2anything else to chat about at this time?22:53
belkinsaI have one22:53
pleia2belkinsa: go for it22:53
belkinsaDo we think we need some form of blog posting to tell others in the community what the Doc Team is doing?  To get more folks in.22:54
pleia2historically we've just done it via personal blogs that go to planet22:54
belkinsaEven maybe getting developers to have some form of docs for the programs.22:54
godbykbelkinsa: We could, but before we do, we should probably have a list of tasks that are ready for people to work on.22:54
belkinsaRight.22:55
pleia2I'm inclined to keep it that way now, the idea of adding another resource to update because we have too many resources to update ourselves makes me worried though22:55
belkinsaOh, right.  That issue.22:55
pleia2hehe22:55
godbyk:)22:55
belkinsaNever mind then.22:55
GunnarHjAny effort to make the developers at least think of the docs aspect is welcome.22:55
pleia2oh, so we could send task announcements to our ubuntu-doc list and them submit them to the ubuntu-weekly-newsletter for inclusion22:55
pleia2there is an "Other Community News" section they would fit nicely into :)22:55
belkinsaSure, that works.22:56
pleia2yay22:56
belkinsaI guess I was really looking for that.22:56
pleia2perfect, thanks for the idea22:56
belkinsaNot a problem.22:56
knomethe real question is22:56
pleia2does anyone read UWN? ;P22:57
knomewho would write an article to be sent to the newsletter and/or the planet22:57
pleia2hah right, that22:57
belkinsaI do.22:57
* godbyk nominates knome!22:57
pleia2w00t22:57
knomegodbyk, no thanks at this point, but i might do that later. thanks for the nomination ;)22:57
belkinsaBut stats would be nice for UWN.22:57
godbykknome: It was worth a shot! ;-)22:57
knomealways.22:58
knomei'll keep it in mind though22:58
knomeit's been a while since i've posted22:58
belkinsaAnd the article idea is a good one too.22:58
pleia2ok, anything else?22:58
pleia2thanks everyone :)22:59
godbykShould we set up a poll for another meeting in January?22:59
pleia2godbyk: yeah22:59
belkinsaNot a problem and yes.23:00
dsmythiesno, nothing else from me. bye.23:00
pleia2#action pleia2 to set up poll for january meeting23:00
meetingologyACTION: pleia2 to set up poll for january meeting23:00
pleia2happy holidays, all :)23:00
pleia2#endmeeting23:00
=== meetingology changed the topic of #ubuntu-meeting to: Ubuntu Meeting Grounds | Calendar/Scheduled meetings: http://fridge.ubuntu.com/calendar | Logs: https://wiki.ubuntu.com/MeetingLogs | Meetingology documentation: https://wiki.ubuntu.com/meetingology
meetingologyMeeting ended Fri Dec  6 23:00:22 2013 UTC.23:00
meetingologyMinutes (wiki):        http://ubottu.com/meetingology/logs/ubuntu-meeting/2013/ubuntu-meeting.2013-12-06-22.00.moin.txt23:00
meetingologyMinutes (html):        http://ubottu.com/meetingology/logs/ubuntu-meeting/2013/ubuntu-meeting.2013-12-06-22.00.html23:00
belkinsaThank you.23:00
godbykThanks for chairing, pleia2!23:01
=== freeflying_away is now known as freeflying

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