== Meeting information == * #ubuntu-doc Meeting, 07 May at 19:05 — 20:32 UTC * Full logs at [[http://ubottu.com/meetingology/logs/ubuntu-doc/2014/ubuntu-doc.2014-05-07-19.05.log.html]] == Meeting summary == === Desktop: Finding a driver === The discussion about "Desktop: Finding a driver" started at 19:07. === Desktop: Making poll for Doc Team === The discussion about "Desktop: Making poll for Doc Team" started at 19:07. * ''ACTION:'' pmatulis_ Send e-mail to the List about making a poll === Desktop: Stable release update before 14.04.1? === The discussion about "Desktop: Stable release update before 14.04.1?" started at 19:14. === Ubuntu Manual === The discussion about "Ubuntu Manual" started at 19:27. === Server: Revisit option of moving from XML Docbook to RST Markdown === The discussion about "Server: Revisit option of moving from XML Docbook to RST Markdown" started at 19:32. === Any other Business === The discussion about "Any other Business" started at 19:48. * ''LINK:'' https://lists.ubuntu.com/archives/ubuntu-doc/2013-December/018229.html * ''LINK:'' https://wiki.ubuntu.com/Kernel/Support * ''ACTION:'' GunnarHj Be the back up of pmatulis_'s item == Vote results == == Action items, by person == * GunnarHj * GunnarHj Be the back up of pmatulis_'s item * pmatulis_ * pmatulis_ Send e-mail to the List about making a poll * GunnarHj Be the back up of pmatulis_'s item == Done items == * (none) == People present (lines said) == * belkinsa (88) * knome (75) * pmatulis_ (47) * GunnarHj (36) * godbyk (11) * meetingology (9) * balloons (1) == Full Log == 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 19:05 Available commands: action commands idea info link nick 19:05 #chair belkinsa 19:05 Current chairs: belkinsa knome 19:06 godbyk, and pmatulis_ 19:06 #unchair knome 19:06 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:07 heh, the #unchair command doesn't work 19:07 We were discussing polling to see who users the docs and how often, etc. 19:07 #topic Desktop: Finding a driver 19:07 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:12 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 * meetingology 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:13 bbl. 19:13 See ya knome 19:13 GunnarHj: well, there's only one server people around :) 19:13 Moving on... 19:14 ;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:15 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:19 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:20 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:22 GunnarHj, yeah, but I think I might be barking up the wrong tree here 19:25 Actually, as long as we are only talking about fixing known bugs, we don't need a todo list. 19:25 Let's just leave it here until we know the usage of the docs 19:26 +1 19:26 brb 19:26 Okay. 19:26 We will be skipping to Ubuntu Manual since pmatulis_ is not here yet. 19:27 #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:30 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:33 Objective: lowering barrier to contribution; a common complaint 19:33 We have lots of time since the Server Guide is only officially published every LTS 19:33 I've already gone over the main machinations to do this 19:33 Primary issue is fixing all the broken stuff caused by the conversion (lots of broken hyperlinks) 19:33 Secondary issue is settling on the appearance/theme; example here: http://serverguide.papamike.ca:8081/ 19:33 Discuss changes in workflow for translators as part of changing to Markdown 19:33 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:36 er, ok 19:36 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:39 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:40 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:41 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:42 So basically the situation for the server is just as poor as for the desktop guide. :( 19:42 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:43 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:45 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:45 I thought you were gone, knome. 19:45 to be honest, i don't think any markup is the blocker. 19:45 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:46 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:47 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:48 I tend to agree with pmatulis_ on that one. 19:48 they just look at the procedures and close the tab, or at best go to the wiki instead 19:48 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:49 Didn't balloons say something about it? 19:49 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:50 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:51 * 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:52 interesting. you get enough contributions for xubuntu? 19:52 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:53 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:54 pmatulis_, "i wonder how to add that kind of header" 19:54 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:56 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:57 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:58 Oh, sorry, GunnarHj. 19:58 i imagine the logs for the meeting will be specifically up on the meetings page 19:58 They will. 19:58 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:59 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 20:00 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:01 (be) 20:04 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:05 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:10 the documentation is different by design 20:10 whether it was in docbook or markdown 20:12 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:13 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:17 #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:22 wiki.ubuntu.com shouldn't be documentation. 20:22 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:26 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:27 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:28 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:30 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:31 #action GunnarHj Be the back up of pmatulis_'s item 20:31 * meetingology 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:32 #endmeeting Generated by MeetBot 0.1.5 (http://wiki.ubuntu.com/meetingology)