=== Greeneggsnospam is now known as jsgotangco === jsgotangco is now known as Greeneggsnospam [09:44] damn connection === qwebirc222107 is now known as slickymasterWork [16:59] Doc Team meeting in Hour in #ubuntu-meeting! [16:59] In an hour* [17:42] Meeting is in 15 minutes in #ubuntu-meeting! [17:49] Meeting in 10 minutes in #ubuntu-meeting! [17:54] Meeting in 5 minutes in #ubuntu-meeting! [17:59] The meeting, in #ubuntu-meeting, is starting right now! [18:00] Agenda: https://wiki.ubuntu.com/DocumentationTeam/MeetingAgenda [18:00] Who is here for the Doc Team meeting? [18:01] Sorry, wrong window. === shaunm_ is now known as shaunm [18:39] GunnarHj: some teams have included virtual participants in their sprints in the past. I don't control what happens in the sprints [18:40] I've done in-person sprints and I've done virtual sprints. they both have their strengths and weaknesses. but virtual sprints are just no substitute for face time with your community [18:41] agreed, in person sprints are super useful [18:41] shaunm: Ok, I see. The problem is the distance. [18:41] yeah, it's hard for an all volunteer team to find resources for such a thing [18:41] sure. unfortunately, the planet is rather big [18:42] Canonical does have community funding that we might look into: http://community.ubuntu.com/help-information/funding/ [18:42] does canonical not have money to throw at volunteer community members? [18:43] hmm. [18:43] knome, meeting in #ubuntu-meeting, if you want to join in. [18:44] it would require a pretty detailed proposal to bring to canoncal and buy-in from the whole team, but I think it's a real option [18:44] and they don't disclose how much money exists in this community pool, so I'd shoot for being frugal [18:45] hehe [19:03] Well, that was a fail. [19:03] what then? :) [19:03] Maybe we should do the meetings here instead. [19:04] belkinsa: What was a fail? [19:04] probably. [19:04] We could hold meetings in this channel. We have the meetingology bot here. [19:04] this channel could use some activity. it's been dead for a few years [19:04] Yeah and we can have longer meetings. [19:04] And we don't have to worry about scheduling conflicts with others. [19:05] belkinsa: Are we returning to the meeting? [19:05] You think we can move on with the meeting here with meetingology? [19:05] #startmeeting [19:05] Meeting started Wed May 7 19:05:52 2014 UTC. The chair is knome. Information about MeetBot at http://wiki.ubuntu.com/meetingology. [19:05] Available commands: action commands idea info link nick [19:05] #chair belkinsa [19:05] Current chairs: belkinsa knome [19:05] godbyk, and pmatulis_ [19:05] #unchair knome [19:05] Current chairs: belkinsa knome [19:06] #chair godbyk pmatulis_ [19:06] Current chairs: belkinsa godbyk knome pmatulis_ [19:06] #unchair knome [19:06] Current chairs: belkinsa godbyk knome pmatulis_ [19:06] knome: You were awfully spry with meetingology.. sure you don't want to be a chair? :-) [19:06] yeah, i'm running in 5 [19:06] Anyway.. [19:06] heh, the #unchair command doesn't work [19:06] We were discussing polling to see who users the docs and how often, etc. [19:06] #topic Desktop: Finding a driver [19:06] knome: Guess you're stuck with it! [19:07] ;) [19:07] will contact people who'll fix the bot! :P [19:07] #topic Desktop: Making poll for Doc Team [19:08] Maybe this could be worked out via the mailing-list and brought up again in the next meeting? [19:09] That's fine with me. Has anyone volunteered to start that discussion? [19:11] i brought it up but it should really come from a desktop person [19:12] Well, it could be all forms of the docs. [19:12] it = poll. [19:12] pmatulis_: There's no reason you can't send an email to the list about it, though. :) [19:12] godbyk: i can send an email, no biggie [19:12] pmatulis_: (I don't think there's are any toes to be stepped on. ;-)) [19:12] #action pmatulis_ Send e-mail to the List about making a poll [19:12] ACTION: pmatulis_ Send e-mail to the List about making a poll [19:12] pmatulis_: Thanks. :) (There are not so many desktop people around, that's where we began the discussion.) [19:12] bbl. [19:12] See ya knome [19:13] GunnarHj: well, there's only one server people around :) [19:13] Moving on... [19:13] ;topic Desktop: Stable release update before 14.04.1? [19:14] #topic Desktop: Stable release update before 14.04.1? [19:14] and if you guys don't mind, i need to pick up a certain small person at a certain school bus stop or a certain person is going to get into a whole heap of certain trouble. be back in 10 for the server part [19:14] Sure, pmatulis_ [19:14] The bot seems to be off. [19:15] My item anyway. [19:15] No, it's normal. It only works like that in the meeting channel. [19:15] Ok.. [19:16] I think we will need it since there will many upgrading from 12.04 LTS to this one. [19:17] I thought that since 14.04 is a LTS, we should make it possible to improve the desktop guide compared to what was shipped in April. But considering the item we just discussed, I'm currently not very inclined to open up ubuntu-docs for trusty. [19:18] Yeah, I agree until we know how many are really using the docs. [19:18] Is there are to do list for desktop docs for 14.04.1? [19:18] godbyk: No. [19:18] godbyk: There are a few bug reports, that's all. [19:19] Maybe a to do list is needed to keep the sub-team on track [19:19] Indeed. That's why a driver would have been nice to have. ;) [19:20] I suggest that we leave it as is for now. [19:20] Maybe I can be the temp one to just get a task list going? [19:21] belkinsa: Are you volunteering as a temporary desktop guide driver? [19:21] GunnarHj, yeah, but I think I might be barking up the wrong tree here [19:24] Actually, as long as we are only talking about fixing known bugs, we don't need a todo list. [19:24] Let's just leave it here until we know the usage of the docs [19:25] +1 [19:25] brb [19:26] Okay. [19:26] We will be skipping to Ubuntu Manual since pmatulis_ is not here yet. [19:26] #topic Ubuntu Manual [19:27] godbyk, I know there was some talk in the mailing-list about the manual but do you have anything to bring up? [19:29] back [19:30] Welcome back [19:30] We skipped your items but they will be next once godbyk gets back. [19:32] Or not. [19:32] #topic Server: Revisit option of moving from XML Docbook to RST Markdown [19:32] Objective: lowering barrier to contribution; a common complaint [19:32] We have lots of time since the Server Guide is only officially published every LTS [19:32] I've already gone over the main machinations to do this [19:32] Primary issue is fixing all the broken stuff caused by the conversion (lots of broken hyperlinks) [19:32] Secondary issue is settling on the appearance/theme; example here: http://serverguide.papamike.ca:8081/ [19:32] Discuss changes in workflow for translators as part of changing to Markdown [19:32] What changes in workflow are needed to create the PDF version. Will pandoc do the job? Effectively YES [19:34] Also is there another other server person here along with pmatulis_? [19:35] nope, just me to my knowledge [19:35] Then I think this could be talked in the list of this team and the Server team, if possible, [19:35] er, ok [19:35] If that is okay with you. [19:36] belkinsa: Why are you so reluctant to use the meeting to talk about things? [19:36] it's fine, i'll send another email :) [19:37] Because we lack people and it's impossible to get anything done now. And we are going to the 120 minute mark. [19:38] The start was fine. [19:38] it's ok [19:38] Ok.. Maybe this will improve when we meet more often. [19:38] I think it will. ;) [19:38] And also I think when we know how many are really using the docs. [19:39] the upshot is that i'm all alone with the server guide in terms of driving/reviewing/committing [19:39] Re using the docs, personally I think that's part of a huge topic. But I'll comment on the list. [19:40] pmatulis_: Upshot? ;) [19:40] and contributions are dwindling to record low levels [19:40] GunnarHj: s/upshot/summary [19:41] ok [19:41] I see. [19:41] I think it's happening in most teams, losing numbers. [19:41] i send emails out and get replies. i take the time to reply, but nothing *ever* comes back [19:41] So basically the situation for the server is just as poor as for the desktop guide. :( [19:41] hence the agenda of moving to a more palatable format, markdown [19:42] And i think is the same for Ubuntu Manual and the wiki. [19:42] I think we should highlight this at the vUDS. [19:43] +1 [19:43] we do every time [19:44] Then let's do it louder. :) [19:44] Might not help. [19:44] hmph. [19:44] it's hard to compete with the likes of google/askubuntu/forums. if readership is low (people tend towards 'gimme the answer'), people do not sense a big importance [19:44] I thought you were gone, knome. [19:44] to be honest, i don't think any markup is the blocker. [19:44] i'm back. [19:45] Welcome back. [19:45] knome, I agree, it's the readership. [19:45] if there aren't people to guide the new contributors with whatever issues they have, they are not going to contribute [19:45] most might have problems or be unsure with even reporting bugs [19:46] I think we are in that cultural sense of just give me the answer. [19:46] knome: you feel that people do not contribute b/c of a lack of support/guidance? [19:47] yeah. [19:47] i don't think people even get far enough to know [19:47] that's part of it [19:47] I tend to agree with pmatulis_ on that one. [19:47] they just look at the procedures and close the tab, or at best go to the wiki instead [19:47] I'm just chaning the topic since we are talking about already. [19:48] #topic Any other Business [19:48] if we think the procedures page is a bit too daunting, rewrite it [19:48] We could. [19:48] tbh, why point any new people to specific procedures anyway? [19:48] Didn't balloons say something about it? [19:48] why not tell them "you can help us and it's easy (lies!)" [19:49] ^-^ [19:49] then point them to a resource where they can talk with people [19:49] anyway, based on the last 4 or so UDSs, people keep mentioning lowering the barrier by replacing XML with something simpler. it is definitely a PITA to deal with [19:49] ...and get enough people to talk with them [19:49] pmatulis_, who people? [19:49] pmatulis_, the people who contribute? [19:49] knome: the people who decide to show up to the UDS sessions or remotely on irc [19:50] And not do any work for the team? [19:50] pmatulis_: Which are probably not prospective contributors. [19:50] or the project. [19:50] if *those* people are saying this, you need to wonder about how the average joe feels [19:50] * knome shrugs [19:51] we recently rewrote the whole xubuntu documentation [19:51] while i converted most of the stuff to docbook, others have done that as well and it has been no problem [19:51] there are enough examples around. [19:51] in the documentation, that is [19:51] interesting. you get enough contributions for xubuntu? [19:51] want to know how something is done? look that up in the source. [19:52] And readership. [19:52] Sorry, guys. I had a phone call and I need to get back to some other work now. I'll read the logs of this conversation later, though. [19:52] knome: look what up in the source? [19:52] We would probably need more of that community spirit as you apparently have in xubuntu. [19:52] belkinsa: Thanks for setting up and chairing the meeting today! [19:52] godbyk, alright/ [19:52] Not a problem [19:52] pmatulis_, look up how it's done. [19:52] knome: how what is done? [19:53] ~xubuntu-doc is 9 members, of which pretty much everybody are either active or were active when we did the rewriting [19:53] pmatulis_, well, anything you want to know... [19:53] knome: about writing XML? [19:53] Look, I think we *need* to first figure out the readership then work on lowering that barrier to entry to change something. [19:53] pmatulis_, "hey, there's a cool infobox there" [19:53] pmatulis_, -> go see the source and copypaste, change the content [19:53] pmatulis_, "i wonder how to add that kind of header" [19:53] pmatulis_, -> go see the source and copypaste [19:54] i understand some people are not interested in doing things like that, or learn low-medium -difficulty things [19:55] but hey... maybe docs is not for them then. [19:55] maybe they prefer giving irc support [19:55] but to my original point... [19:55] i don't think any markup is a problem [19:55] if people are motivated to help, they will [19:55] we can't motivate them to help by telling how easy our markup is. [19:56] there are degrees of motivation [19:56] that's not a marketing point. [19:56] * belkinsa sighs. [19:56] it's cool and nice that it is easy [19:56] I think I want to end this and just have it in a non-meeting setting. [19:56] but it itself won't gather contributors [19:56] belkinsa, why? [19:56] belkinsa, aren't the meetings for discussion? [19:57] Good point but I think it's just you two now. [19:57] And we are at the two hour makr. [19:57] mark [19:57] belkinsa: me too [19:57] Oh, sorry, GunnarHj. [19:57] i imagine the logs for the meeting will be specifically up on the meetings page [19:57] They will. [19:57] regular irc logs arent'. [19:58] Good point. [19:58] or they are, but you really have to dig deep to find anything [19:58] And this discussion is indeed important. [19:58] seems like pmatulis_ went quiet though [19:58] FIne. [19:58] i'm here [19:58] pmatulis_, so if we had a simpler markup, contributors would flood in from doors and windows? :) [19:59] pretend you are a horse [19:59] and you see some obstacles up ahead [19:59] you will tend to shy away from the really talls ones, unless you are a super horse [20:00] now you are saying the markup is the first obstacle [20:00] it shouldn't [20:00] (be) [20:03] knome: Well, you mentioned 9 active contributors to the xubuntu docs. If we had just half of that for standard Ubuntu we could accomplish a lot. [20:04] exactly [20:04] if we presume an interest in contributing, then, yes, the procedures presents an obstacle that the person either overcomes or does not [20:05] the average contributor doesn't mind *any* procedures [20:05] it makes contributing sound like a lot of work [20:06] if they could chat with somebody who explained them some of the procedures while they were asking questions, the barried would be a lot lower [20:06] "oh btw, we have these procedures, but you know half of them already" [20:06] and if people do something "wrong"... what does it matter? [20:06] the procedures should hardly be the starting point [20:08] well, answer me this then. why is the wiki & askubuntu & forums an evergrowing pile of contributions while those that depend on docbook are not? because it's easy as hell, that's why [20:09] they are different kind of projects to begin with [20:09] the point is human interaction [20:09] Well, I for one think the main problem is a lack of people with a true interest in contributing. People with a true interest in contributing are not intimidated by a few procedures. They understand that they are needed. [20:09] except in wikis, where the point is "everybody acan edit" [20:09] the documentation is different by design [20:10] whether it was in docbook or markdown [20:11] pmatulis_: I think I have an answer to why it's easier to make people contribute to askubuntu and forums: By answering there you instantly shows how skilled you are. People like that. :) [20:12] GunnarHj: there is some of that isn't there. good point [20:12] yeah, social acceptance too [20:14] It is a today's culture thing. [20:15] OTOH askubuntu, forums and such are ineffective. The same questions and answers are posted multiple times at multiple places. That's why a core set of docs is a good thing. [20:15] That's why I think we need to figire out readership. [20:15] GunnarHj: you mean inefficient prolly [20:15] Indeed, GunnarHj and that's why I questioned why the need of AskUbuntu/Forums. [20:16] GunnarHj: but, they supply what the people want [20:16] pmatulis_: Yeah, I probably mean inefficient. Sorry. [20:16] GunnarHj: a quick answer to their problem [20:16] pmatulis_: True. [20:16] #link https://lists.ubuntu.com/archives/ubuntu-doc/2013-December/018229.html [20:18] Which leads me to the conclusion that our difficulties in recruiting contributors depends on the fact that there are far too many willing answerers in the forums. :) [20:18] so we are weak at both the readership level and the contributor level (boring anonymous xml drudgery) [20:18] +1 [20:18] Yes. [20:19] difficult for sure [20:21] not to mention the fact that our own doc contributor pool is splintered into wiki.ubuntu.com, help.ubuntu.com/community, help.ubuntu.com, ubuntu manual [20:21] wiki.ubuntu.com shouldn't be documentation. [20:21] Yeah, more for team pages and that such things/ [20:22] if there are documentation bits there, they should be directed at developers and at most, testers [20:22] i stand corrected [20:23] it's likely that there is some documentation there though... if you bump into it, notice it on the channel [20:23] quick check gave me [20:23] https://wiki.ubuntu.com/Kernel/Support [20:23] and it didn't take long [20:24] that's borderline [20:24] anyway, i made my point! [20:24] and the kernel team probably prefers to maintain it there [20:24] I agree with knome. [20:25] they evidently do prefer to keep their documentation there [20:26] anyway, i'm fried. anything else to the meeting? [20:26] The big challenge is that there are few "average Joes" among the Linux users. "Average Joe" does not run his own server per se, and most desktop users are power users who don't mind googling around to get their expert questions answered. [20:26] Nothing. I'm not in the mood to talk about the Wiki sub-team item since no one of the PopularsPages are here. [20:27] I think we just need to try to get monthly meetings going and a poll about readership up. [20:27] And network with developers. [20:29] And sorry for my mood shift. [20:29] I'm going to problematize that readership poll. But let me do so on the list. [20:29] Sure. [20:30] ANd it's pmatulis_ action item to bring it up. [20:30] right [20:30] i'm sure he doesn't mind if GunnarHj brings it up. [20:30] just get things done [20:30] #action GunnarHj Be the back up of pmatulis_'s item [20:30] ACTION: GunnarHj Be the back up of pmatulis_'s item [20:31] ok, I can be backup. :) [20:31] Okay! I'm calling this meeting to an end. Thanks for all for coming. [20:31] #endmeeting [20:31] Meeting ended Wed May 7 20:32:15 2014 UTC. [20:31] Minutes: http://ubottu.com/meetingology/logs/ubuntu-doc/2014/ubuntu-doc.2014-05-07-19.05.moin.txt [20:32] let's try to keep this channel active [20:32] thanks. [20:32] let's keep on doing regular meetings [20:32] pmatulis_, I agree and maybe use meetingology for discussion to log them. [20:32] knome, we will. [20:32] Thanks all! [20:33] bye peeps [20:33] See ya, pmatulis_