/srv/irclogs.ubuntu.com/2009/08/14/#ubuntu-doc.txt

dhillon-v10Rocket2DMn: how are you?20:41
Rocket2DMnhi dhillon-v1020:43
Rocket2DMnim well, thank you, how are you?20:44
dhillon-v10Rocket2DMn: good20:44
dhillon-v10Rocket2DMn: I got an email from phillbull regarding Mallard, so can how can I start working with it20:44
Rocket2DMndhillon-v10, i haven't a clue about Mallard, sorry20:45
Rocket2DMnwhat is that you want to do with it?20:45
dhillon-v10"We're also looking for writers to work on rewriting the GNOME documentation using a new format called Mallard [2]. This is going to be an extremely big job, but would be a great way to learn about technical writing. "20:46
dhillon-v10Rocket2DMn: that's what I got from phillbull20:47
Rocket2DMndhillon-v10, that sounds like work that would be done upstream at Gnome, not in Ubuntu yet20:47
Rocket2DMnThere was discussion at the last team meeting about converting our ubuntu-docs stuff to Mallard to align with Gnome, but not yet20:48
dhillon-v10Rocket2DMn: well that was the email I got and how can i join the meetings here...20:48
Rocket2DMnMeetings here will be announced on the mailing list20:48
Rocket2DMnI don't know anything about Gnome operations upstream though20:49
dhillon-v10Rocket2DMn: I am subscribed to the mailing list but I don't get any email regarding meetings, I check them all20:50
Rocket2DMnwell we don't have meetings very often, so it's not surprising that you haven't seen any meeting announcements20:51
Rocket2DMnif you're on the mailing list, you'll see any discussion about planning the next meeting when it comes time20:51
dhillon-v10Rocket2DMn: Alright, so I am working on modifying wikis and adding some new pages and such, any thing else you would have me do...20:52
Rocket2DMnLol, I'm not in charge here dhillon-v10 :)20:53
Rocket2DMnyou can email the list to ask for more suggestions if you want20:54
dhillon-v10Rocket2DMn: Oh, I thought you were, nevermind20:54
dhillon-v10:)20:54
Rocket2DMnno, mdke is the doc-team lead20:54
Rocket2DMnHowever, if you want wiki work, have a look at the Tag page - https://help.ubuntu.com/community/Tag20:54
Rocket2DMnanything tagged for Content Cleanup, Style Cleanup, or Expansion need work20:55
dhillon-v10Rocket2DMn: I guess I should say hi to him too...  :)20:58
Rocket2DMnheh, indeed20:58
dhillon-v10mdke: hi, how are you?20:58
Rocket2DMnhe is marked as away right now, so it's unlikely he'll respond, but if you stay signed on, he will respond to any notes you leave for him20:59
dhillon-v10Rocket2DMn: how do you find that out????20:59
Rocket2DMnHis name is gray on the user list21:00
Rocket2DMnI'm using Xchat, if you're using something else, you may have to check somewhere else21:00
dhillon-v10Rocket2DMn: oh I use pidgin, it comes with ubuntu so ...21:01
dhillon-v10Rocket2DMn: I will talk to you later, thanks and bye21:02
Rocket2DMnsee ya21:02
mdkedhillon-v10: hi, what can I do for you?21:40
dhillon-v10mdke: sorry to make you wait, just 2 mins..  thanks21:41
mdkeI am on and off irc myself21:41
mdkeso no probl21:41
Rocket2DMnhey mdke , what would you like to do with this page - https://help.ubuntu.com/community/WikiCleanupProposal21:47
mdkehmm21:48
Rocket2DMnit's rather old21:48
mdkeI'd probably say let's nuke it and keep working on the latest proposal from Marc and Andrew21:49
Rocket2DMnalright21:50
Rocket2DMnalso, what about pages like this - https://help.ubuntu.com/community/WikiGuide/PageDiscussion21:50
Rocket2DMnI'm not sure if we want to keep PageDiscussion pages or not.  Either way, there are many with lots of old content21:50
mdkeI'd say not, they aren't helpful for discussing - i much prefer the mailing list21:51
Rocket2DMnyou want to delete all PageDiscussion pages?21:51
dhillon-v10mdke: Alright so I am back, I wanted to know about mallard21:52
mdkeI wouldn't say all, because they might have useful material in them. if so I think we should think about how to keep them21:52
mdkebut those without useful material, yes21:53
mdkedhillon-v10: ok. Are you broadly familiar with the difference between Ubuntu and Gnome?21:53
mdke(not sure what your level of experience is with the Ubuntu ecosystem)21:53
dhillon-v10mdke: yah well gnome is the desktop environment but ubuntu is the whole operating system21:54
mdkeright21:54
mdkethe Gnome project has its own documentation team21:54
dhillon-v10mdke: alright21:54
Rocket2DMnsounds good mdke , i know there are some with useful content. or that direct users in how to update some pages.  I'll put PageDiscussions on my radar and delete those that aren't helpful.21:54
mdkethey are currently working on a rehash of their documentation to make it easier for distributions like Ubuntu to use it21:54
dhillon-v10mdke: Can I help with that?????21:55
mdkepart of that rehash is a new document language which they will use to write their documents in21:55
mdkeit's called Mallard21:55
dhillon-v10mdke: you are smart :)21:55
mdkesimilar to html, if you are familiar with that21:55
dhillon-v10mdke: I am a programmer, working with computer vision21:55
mdkedhillon-v10: I haven't said anything smart so far ;)21:55
Rocket2DMnmdke - delete the two pages I linked you to?  I only ask b/c they are doc-team pages.21:56
mdkeyou can definitely help contribute to the Gnome documentation team, if you like21:56
mdkeRocket2DMn: yes, I think so (if you agree)21:56
mdkedhillon-v10: the Gnome documentation team has its own mailing list and irc channel so the first step is to join those21:56
dhillon-v10mdke: well for the most part computer vision is my area of work, is there anything other than wikis that needs to be worked upon21:56
dhillon-v10mdke: I know that and I have joined it21:57
Rocket2DMni do agree mdke , but i'm pretty liberal with the delete button, so i just wanted to make sure :)21:57
mdkeRocket2DMn: cool21:57
mdkedhillon-v10: what do you mean by computer vision?21:57
dhillon-v10mdke: It is the art of making computers see what we humans do using solid mathematics21:57
mdkeok21:58
mdkeif you'd like to contribute to Gnome documentation, I'd say just contact the mailing list and ask how you can help21:59
mdkeif you'd like to contribute to Ubuntu documentation, we'd love that too :)21:59
dhillon-v10mdke: I am working on some wikis is there anything else21:59
mdkethe thing to do there is to visit https://wiki.ubuntu.com/DocumentationTeam and read on :)21:59
mdkethere should be plenty of information there about how to find things to work on, but feel free to ask if you have any other questions22:00
dhillon-v10mdke: I have been guided by Rocket2DMn and I have read some pages there as well22:00
mdkegreat22:01
dhillon-v10mdke: so what should I do now?22:02
mdkedhillon-v10: that's kinda up to you, it depends on what you are interested in22:02
dhillon-v10mdke: What about system documentation22:03
mdkeyes, plenty to do there22:03
mdkeso22:03
mdkethere is likely to be plenty to do in updating the documentation to the new features in karmic22:03
mdkefor example, the move to empathy as an irc client, and I'm sure there are plenty of other user visible changes22:04
mdkeanother thing we are missing is documentation for connecting to bluetooth devices, if you have had any experience with that on Ubuntu22:04
dhillon-v10mdke: what should I do to get to those pages and write out what I can22:05
mdkeyou'll need to read the system documentation pages quite carefully, those will tell you how things work and where to get copies of the documents22:05
mdkethere is no substitute for reading those pages, but it's quite easy to pick up22:05
mdkeI'm referring to the wiki pages at https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation22:06
dhillon-v10mdke: I had a look at those pages before but I don't see a ubuntu karamic branch22:09
mdkewhere?22:09
dhillon-v10mdke: sorry I wasn't specific enough:  https://code.edge.launchpad.net/ubuntu-doc-project22:11
mdkeyeah, that's a bit confusing actually22:12
mdkeit's here - https://code.launchpad.net/~ubuntu-core-doc/ubuntu-docs/ubuntu-karmic22:12
mdkeI'll see if I can clarify the page, unfortunately Launchpad is a bit unhelpful about how it presents the branches22:12
dhillon-v10mdke: Please don't get me wrong but are you sure that's the right page...22:13
mdkeyes22:13
dhillon-v10mdke: alright I will get the branch and then how do i proceed22:14
mdkewhat do you want to do?22:16
dhillon-v10mdke: Update the documentation for various packages22:17
mdkeyou need to identify some material that needs to be changed, change it, and then submit a patch as described in the Editing, Checking and Submitting pages on the wiki22:19
dhillon-v10mdke: Oh that was simpler than I thought22:20
dhillon-v10:)22:20
mdkesee how you go22:22
dhillon-v10mdke: do you recommed this work to be done under a virtual machine or not22:23
mdkeediting the documentation doesn't have to be at all22:23
mdkebut trying karmic out is probably best done in a virtual machine22:23
dhillon-v10mdke: alright thanks and nice talking to you22:25
mdkedhillon-v10: same, catch you soon22:25
dhillon-v10bye22:25
* mdke notices that doc.ubuntu.com is still working on jaunty22:26
mdke*cough*22:26
Rocket2DMnman every time I go to clean up stuff on the wiki, I find another set of things that need to be done22:28
Rocket2DMnlol22:28
mdkehah22:28
mdkeyou're doing awesome work on the wiki22:28
mdkethanks for that22:29
Rocket2DMnsure thing, i would just like to see some order on the wiki.  I think it would be a lot more useful that way22:31
Rocket2DMnrequires a lot of pruning and constant upkeep22:31
* mdke nods22:31
Rocket2DMnthe summer of documentation has been going well, people are putting out some great work - https://help.ubuntu.com/community/Beginners/Development22:32
mdkenice :)22:33
mdkewe should have a page like that for the whole team, do you think it would work?22:33
Rocket2DMnI'm not sure if it would work, I think it's been tried before, hasn't it?22:33
mdkeit's a damn site better than DocumentationTeam/Wiki/Tasks22:34
Rocket2DMnI basically took pages that were Tagged or had older Categories - ones I thought BT members should be able to handle, and just listed them for covenience22:34
mdkeit looks like it's been a great success22:35
Rocket2DMnyes, I get quite a few requests for ideas about "what should i work on next", i havent always been able to keep up22:35
* mdke nods22:35
mdkethe age old problem really22:35
Rocket2DMnhowever, directing users to the doc-team pages is best.  Members can get their hands dirty with stuff I start them off with, then are more comfortable and can jump further into the doc team22:36
Rocket2DMnat that point they can find their own way22:36
Rocket2DMnthat's the whole point really22:37
mdkeright but we need to keep the docteam pages updated with current tasks22:37
mdkenever easy22:38
mdkeI like the list you've done there22:38
Rocket2DMnyeah, it's tough to stay on top of it.  When I finish some other tasks I have on my list, I'll see if I can come up with a proposal for a similar method for the whole doc-team.22:39
mdkeI guess the tag system is the way forward22:40
mdkeI don't know whether that is effectively used or not, but it should work in theory22:40
Rocket2DMnthe biggest problem I've had with the tag system is that when you want to see the list, it can only show 10 per page22:41
Rocket2DMnperhaps there is a simple way around that which I haven't discovered.  regardless, it's not user friendly in that sense22:42
mdkeI wonder if we can fix that22:42
mdkesurely we can fix it22:42
Rocket2DMnhopefully it's as simple as adding a parameter to the URL22:43
mdkeRocket2DMn: we could create pages like this one: https://help.ubuntu.com/community/Tag/Unsupported/List22:45
Rocket2DMnmdke, that is brilliant, why didn't I think of that!22:46
mdke:)22:46
Rocket2DMnthe only thing better would be to have the ability to separate the listings by letter, not sure if the search function can produce output that complex though22:47
Rocket2DMneither way, that is much more user friendly since it is all in one place22:47
mdkenot as far as i know, but feel free to look into it :)22:47
Rocket2DMnthe TitleIndex page does it, perhaps there is a way to harness it's capability in search queries22:49
mdkepossibly22:49
mdkeif you fancy creating a new more of those pages and linking to them on the "Tag" page, go ahead. Otherwise I'll try and do it over the weekend22:49
mdkebed for now22:49
Rocket2DMnI'll put it on my radar, but you can go ahead and do it, you'll probably get to it first22:50
mdkecool, will do22:50
mdkecya22:50
Rocket2DMnalright, good night22:50

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