/srv/irclogs.ubuntu.com/2015/05/21/#ubuntu-doc.txt

ahoneybuncan I get that link to the github page with the Server Docs in RST>00:07
pleia2ahoneybun: https://github.com/petermatulis/serverguide00:09
ahoneybunthanks pleia200:10
pleia2it's a year old, so lots of bitrot00:10
ahoneybunpleia2: link back for you https://github.com/ahoneybun/kubuntu-manual00:10
pleia2ahoneybun: also converting to rst?00:11
ahoneybunyep00:11
ahoneybungoing to get a talk about my ideas for docs in general00:11
ahoneybunthey align with pmatulis and you00:11
ahoneybunpleia2: I'm guessing the current guide is on LP?00:12
pleia2I dunno about me, while I do agree that consistent tooling is valuable, I'm not the one doing the doc work so I can't really speak for the teams using mallard, docbook, etc00:13
ahoneybunYea I know00:13
ahoneybunjust getting the ball going (trying anyway)00:13
ahoneybunI'm a fan of the "if it works" rule but it could always be better for everyone00:14
* pleia2 nods00:15
pleia2ahoneybun: server guide in launchpad: https://launchpad.net/serverguide00:29
ahoneybunopps yea he gave a link on the github page that I should have saw, sorry pleia200:30
ahoneybunthank you00:30
* ahoneybun should read the README's more00:30
pleia2aha :)00:31
pleia2launchpad has experimental git support now, so it may be valuable to bring it back in if git is a preferred tool00:31
pleia2but I think github was just used as a proof of concept00:32
ahoneybunyes it was for me anyway00:33
ahoneybunplus I don't have my keys setup for LP atm00:33
pmatulishey ahoneybun00:37
ahoneybunhey pmatulis00:37
pmatulisput your ideas down on our next team meeting's agenda if you will be there to speak about them00:38
pmatulisi need to update it (clear out old stuff), but here it is00:39
pmatulishttps://wiki.ubuntu.com/DocumentationTeam/MeetingAgenda00:39
ahoneybunpmatulis: I do have a slideshow if you would like to look at that00:39
pmatulisahoneybun: would it be useful for those attending the meeting to see it? if so, fill in the agenda and send a msg to ubuntu-doc mailing list asking people to look at it before the meeting00:41
ahoneybunpmatulis: just saying it is here: https://drive.google.com/file/d/0B6zAAODZFwQ2SGJCQ1YxRE1IaUU/view?usp=sharing00:42
ahoneybunI'll be using it for a talk at SELF00:42
pmatuliswhat is SELF?00:42
ahoneybunSouth East Linux Fest00:43
ahoneybunUbuntu will have UbuCon00:43
ahoneybunone day event00:43
ahoneybunat the conf00:43
ahoneybunfest00:43
pmatulisok00:43
pleia2ahoneybun: still, please do add it as a discussion item :) presenting it at a conference is not so useful when you haven't formally presented it to the actual teams involved00:44
ahoneybunshould I wait till you clean up that page first?00:44
ahoneybunthe fest is on June 11-13 so we have time00:45
ahoneybunnext meeting is June 100:45
ahoneybun200:45
pmatulisahoneybun: is https://userbase.kde.org/Kubuntu the official docs for Kubuntu?00:48
ahoneybunyea00:48
pmatulisinteresting00:49
ahoneybunit is the same content that is in kubuntu-docs package00:49
pmatulisahoneybun: anyway, like i mentioned to you before, i raised in the past the idea of migrating to markdown for the serverguide but there was no help offered. also, the usual reaction is "what good will this bring? is it worth the trouble?" so you might want to think about it00:52
ahoneybunpmatulis: http://doc.bazaar.canonical.com/latest/en/tutorials/using_bazaar_with_launchpad.html they are using Sphinx lol00:52
ahoneybunI have some benefits on my slides I can bring over00:53
pmatulisspecifically i was gunning for00:53
pmatulishttps://help.github.com/articles/github-flavored-markdown/00:53
pmatulisb/c i am involved in other projects using it00:53
pmatuliswould like to hear about why you chose the markdown you did, among all the alternative00:54
pmatuliss00:54
ahoneybunit has some really nice addons00:54
ahoneybunbut we would prefer LP no?00:54
ahoneybunpmatulis: Sphinx support markdown but I just liked RST00:54
pmatulisok, i get that :)00:55
pmatulishow many people are helping with this kubuntu manual?00:55
ahoneybuntbh I'm the main one00:55
pmatuliswow ok00:55
ahoneybunsomeothers have helped00:55
ahoneybunbut I have np being the only one00:56
ahoneybunjust need others to brainstorm00:56
pleia2hopefully simplifying the format will help gain contributors00:56
pmatulisso same problem over here then, lack of people-power00:56
ahoneybunyes that is main goal for me00:56
ahoneybunother then having the docs/manual being easy to access and in many formats00:56
ahoneybunpmatulis: I'm up for helping you if I can00:57
pleia2formats aren't an issue for ubuntu and xubuntu since the current docs formats support output to lots of things00:57
* ahoneybun tries to upload the manual to LP00:57
ahoneybunpandoc supports to A LOT00:57
pmatulisthere are people who disagree that the format is a detriment to participation00:57
ahoneybunSphinx has a few as well00:57
ahoneybunhaving it somewhere easy to find is key I think00:58
ahoneybunand get00:58
pleia2pmatulis: indeed, barrier to entry isn't everything, could just be standard lack of volunteers :\00:58
ahoneybunI do not work on the Ubuntu Manual as I hate the way it is layed out00:58
ahoneybunalso LaTeX makes my head hurt00:58
pleia2they seem to really love it00:59
ahoneybunLaTeX?00:59
pleia2I have conference things to run off to, have a nice evening :)00:59
pleia2yeah00:59
ahoneybunit is ugly as sin01:00
ahoneybunto me anyway01:00
ahoneybunpmatulis: even if they stick with LaTeX you have shown that pandoc can convert very well01:00
pmatulisahoneybun: i think i've given you the context around here. please do be prepared to discuss. and a msg to the m/l will be a good idea telling people about your initiative. the docs project is fairly sleepy and sometimes *everyone* forgets to come to the meeting01:02
* ahoneybun throws a stick at LP01:03
ahoneybunI'm off for the night01:04
ahoneybunthanks pmatulis and pleia201:04
pmatulisahoneybun: welcome01:23
=== aaron is now known as Guest69666
=== aaron is now known as Guest32030
=== aaron is now known as Guest90122
=== aaron is now known as Guest25522
=== Guest25522 is now known as ahoneybun
=== aaron is now known as Guest71030
=== Guest71030 is now known as ahoneybun
=== aaron is now known as Guest7210
=== Guest7210 is now known as ahoneybun
=== aaron__ is now known as ahoneybun
evertheylenHi guys, I found an error in a page on the wiki I cannot edit.20:55
evertheylenhttps://help.ubuntu.com/community/lighttpd20:56
evertheylen` The root of the web server is at "/var/www/" ` --> should be "/var/www/html"20:56
* ahoneybun looks21:08
=== ChanServ changed the topic of #ubuntu-doc to: Ubuntu Documentation Team - home: https://wiki.ubuntu.com/DocumentationTeam | mailing list: https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc | next meeting: June 2, 2015 @ 16:00 UTC in #ubuntu-meeting-2
ahoneybunfoixed21:11
ahoneybun*fixed21:12
=== aaron is now known as Guest8727
=== Guest8727 is now known as ahoneybun
=== aaron__ is now known as ahoneybun
=== aaron is now known as ahoneybun

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