Docs Team Meeting Log - Sunday, May 29th - 20:00 UTC

[Jim Campbell]

Hi All,

Here's the meeting log from our meeting this past Sunday. I'll be
following-up shortly with the meeting minutes.

15:06 < j1mc> #startmeeting
15:06 < MootBot> Meeting started at 15:06. The chair is j1mc.
15:06 < MootBot> Commands Available: [TOPIC], [IDEA], [ACTION], [AGREED],
[LINK], [VOTE]
15:07 < j1mc> there's a lot that we can do for this cycle... lots of things
to take care of.
15:07 < Captainkrtek> sure looks like it :-)
15:07 < j1mc> what do you think should be our biggest priorities?
15:07 -!- issyl0 [~issyl0 at freenode/community-coordinator/ubuntu.member.issyl0]
has joined #ubuntu-meeting
15:07 < issyl0> Hi all.
15:08 < j1mc> hi issyl0 - we're just getting started
15:08 < Captainkrtek> j1mc, how about the ondisk- web based topic?
15:08 < j1mc> issyl0: we're taking a look at:
https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Tasks/Oneiricand
discussing priorities
15:08 < Rocket2DMn> j1mc, i think the highest priority is making sure the
docs for oneiric are up to date and available on time
15:08 < issyl0> Brilliant.  I'll just let you know now then that I might
only be around of half of this, but at least I'm here and eager.  :-)
15:08 < Rocket2DMn> we clearly slipped on that for natty
15:08 < j1mc> Rocket2DMn: right - so accurate and on-time docs.
15:09 < Captainkrtek> agreed, I think we need to be done and ready to go on
time
15:09 < j1mc> Captainkrtek: the web-based help is certainly a big issue
15:09 < issyl0> Mmmhmm.
15:09 < Captainkrtek> yeah we need to decide which docs online and which
offline
15:09 < Rocket2DMn> j1mc, what about web based help? html export? wiki?
making translations available?
15:10 < Captainkrtek> yeah thats a good topic to start with
------ figured out how to use the 'topic' command in mootbot.  :)
15:12 < j1mc> [TOPIC] discussing web-based help
15:12 < MootBot> New Topic:  discussing web-based help
15:13 < Captainkrtek> there
15:13 < issyl0> (https://wiki.ubuntu.com/ScribesTeam/MootBot)
15:13 < j1mc> thanks, all :)
15:13 < issyl0> No worries.  Anyway...
15:13 < Captainkrtek> Discuss on-disk vs. web-based help strategy, including
plans for help.ubuntu.com
15:14 < Captainkrtek> I think all topics should be online and only some
essential on disk?
15:14 < j1mc> we need to come up with a plan on this... i've made a simple
mockup of something...
15:14 < j1mc> but i'm sure i've skipped some steps in creating a mockup.
15:14 < j1mc> http://min.us/mvfcYuY
15:14 < MootBot> LINK received:  http://min.us/mvfcYuY
15:14 -!- leoquant [~leoquant at ubuntu/member/pdpc.supporter.active.leoquant]
has left #ubuntu-meeting []
15:14 -!- Daniel0108 [~Daniel010 at unaffiliated/daniel0108] has quit [Ping
timeout: 246 seconds]
15:15 < Captainkrtek> that looks good j1mc
15:15 < j1mc> can you all see that?
15:15 < vtanthropologist> I see it
15:15 < issyl0> Yep.
15:15 < j1mc> one cool thing is that we can output mallard to epub now
15:15 < BravoDeltaLima> i see it
15:15 < Captainkrtek> oh nice
15:15 < vtanthropologist> I like the idea of an epub version
15:15 < Captainkrtek> was talking to some of the Ubuntu-Manual guys, might
do a kindle version next release
15:15 < j1mc> Captainkrtek: cool
15:16 < Captainkrtek> maybe release the help guide as a free kindle book?
15:16 < j1mc> Rocket2DMn: you helped with some of the xslt stuff in getting
help.ubuntu.com ready, right?
15:16 < Rocket2DMn> just a few tweaks to our wrapper around the FOSS ones
for docbook and mallard
15:17 < j1mc> i have a feeling that... for this release, we'll need to focus
on getting a decent foundation in place for help.ubuntu.com
15:17 < j1mc> getting our strategy and infrastructure around it situated
15:18 < j1mc> so that we can have a great site ready for 12.04 (which is an
LTS)
15:18 < j1mc> do any of you have experience with web development?
15:18 < Captainkrtek> nope
15:19 < BravoDeltaLima> nothing past basic HTML and using Wordpress
15:19 < Rocket2DMn> nothing but some basics
15:19 -!- ejat [~fenris at ubuntu/member/fenris-] has quit [Ping timeout: 240
seconds]
15:19 < j1mc> yeah, same here.
15:19 < vtanthropologist> I have a little, but are you thinking of creating
a whole new site?  why not use the existing wiki?
15:19 -!- chrisccoulson [~chr1s at ubuntu/member/chrisccoulson] has joined
#ubuntu-meeting
15:20 < issyl0> Same.  :P
15:20 < issyl0> Really...
15:20 < j1mc> vtanthropologist: good question. help.ubuntu.com kind of
sticks out as a sore thumb compared to the rest of ubuntu.com
15:20 < j1mc> also... have a look at this: http://min.us/mvfcYuY
15:20 < j1mc> oops
15:21 < Rocket2DMn> all the branding and scheme is outdated, we dont have
anybody with the experience to get it up to speed
15:21 < j1mc> http://docs.openstack.org/
15:21 < MootBot> LINK received:  http://docs.openstack.org/
15:21 < issyl0> j1mc: Does responsibility for rebranding that lie with us?
15:21 < issyl0> s/us/the docs team/
15:21 < j1mc> issyl0: i think we'd need to work with the canonical web and
design group, at least to a certain extent
15:22 < Rocket2DMn> to my knowledge, it's been up to each team to update
their own sites, but we should be able to get help
15:22 < j1mc> Rocket2DMn: yeah
15:22 < issyl0> Rocket2DMn: Yeah, I thought so too.
15:22 < Rocket2DMn> i know the forums are still outdated, they are planning
a big upgrade soon though
15:22 < j1mc> one good thing about the openstack stuff is that they host all
of their code on launchpad
15:22 < issyl0> OK.
15:22 < j1mc> and the woman who leads up openstack docs is really good and
super friendly
15:22 -!- ejat [~fenris at ubuntu/member/fenris-] has joined #ubuntu-meeting
15:23 < j1mc> if you check out the browser view of that docs page...
15:23 < Captainkrtek> looks very good
15:23 < j1mc> that's all done with docbook and a gsoc project
15:24 < j1mc> but... we'd need to talk this all out to get it well
integrated, you know?
15:24 < Rocket2DMn> looks like javascript is required
15:24 -!- skaet [~kate.stew at 99-191-111-134.lightspeed.austtx.sbcglobal.net]
has quit [Ping timeout: 276 seconds]
15:24 < issyl0> Oooh, very nice.
15:24 < Captainkrtek> yeah
15:24 < Captainkrtek> that'd be a big jump from the current wiki
15:24 < j1mc> Captainkrtek: we're talking about help.ubuntu.com, which isn't
a wiki right now. (not help.ubuntu.com/community)
15:25 < j1mc> the latter is a wiki, though
15:25 < Captainkrtek> gotcha
15:26 < j1mc> Rocket2DMn: what do you think? there would be a good amount to
plan, but we'll just need to start on it.
15:27 < Rocket2DMn> i think i got lost between the ePub and openstack stuff
- these are differnet right?
15:27 < Captainkrtek> yes
15:27 < j1mc> well, yeah. the openstack stuff would actually be more for the
server guide.
15:27 < Rocket2DMn> and docbook can be converted to be displayed like this?
15:28 < j1mc> like the openstack stuff?
15:28 < Rocket2DMn> yeah
15:28 < j1mc> yes, this whole setup is derived from dockbook sources:
http://docs.openstack.org/cactus/openstack-compute/admin/content/
15:29 < Rocket2DMn> it looks nice, we would have to get our hands on the
transformation tool(s) and then write our own CSS for it to match the Ubuntu
theme
15:29 < Rocket2DMn> I don't have the time or experience to pull that off,
but it could probably be done
15:29 < j1mc> Rocket2DMn: right... the good news is that all of the build
infrastructure and transform tools are already in launchpad.
15:30 < Rocket2DMn> so you said, but i think you're asking the wrong
person.  You really need to bounce this off of Adam
15:30 < j1mc> i will do some initial work on that. i think i could do a test
build of stuff over the weekend next weekend.
15:31 < j1mc> i've talked with him about it already, and robbie williamson
from the server group likes it.
15:31 < Rocket2DMn> ok, sounds good
15:32 < j1mc> [ACTION] Jim to do a test build of server docs using the
openstack build setup
15:32 < MootBot> ACTION received:  Jim to do a test build of server docs
using the openstack build setup
15:32 < j1mc> is there anyone from the group who is interested in working up
plans for help.ubuntu.com
15:32 < j1mc> in general?
15:33 < Captainkrtek> I could in workin with someone else maybe?
15:33 < Captainkrtek> working*
15:33 < j1mc> the server docs are just one part, but we'll need a more
comprehensive look at it
15:33 < j1mc> Captainkrtek: yeah, i think it's too much to do with just one
person
15:33 < Captainkrtek> if someone else is onboard then sure :)
15:34 < vtanthropologist> I'd be happy to help with that
15:34 < j1mc> i would like to work on it, too
15:34 < Captainkrtek> all 3 of us then :-)
15:34 < j1mc> anyone else? i'm sure that we'll get more people later, but
anyone else for now?
15:35 < BravoDeltaLima> I could help out also
15:35  * issyl0 could do.  :-)
15:35 < Captainkrtek> so the whole team ;-)
15:35 < j1mc> heh
15:35 < issyl0> Captainkrtek: That's a good thing!
15:35 < Captainkrtek> yes it is :D
15:36 < j1mc> we're all new to web stuff, so we'll see how it goes.
15:37 < issyl0> Good good.
15:38 < j1mc> we should schedule a time to meet about the website
15:38 < Captainkrtek> yes
15:38 < j1mc> and move on for now.
15:38 < Captainkrtek> next sunday?
15:38 < j1mc> we'll schedule it via doodle?
15:38 < Captainkrtek> sure
15:38 < Captainkrtek> that works too :-)
15:39 < j1mc> [ACTION] set help.ubuntu.com meeting via doodle
15:39 < MootBot> ACTION received:  set help.ubuntu.com meeting via doodle
15:39 < j1mc> anything else on the website for now?
15:40 < j1mc> [TOPIC]Bugs status report
15:40 < MootBot> New Topic: Bugs status report
15:40 -!- ejat [~fenris at ubuntu/member/fenris-] has quit [Read error:
Connection reset by peer]
15:40 < j1mc> Rocket2DMn: anything significant bugs that you could use help
with?
15:40 -!- davidcalle [~david at mar92-14-88-173-198-214.fbx.proxad.net] has
quit [Quit: Ex-Chat]
15:40 < Captainkrtek> I can help with any bugs
15:41 < Captainkrtek> just need to finish some docs review tonight and I can
do any bugs :-)
15:41 < issyl0> Mmmm, bugs.
15:41 < j1mc> mmmm  :)
15:41  * issyl0 likes killing bugs.  :-)
15:41 < Rocket2DMn> nothing off the top of my head
15:41 < Captainkrtek> brb 1 sec
15:41 < Rocket2DMn> anybody is free to post patches or merge requests though
:)
15:42 < j1mc> Rocket2DMn: cool.
15:42 -!- DarkEra [~DarkEra at unaffiliated/darkera] has joined #ubuntu-meeting
15:42 < j1mc> ok - next topic
15:43 < j1mc> we know we need to have docs done on time and accurate this
time...
15:43 < j1mc> and we know we need to work on help.ubuntu.com
15:43 < j1mc> to me, other priorities are making sure we have good help for
all of the default apps
15:44 < j1mc> and building out our 'doc infrastructure' a bit...
15:44 < j1mc> ... stuff like our team wiki, a style guide, documenting our
workflows...
15:44 < Captainkrtek> I will have a merge request tonight
15:44 < j1mc> stuff like that.
15:44 < Captainkrtek> whoops late :P
15:44 < Rocket2DMn> yeah, the wiki always needs work...
15:44 < vtanthropologist> that sounds like a lot of priorities for a small,
part-time team
15:45 < MichealH> j1mc: I could possibly do alot of work on XChat
Documentation :P
15:45 < j1mc> hey MichealH
15:45 < MichealH> Hey j1
15:45 < Rocket2DMn> the wiki is literally managed chaos
15:45 < MichealH> *j1mc
15:46 < j1mc> MichealH: cool. doing xchat docs would be good. i think it is
best to focus on apps that are installed by default on ubuntu, but if you
did docs for xchat, and maybe helped out on docs for another app, that would
be cool.
15:46 < j1mc> [TOPIC] Docs for default apps
15:46 < MootBot> New Topic:  Docs for default apps
15:46 < MichealH> j1mc: May I just ask wat this meeting is? I just walked in
on it, i know ;)
15:46 < MichealH> and there is nothing on the fridge ;)
15:47 < j1mc>
http://live.gnome.org/DocumentationProject/Tasks/ApplicationHelp
15:47 < MootBot> LINK received:
http://live.gnome.org/DocumentationProject/Tasks/ApplicationHelp
15:47 < j1mc> MichealH: you have just joined the documentation team. :P
15:47 < issyl0> MichealH: The Ubuntu Documentation team.
15:47 < MichealH> Cool!
15:47 < MichealH> Im in...
15:47 < j1mc> :)
15:47 < j1mc> that link shows the status of gnome apps' documentation
15:48 < Captainkrtek> MichealH, we only focus on the help guide primarely
15:48 < Captainkrtek> primarily
15:48 -!- ejat [~fenris at 116.197.7.194] has joined #ubuntu-meeting
15:48 -!- ejat [~fenris at 116.197.7.194] has quit [Changing host]
15:48 -!- ejat [~fenris at ubuntu/member/fenris-] has joined #ubuntu-meeting
15:49 < j1mc> basically, if there's an app that you use... if we each just
picked one to work on...
15:49 < j1mc> even if we don't get all of the apps docs updated this release
15:49 < j1mc> we'll be further along
15:49 < MichealH> j1mc: You guys have a IRC?
15:49 < j1mc> we can coordinate with gnome docs team, too
15:50 < j1mc> MichealH: yes - #ubuntu-doc
15:50 < MichealH> Oh wow... Really close to the Channel limit of 120 :/
15:50 < issyl0> MichealH: I'm pretty sure you *don't* need to be in that
many channels.  Even I'm not!  :P
15:51 < j1mc> what do people think about that goal - updating docs for
default ubuntu apps?
15:51 < j1mc> does that seem doable?
15:51 < Captainkrtek> yes j1mc
15:51 < Captainkrtek> I could do a few
15:51 < MichealH> issyl0: 118 channels is alot, It almost does not let my
laptop attach that many....
15:51 < Captainkrtek> I use a ton and know a lot about each
15:51 < Captainkrtek> Im in 20 channels max
15:52 < issyl0> I'm more of an editor than an author, so if any of you need
editing help.  :-)
15:52 < MichealH> j1mc: So its a conmplete re-write of docs or a bug revamp?
15:52 < j1mc> MichealH: it depends. some apps might need a bigger rewrite
than others
15:52 < MichealH> Okies
15:52 < Captainkrtek> j1mc, do we have any new undocumented apps?
15:52 < j1mc> issyl0: that is cool. there are some apps, like banshee or
empathy that can just use some updates
15:53 < issyl0> Yep, I'm up for that.  :-)
15:53 < j1mc> Captainkrtek: that page lists the status of many of the apps'
docs
15:53 < Captainkrtek> thanks
15:53 < vtanthropologist> I'm probably better doing the updates as well if
there are enough to share around
15:53 < Captainkrtek> missed it when I ran for a sandwich
15:55 < j1mc> as a note, there may be some default apps, like software
center, where if you want to contribute docs to that app, you would need to
sign the canonical contributor agreement.
15:56 < j1mc> it's only necessar for canonical-type apps, and you don't have
to work on those apps if you don't want to
15:57 < j1mc> this is kind of a lower priority than the main docs work, but
if we can contribute to this during this cycle...
15:57 < j1mc> that will be good
15:57 < MichealH> j1mc: Wait, what agreement?
15:57 < MichealH> Link?
15:57 < j1mc> sure
15:58  * MichealH thought the CoC was enough ;)
15:58 < j1mc> http://www.canonical.com/contributors
15:58 < MootBot> LINK received:  http://www.canonical.com/contributors
15:58 < j1mc> ^^ only necessary if you want to write docs for the certain
canonical apps, like software center
15:58 < Rocket2DMn> I'd like to see us focus on core efforts that we can
maintain moving forward, rather than working on a bunch of different things
that may be fun but that we can't maintain
15:58 < j1mc> not necessary for writing docs for something like banshee or
gedit
15:58 < Rocket2DMn> then we can ensure that we do those core efforts well
15:59 < Captainkrtek> anyways, next topic?
15:59 < Rocket2DMn> we're happy to help you get started on working with
other projects' documentation though (like upstream Gnome and their apps)
16:00 < MichealH> j1mc: Good to be safe than sorry, though ;)
16:00 < j1mc> Rocket2DMn: good point - we'll need to be careful with our
resources and make sure we don't spread ourselves too thin
16:00 < j1mc> ok - we're up on our hour, so i want to wrap up in the next 5
min
16:01 < j1mc> [TOPIC] Team wiki
16:01 < MootBot> New Topic:  Team wiki
16:01 < Captainkrtek> I can work on updating the wiki this summer
16:01 < j1mc> as Rocket2DMn said, the team wiki needs some love
16:01 < Captainkrtek> yeah haha
16:01 < Rocket2DMn> let's not confuse the team wiki at
https://wiki.ubuntu.com/ with the community docs wiki at
https://help.ubuntu.com/community/
16:02 < Captainkrtek> this wiki https://wiki.ubuntu.com/DocumentationTeam/
16:03 < j1mc> i have done some initial work on recording what all is there
so that we can reorganize it and get rid of cruft
16:03 < j1mc> but that isn't done yet.
16:03 < j1mc> follow-up at the next meeting on that?
16:03 < Captainkrtek> I gotta run, lunch, will continue this is the channel
16:03 < Captainkrtek> in* the channel
16:03 < Captainkrtek> #ubuntu-doc
16:03 < j1mc> later, Captainkrtek
16:05 < j1mc> i can follow-up on the list about that
16:05 < j1mc> ... i know we didn't get to cover everything we might have
wanted in this meeting...
16:05 < j1mc> but any additional comments from folks for now?
16:06 < Rocket2DMn> i guess we better plan to have another meeting soon
16:06  * j1mc nods
16:06 < j1mc> is 2 weeks ok? i will be out next weekend.
16:07 < vtanthropologist> I'm ok with that
16:07 < Rocket2DMn> i'm unsure about my schedule this summer, i'll just have
to play it as we go
16:07 < j1mc> in general, do this time work for folks?
16:08 < j1mc> s/do/does
16:08 < Rocket2DMn> this time usually works out so people in Europe can
attend without it being too late
16:08 < vtanthropologist> it's a good time for me in Sydney
16:08 < j1mc> great :)
16:08 < BravoDeltaLima> works for me
16:09 < j1mc> ok - we'll tentatively set the next one for two weeks from
now, then.
16:09 < j1mc> we can also have some convesations on the ML
16:09 -!- airurando [~
mike at 86-43-181-100-dynamic.b-ras1.pgs.portlaoise.eircom.net] has quit [Quit:
Ex-Chat]
16:09 < j1mc> [ACTION] schedule next meeting for two weeks from today
16:09 < MootBot> ACTION received:  schedule next meeting for two weeks from
today
16:09 < j1mc> anything else?
16:10 < j1mc> #endmeeting
16:10 < MootBot> Meeting finished at 16:10.
16:10 < j1mc> ok - thanks for your time, everyone. i'll send the meeting
minutes out to the ML
16:10 < j1mc> have a good rest of your sunday!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20110531/564e03db/attachment.html>