/srv/irclogs.ubuntu.com/2010/11/03/#ubuntu-manual.txt

j1mchi all - anyone around?00:17
dutchiedepends what you mean by "around"00:17
j1mchey dutchie00:17
nisshhj1mc, im here, but im busy, whats up?00:18
j1mcwell, i was thinking... i know it might not be tremendously popular, but i think there might be a good rationale for working to merge the tasks of the ubuntu-doc and ubuntu-manual teams00:19
j1mchere's some of the rationale00:19
nisshhgo on00:19
j1mc- ubuntu switching to unity, requiring *a lot* of content to be rewritten (or just written) by both teams00:20
j1mc- all of that content needs to be translated by a finite number of translators00:20
dutchiej1mc: before you get too carried away, can i suggest you write this up into a mailing list post and send it to both teams' mailing lists? better for people who aren't on irc now00:20
nisshhwhat dutchie said00:21
j1mc- there's some risk of documentation syntax fragmentation going on... a lot of different syntaxes are being introduced into the doc world, making it so that people have to learn multiple different workflows and syntaxes to contribute00:21
nisshhj1mc, there is an issue with doing this00:21
nisshhbut i will reply to the ML post, not here00:21
j1mcdutchie: i understand, i will post it to the ml00:21
j1mcjust wanted to bring it up on irc first, so that people didn't feel blindsided by the notion00:22
nisshhwe wouldnt have00:22
nisshhits just discussion until a decision is made after all00:22
j1mc- another reason is that the gnome user docs (which are in ubutu) are being rewritten by gnome for gnome-shell, making much of the gnome user help of limited value to ubuntu00:23
j1mcnisshh: one of the key strengths of the manual team is in making the documentation look good... and you all have done some good work over the last couple of cycles.00:27
j1mci think we could all benefit better if we worked together00:27
j1mci will stop for now, though00:27
j1mcplease just know that i'm not attempting to start flame wars about project differences. i'm just attempting to suggest something that might be helpful00:29
godbykj1mc: There has been some discussion in the past about collaborating more with the docs and learning teams.00:30
godbykUnfortunately, I think everyone got busy and the discussions have stalled out at the moment.00:31
j1mcgodbyk: i know that the "learning center" might be a bit far off. i think we could combine efforts before then, though.00:32
j1mcfor example, this doc is written in docbook for opensuse docs: http://www.novell.com/documentation/opensuse113/pdfdoc/art_osuse_installquick_113/art_osuse_installquick_113.pdf00:33
j1mcit looks nice00:33
godbykThere's more to it than simply the format.  There's a difference in language and structure between writing a book and writing a wiki page or short tutorial.00:36
nisshhexactly00:36
godbykI'm very interested in collaborating as much as possible.00:36
nisshhalso00:36
nisshhthe docs provide general info00:37
nisshhwe do a lot of hand holding in the manual00:37
godbykBut it's not simply a matter of using the exact same text in both places.00:37
nisshhwhich would be tricky anyway00:37
nisshhconsidering the scope of the docs and manual are both different00:37
godbyk(Speaking to the issue of the source format: I would like to explore docbook more.  I think the default docbook-to-pdf converters do a lousy job, but I suspect that's because no one's taken the time to write decent style sheets for the pdf/latex end of things.)00:38
j1mcthat's a fair point, but there are ways to accommodate content re-use.00:38
godbykj1mc: We're definitely interested in content re-use.  It lightens the load for everyone.00:39
j1mcthanks for your time, all. i'll send a note out to the ML's about these items.00:43
godbykThanks, j1mc!00:43
j1mc:)00:43
nisshhcool00:46
=== topo is now known as Guest51450
nisshhaquarius, do you think it would be worth it having a meeting concerning the developer manual later this cycle?12:03
aquariusnisshh, certainly12:06
=== bilalakhtar_ is now known as bilalakhtar
nisshhaquarius, right12:08
nisshhaquarius, btw, are you subscribed to the mailing list now?12:09
aquariusI am indeed12:09
nisshhcool12:09
aquariusalthough I have a batch of them marked unread so that I can read through in detail :)12:09
nisshhok12:09
nisshhits the easiest way for me to announce meetings, etc, so its handy if everyone i need to contact is subscribed to the list12:10
nisshhholy moly12:38
nisshhi just got 15 mails from launchpad notifying me about 1 person who is updating ubuntu-manual bugs like crazy :)12:38

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