/srv/irclogs.ubuntu.com/2009/04/29/#ubuntu-doc.txt

nhandlerI may or may not be at the meeting this weekend. Is it ok if I add an item to the agenda to be discussed?00:02
Kangarooohello.. could ubuntu loco teams template made more  info?00:55
Rocket2DMnhi Kangarooo01:08
Rocket2DMnwhat exactly are you talking about? do you have a link?01:08
mdkenhandler: yes, absolutely08:02
KelvinGardinerHi, what is the correct way to reference a menu item such as File -> new in a wiki page, using → or -> ?14:04
LjLin a minute i'm reverting the latest 3 changes to https://help.ubuntu.com/community/InternetRelayChat?action=diff&rev1=331&rev2=334 - as i don't really think it's appropriate to put such a prominent notice on how to report bugs on an unrelated help page. besides, i really suspect the source of user confusion was not that page but https://help.ubuntu.com/community/Pidgin (which also had that notice added, but which is probably ill-convceived in my opinion)14:32
bencrisfordI'm a little confused about adding images to the community documentation wiki16:02
bencrisfordhow would I go about doing it?16:02
jpdsI'm not sure, but you should be able to add it vi Attachments and then {{image.png}} on the page.16:25
bencrisfordok, i didnt find an attatchments bar :-/16:26
bencrisfordwould i be able to do {{http://www.picture.com/picture.jpg}}?16:26
jpdsbencrisford: https://help.ubuntu.com/community/UserDocumentation?action=AttachFile for example.16:36
jpdsYou have to click: "Show editing options".16:37
bencrisfordooo...  thanks :)16:43
mdkeDougieRichardson: is your playbook on the wiki already? If not, could you upload it to https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation and link it from the "Getting Started" section?21:34
DougieRichardsonmdke: I just changed the page with a link to it on my site, I've got it in a bzr branch on LP - can we integrate it into the teams docs? I'd like to keep it centralised to the team so only one copy needs maintained21:38
mdkeDougieRichardson: the wiki is the right place for it really - we can then maintain the copy that is there21:40
mdkeDougieRichardson: I think it's better to have it on the Ubuntu wiki rather than your site, no?21:40
mdkeDougieRichardson: how is the document created, by the way?21:41
DougieRichardsonmdke: you misunderstand me - I'm not bothered about keeping it on my site but it and the ODF its generated from as well as associated images is in a BZR brancg already21:41
mdkeok, I see21:41
mdkeI think ideally we could keep the odf in a bzr branch, and the published pdf on the wiki21:42
mdkedo you agree?21:42
DougieRichardsonyes entirely happy with that - can we not link directly from the wiki to the copy of the PDF on LP?21:43
DougieRichardsonman the openweek session that's running at the moment has totally dropped into chaos21:45
DougieRichardsonmdke: I've changed it to a link to the copy on LP21:47
mdkeok, I don't know if that link changes or not, let's give it a go for now21:49
philip_how do you guys deal with copyrights and credits? for example, this pdf contains dougie's name... is it common here to do such things?21:49
DougieRichardsonphilip_:mdke knows a _bit_ about law, lol21:50
philip_i'm used to using vcs history as the credits and no inserting author names into the documents themselves21:51
philip_but am not sure what's best, like maybe this decreases peoples motivations to contribute21:52
philip_so sorry DougieRichardson for picking on you, but it's easy for an outsider to do :)21:53
DougieRichardsonphilip_: in the system documentation, we link to the contributers page where everyone's name is.21:54
DougieRichardsonthis being a new idea and me having written it and (without blowing my own trumpet) being a highly vocal entity on the Planet and other places I'm happy to be the POC for this new initiative.21:54
philip_okay, so i'm looking at: https://help.ubuntu.com/9.04/internet/C/disconnecting-wireless.html21:55
DougieRichardsonThis is something that if sucessful, should be under the doc teams control21:55
DougieRichardsonphilip_:I wrote that, lol21:55
philip_is "https://wiki.ubuntu.com/DocumentationTeam" the link you refer to?21:55
philip_i see no author names or links to commit history21:55
mdkewe tend to use "Ubuntu Documentation Team" as the author details for documents21:56
philip_oh, it does link to https://bugs.launchpad.net/ubuntu/+source/ubuntu-docs21:56
mdkein due course if the playbook is contributed to by other members, I'd like to see that there as well, although obviously it's up to Dougie21:56
DougieRichardsonphilip_: No there's a seperate section21:56
mdkein theory copyright in documentation belongs to each person who contributes21:57
DougieRichardsonmdke: its cc so i'm cool21:57
mdkephilip_: this is what we do with docs - https://help.ubuntu.com/legal.html21:57
philip_ah21:58
DougieRichardsonmdke: I propose with the playbooks, once we've settled in to them to move them to the team and change the author to the team21:58
philip_it's a tough topic, something that's been on my mind for about 7 years21:58
mdkeDougieRichardson: yes, it would be good to have the bzr branch under the ~ubuntu-core-doc team21:59
DougieRichardsonmdke: I'm happy with that, I'd like to be POC for it at present if no one has any objections22:00
mdkeDougieRichardson: what's meant by POC? Personally I like people always to go to the mailing list for contacting anything about the team22:00
DougieRichardsonpoint of contact22:00
mdkethat way if someone isn't around, someone else can answer22:01
mdkeI know what it stands for :)22:01
DougieRichardsoni know22:01
philip_i didn't and was looking it up :)22:01
bencrisfordsame :), but im looking up playbook as well?  what is it :S?22:01
mdkeI mean, what do you have in mind in terms of contact - off-list contact?22:02
DougieRichardsonI think that's valid but not until after this weekend's meeting where we have defined and agreed what direction to take with them22:02
philip_they seem like quick guides to me22:02
philip_bencrisford: i think playbook is a term relating to a book of plays, like a sports team might have... specific plays to perform specific tasks on a specific topic22:03
DougieRichardsonphilip_: they are but its part of a bigger push to make contribution as easy as we can22:03
mdkeDougieRichardson: ok... although i don't think anyone can say that it's not a good idea to produce those quick guides - certainly no one has objected on the list22:03
bencrisfordhmm, cool :)22:03
philip_someone asked how to check out something from bzr recently... i am new to bzr so don't feel comfortable but that wiki page should include examples22:04
bencrisfordis bzr like svn?22:05
DougieRichardsonmdke: not off list22:05
philip_this page: https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Repository22:05
bencrisfordah nice :)22:05
philip_should include copy-n-paste examples for ubuntu-docs22:05
philip_currently it assumes we know that bzr magically knows about the ubuntu domain, and that we know what branches are22:06
bencrisfordah it looks alot like svn22:06
bencrisfordwhich im familiar with22:06
philip_a little different, but yeah... it's a version control system (although distributed instead of centralized like svn is)22:07
bencrisfordah ok22:07
bencrisfordim really eager to get involved with the documentation now :D22:07
bencrisfordi have been sitting on the fence for a while, but after docs day i have been inspired :)22:08
philip_see if you can figure out how to check it out :)22:08
DougieRichardsonactually, I have a sheet for Bazaar available22:08
bencrisford:)22:08
bencrisforda pdf sheet?22:08
philip_a cheat sheet / quick guide i reckon22:09
bencrisfordcool =]22:09
DougieRichardsonyes a single a4 sheet22:09
bencrisfordnice, is it available for download at all?22:09
philip_with all these different guides and howtos, just promise to now allow some to get out of date ;)22:10
philip_s/now/not22:10
DougieRichardsonhttp://www.lynxworks.eu/files/BazaarPlaybook.pdf22:10
bencrisfordgreat :D, thanks22:11
philip_this assumes we know what an ADDRESS is22:11
philip_bzr newbies have no clue22:11
philip_branches too22:12
bencrisfordwhich is why this channel is here22:12
DougieRichardsonmdke: I'll change the attribution to doc team at some point over the weekend, can we merge my branch into the teams?22:12
mdkeDougieRichardson: you can just change the branch owner in Launchpad22:12
DougieRichardsonmdke: OK22:12
bencrisfordis CIA-18 a bzr bot?22:13
mdkebencrisford: it can be, but we don't use it at the moment22:13
bencrisfordoh :), i was just wondering22:13
bencrisfordbecause we have a CIA-1222:13
bencrisfordwhich does svn22:13
mdkeyeah, CIA does almost everything22:14
bencrisfordby we i mean spux project22:14
bencrisford#spux (freenode)22:14
philip_one nice thing about github is clicking a button gives you a CIA bot automagically22:14
mdkewe can't really use CIA effectively because we can't install it on LP22:17
mdkealthough if every team member used it, it would work22:17
mdkethe ubuntu installer team does that22:17
mdkephilip_: I'll add some example commands to the Repository page22:20
philip_cool22:21
bencrisfordmdke: what do i have to do to start contributing sysdocs?22:21
bencrisforddo i just submit some patches on LP or what?22:22
philip_pretty sure that is addressed in the guide22:22
DougieRichardsonmdke: what happened with being able to set bug importance?22:22
philip_bencrisford: https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/ has words, then links to "Submitting"22:23
bencrisfordoh cool, thank you22:23
bencrisford:)22:23
philip_btw, last month i blogged about the greatness behind the ubuntu "get involved" page so in case you're interested:22:24
philip_http://blog.roshambo.org/archives/Learning-how-to-help-people-contribute-to-the-PHP.net-Project.html22:24
philip_basically, i love the ubuntu get involved howto specifically for the docs22:24
bencrisfordnice =]22:24
bencrisfordi have been doing the documentation for spux project, which is a ventrilo client for linux22:25
bencrisfordim loving learning all the docbook :)22:25
bencrisfordbrb - bath22:25
philip_and plan to steal ideas from the ubuntu guide while working on: http://teachingopensource.org/index.php/Teaching_Get_Involved22:26
philip_so anyway, enough rambling, i'll let everyone get back to work :)22:26
bencrisford1my internet :'(22:33
bencrisford1i upgraded to jaunty and suddenly my internet doesnt work properly, and my display drivers are broke22:34
bencrisford1not to mention the general performance22:34
mdkeDougieRichardson: I've been going back and forth a bit with the bug guy about it, the bottom line is that people are likely to have to apply to the bug control team in the usual way in order to set bug importance - although i'm trying to convince him to accept a "fast-tracked" procedure22:40
DougieRichardsonmdke:cool, i don't understand why the project driver can't set it within their own packages22:41
bencrisford1i applied to the bug control team like ages ago, i forgot all about returning my application :S22:42
bencrisford1gosh im so forgettful at times22:42
nhandlermdke: Would they be willing to make the core-doc team a subteam of bug control?22:42
nhandlerI know that they do that for MOTU22:43
bencrisford1night22:43
mdkenhandler: I don't think so - unles the core-doc team guarantees to apply their requirements for membership22:48
mdkeDougieRichardson: they are a bit careful about it because members can see private apport bugs which may contain sensitive data22:48
nhandlerYeah, I forgot about that privilege mdke. I guess it is best if they apply separately to the bugcontrol team22:49
DougieRichardsonFair enough22:52
mdkeright, let's get an upload to karmic on the board22:57
nhandlermdke: You haven't done a karmic upload yet? What's taking you so long ;)22:57
Rocket2DMnlol nhandler , nothing has really changed yet, why upload new docs?22:58
mdkenhandler: I should have uploaded last weekend22:58
mdkeRocket2DMn: lots of bugs fixed in this upload, mostly by your good self22:59
Rocket2DMn:)22:59
Rocket2DMni need to start learning how to use bzr22:59
Rocket2DMnguess i should figure out how to check out my own branch and keep it in sync with the main one23:00
mdkeyour patches have been great so far23:00
mdkehaven't you used bzr for them?23:00
Rocket2DMnwell, i kept a local copy of the main branches with bzr23:00
Rocket2DMnfor instance, some users have branches here - https://code.launchpad.net/ubuntu-doc23:00
mdkeah, that's very much optional23:01
mdkeit's for pushing specific fixes and making a merge request23:01
Rocket2DMnyeah i figured, it would be a good learning exercise though23:01
mdkeit's kinda an alternative to posting patches23:01
Rocket2DMnok, well, i'll figure it out at a later time, i need to go make dinner23:02
nhandlerRocket2DMn: I would be glad to show you if you want23:03
Rocket2DMnthanks nhandler , perhaps later this evening23:03
nhandlerSure thing ;)23:04
mdkeawesome23:06
mdkeLaunchpad-Bugs-Fixed: 209530 219972 257337 274845 352313 355008 356933 357344 359288 36355223:06
mdke10 bugs fixed in the first week of karmic23:09
mdkephilip_: I've played with the Repository page a bit, ee if that helps23:39
mdkedamn this keyboard23:40
mdkethis laptop is getting prehistoric23:40

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