/srv/irclogs.ubuntu.com/2008/07/24/#ubuntu-doc.txt

HellowHello everyone02:04
Hellowi made a sort of "stub" entry for the Home Folder with a "Needs Love" banner at the top here: https://help.ubuntu.com/community/HomeFolder. If you want to take a shot at completing it, feel free to do so.02:05
meoblast001hello08:54
meoblast001i made a screencast that is sort of a work in progress08:55
meoblast001i made part 108:55
meoblast001but there are some problems08:55
meoblast001i dont know of any other recording programs that "just work" other than recordmydesktop08:55
meoblast001and that writes to ogg08:56
meoblast001nevertheless08:56
meoblast001i think it would be possible to convert this to other formats without much quality loss08:56
meoblast001i have a link to a low resolution copy of my video08:56
meoblast001http://www.fileden.com/files/2007/3/19/904700/Things_Not_to_Do_in_Ubuntu_Pt1.ogg08:56
meoblast001if you like it and want the higher resolution, contact me either in here or by my email08:57
meoblast001meoblast@aol.com08:57
meoblast001i didnt do any beginning slides or exit slides, but if you want me to, i can add them09:00
meoblast001i'll be on tommorro if you need to contact me09:10
jonasbjo1khello!10:36
jonasbjo1kanyone know how to get fop working in Ubuntu?11:34
duncan-nzfop = Fraternal Order of Police?11:39
duncan-nz(that means I have no idea)11:39
wallan1new sentence for https://help.ubuntu.com/community/UserDocumentation: 'If you would like to contribute to these pages, why not check out the WikiToDo and WikiTeam pages?'13:33
wallan1what do people think?13:33
duncan-nzwell, I like the idea. More hands make easy work and all. Especially if we have a good set of templates and so on...13:35
wallan1a different phrasing: 'If you want to contribute to these pages, the WikiToDo and WikiTeam pages are a good place to start.'13:37
duncan-nzwallan1, do you have an opinion on how much SebPages should be used?13:43
duncan-nzon the wiki I mean.13:43
wallan1duncan-nz: SubPages, you mean?13:44
duncan-nzyes13:44
wallan1not really. one thing i have wondered about in the past is how discussions should be handled. should they always be on a subpage, and if so, what should they be called? /Talk? /Discussion?13:46
duncan-nzI like that - why didn't I think of that. I think we should just do that. Decide if it's /Talk (like on wikipedia) on /Discussion13:50
wallan1yeah, i think it's good to have a standard name13:50
duncan-nzI guess it's best if it's CamelCase, maybe PageTalk ?13:57
=== jonasbjo1k is now known as jonasbjork
wallan1i think /discussion is maybe better than /talk - the latter seems a bit vague15:00
duncan-nzNot /PageDiscussion ? It'd be easier to type (yawn)15:02
duncan-nz... yes talk is a bit vague.15:02
duncan-nz... yes 'talk' is a bit vague.15:02
wallan1yeah, PageDiscussion sounds good15:02
duncan-nzBut is it wise to start making subpages all over the place?15:04
duncan-nzthat's the next issue.15:04
duncan-nzI like them and think it gives structure, but some do not.15:05
Old_Soldierduncan-nz: i think talk pages should be "tabbed" but not created until someone writes on them15:05
Old_Soldierjust my 2 cents from working on other wikis in the past15:05
duncan-nzsure, that's easy to do15:05
wallan1it might not be very productive to discuss subpages in general - it's better to talk about specific pages or types of pages15:06
duncan-nzwell, what about making subpages of /Applications then. that's what Allan and I are working on.15:06
duncan-nzwhat do you think are the issues with subpages Old_Soldier ?15:07
duncan-nzthis is not a new issue, but I've never felt I've got a clear picture of why we don't use them on http://help.ubuntu.com/15:07
Old_Soldiergenrally i think subpages are useful for team communication. I used them extensovely when I worked on the team wikis at Gameforge. but in a open wiki they also can become confusing and spam filled15:08
Old_Soldierack i need coffee. too many typos there15:08
Old_Soldieris it a moin issue duncan, or just something that was decided upon by an admin in the past?15:10
duncan-nzI don't know. But I feel like each time I've tried to establish a page/subpage structure I get told ''that's not how we do things here''15:10
duncan-nzI might be wrong, we can just thrash out some guidelines now and try to implement them. This is in the context of this brand new project: https://help.ubuntu.com/community/ApplicationsDocumentationGuide15:11
duncan-nz(I love Wikibooks for structured content, because of it's inherent structure by the way)15:12
wallan1duncan-nz: what kind of content do you plan to put in that page?15:13
duncan-nzI think software documentation by it's nature has several structures to choose between. By repository, menu position, task to name a few.15:13
duncan-nzwallan1, which one?15:14
wallan1https://help.ubuntu.com/community/ApplicationsDocumentationGuide15:14
Old_Soldieri agree duncan. I'm not against subpages. "talk" and discussion' pages are really useful for collaboaration15:14
duncan-nzoh, sorry wrong link...15:14
duncan-nzI meant this project: https://help.ubuntu.com/community/Applications/ProjectHome15:14
duncan-nzas for ApplicationsDocumentationGuide I thought it could have, well I'll paste from the page...15:15
duncan-nz<quote>15:15
duncan-nzThis page will be an extension to WikiGuide specific to documenting applications. For now please follow the WikiGuide.15:15
duncan-nzThere is a discussion started on making some application documentation templates, you'll find some specific ideas there on how to format new pages and improve existing ones.15:15
duncan-nz</quote>15:15
wallan1ok, we should link to the ApplicationsDocumentationGuide from the WikiGuide15:16
duncan-nzSo template(s) for application documentation. If you look around now we have pages based on all kind of structure. "Apps I like", "Alternatives to...", "My uncle says ... is great" and so on.15:17
duncan-nzwallan1, but there nothing there yet.15:17
duncan-nzyou decide.15:17
wallan1well, when there's something on there: ;)15:17
duncan-nzFor example, all the pages on WikiGuide are SubPages15:18
wallan1yeah, i think that's appropriate use of subpages15:19
duncan-nzwallan1, you're completely right. we should scrap the page I made and make a section of the WikiGuide instead.15:19
duncan-nzSo what about these:...15:19
duncan-nz* /Applications/RepoMain/Default15:20
duncan-nz* /Applications/RepoMain/SoftwareAll15:20
duncan-nz* /Applications/RepoMain/Internet/Default15:20
duncan-nz* /Applications/RepoMain/Internet/All15:20
duncan-nz* /Applications/RepoMain/Internet/Firefox15:20
duncan-nz* /Applications/RepoRestricted/SoftwareAll15:21
duncan-nz* /Applications/RepoRestricted/Graphic/XPdf (not sure that's in restricted but...)15:21
wallan1i'm not sure about using that model for individual application pages... firefox should be ~/Firefox, imo15:21
duncan-nzand so on.15:22
wallan1but i can see the value in having an applications guide structured in that way15:22
wallan1one question - how does this relate to how you define an application?15:22
wallan1for example - where would Firestarter go?15:22
duncan-nzFor now I haven't tried to answer that. If one day everything which turns up in the Main Menu is documented then the question can be asked again. But I don't think there is a definative answer.15:23
duncan-nzI guess that's why Launchpad calls then projects.15:23
duncan-nz[then = them]15:24
duncan-nzOld_Soldier, ?15:24
Old_Soldiersup duncan-nz ? I was afk for a little while15:42
duncan-nzOld_Soldier, I was just wondering what you thought of our discussion on structure of subpages.16:08
Old_Soldieri think that the subpage hierarchy works well for organization. i like you used repo in the structure since apps change menus often16:09
duncan-nzwould that be a useful way to organise documentation?16:11
mptI have yet to meet anyone who actually wants "documentation" :-)16:12
mptPeople want answers to their questions16:13
Old_Soldierlol that is si true mpt!16:13
duncan-nzhi matthew.16:13
mpthello hello16:14
duncan-nzWell, if anyone can show me an organisational chart of questions we can use that...16:14
Old_Soldierduncan. wiki organization is always a bone of contnetion16:14
mptduncan-nz, designing the chart is part of the challenge. Card-sorting is one way to do it.16:15
duncan-nzOld_Soldier, i know16:15
Old_Soldiercontention. there are lots of arguments for different "flows"16:15
mptHere's the organization that Microsoft uses: http://windowshelp.microsoft.com/16:15
duncan-nzI get worried if you quote microsoft on the issue of customer support.16:16
duncan-nzbut i will look16:16
mptAnd here's the organization that Apple uses: http://www.apple.com/support/leopard/16:16
mpt(ugh, I can hardly read that grey-on-black)16:17
Old_Soldierlol. actually though with all their faults. MS has good gui and help organzation16:17
duncan-nzI've never once solved a problem with windows by reading their documentation. I have though with Ubuntu.16:18
mptAnd here's a gallery of nearly 700 help systems: http://www.g2meyer.com/gallery/main.php?g2_itemId=287816:18
mpt(those are locally-installed ones, though, not Web sites)16:18
mptOne method of deciding on categories for help pages is card sorting: http://www.infodesign.com.au/usabilityresources/design/cardsorting.asp16:19
duncan-nzI agree that some people want to solve a question. But when I a.) have a problem with a specific application or b.) want to just look around at what's available then: headings like "Why did my widget stop wizzing..." are not helpful16:20
mptRight, so there are broad categories of help pages16:20
mpt* "I have problem X"16:20
mpt* "How do I do Y"16:20
mpt* "Give me a quick overview of feature Z" (less common)16:21
duncan-nzThat would require a million clicks before I found out why the arrow to the right of the text field for VoIP phone numbers in evolution's contacts doesn't work.16:21
mptsommer, search is also important.16:22
mpterg16:22
mpt*So*, search is also important.16:22
duncan-nzFor that type of question I want 'Internet' > 'Mail' > 'Contact'16:22
mptAnd if searching for "voip arrow doesn't work" in Evolution's help doesn't return an appropriate page as the first result, report a bug that it should.16:22
duncan-nz(I have)16:23
Old_Soldiersearch is critical. google search is so much better than the wiki serach though :/16:23
Old_Soldierdoc search seems much better over the past couple releases16:23
duncan-nzWhat about making more use of the MoinMoin Categories as 'tags'?16:23
duncan-nzThen I could better accept a flat wikipage structure. A CategoryMainRepo for example so I can see pages about software in Main.16:24
duncan-nzand CategoryMenuInternet for software found under the Internet part of the main menu.16:25
duncan-nzI think we might be finding a compromise which would solve the different ways of navigating.16:25
duncan-nzone like CategoryHowtoNetwork for network related pages16:26
duncan-nzis this making any sense?16:26
Old_Soldier yeah it makes sense to me. I do see a potential issue  with that : category bloat16:27
duncan-nz(CategoryMainRepo should be CategoryRepoMain for alphabetisation)16:27
duncan-nzwhat is category bloat? how can that cause problems?16:28
duncan-nzevery now and then there is a bit of duplication requiring cleanup - but the cleanup is easy to track because it's there's a category page for all the relevant pages.16:29
Old_Soldiertoo many categories means more chance of mis filing and creates more load on the server come search time16:29
duncan-nzmis filing! at the moment there is _no_ filing!16:29
duncan-nzwell, most pages outside the doc tem are not filed16:30
Old_Soldieryeah the guys from the Bt have been working hard at trying to fix that but it is difficult16:32
duncan-nzBt?16:32
Old_Soldierbeginner team16:32
Old_Soldierfrom the forums. a bunch have joined the doc team and wiki teams and have been working pretty hard16:33
duncan-nzThe biggest help would be a default new page template with some useful comments on. We can only point people in the right direction.16:33
duncan-nzdo they have a project page or something similar?16:33
Old_Soldierhttps://help.ubuntu.com/community/Beginners/Development16:34
Old_Soldieris where we have been staging our efforts16:34
duncan-nzwhy the control "Here is where you can "lay claim" to wiki pages that you want to update or rewrite. Claimed pages will not be touched by other BT members unless the owner gives permission (say, in IRC)."16:35
duncan-nzwould wikipedia have worked with that?16:35
duncan-nzsorry16:35
Old_Soldierduncan it saves  duplicated effort among the team. its an efficiency thing16:45
duncan-nzsure, but why a list and no mention on the actual page concerned?16:45
duncan-nzjust a thought, that's why I've started adding a heading at the end for 'page maintainers'16:46
duncan-nzthat's got me in touch with others who just happen by and want to do something on that page.16:46
duncan-nzan inclusive system instead of a membership based system if you will16:47
Old_Soldiermostly the pages we are fixing are existing pages.16:47
Old_Soldierpage maintainers are great... if the actually maintain the page16:47
Old_Soldierthey16:47
duncan-nzif not they'll soon get tired of being asked about the page...16:47
duncan-nz... and remove their name16:47
Old_Soldierwe try to be informal and not give the impression of being elitists lol16:48
Old_SoldierI guess thats a habit from working the forums16:48
duncan-nzso change it to = Loving this page = and then their WikiNames...16:48
duncan-nzI've made these headers: https://help.ubuntu.com/community/Software/ProjectHome#Page%20banners16:49
duncan-nzmaybe there's something useful in that idea?16:49
Old_Soldiermostly we are trying to work within the existing framework and not ruffle feathers. accomplishing change in an established organization is sometimes a long process16:49
duncan-nznothing original, the idea is direct from Wikipedia.16:50
Old_Soldierhmm i think phil has some banners somewhere too. i remember a discussion on them last month16:51
duncan-nzhave you not noticed how few people are actually subscribed to the pages you work on? It's easy to see which pages are being maintained and which are unloved.16:51
Old_Soldierproblem being duncan-nz  is that people would rather reinvent the wheel instead of fixing a page. That and there are a lot of "one hit wonders"16:56
duncan-nzcan you be more specific?16:57
Old_Soldierthere has been so little long term maintenance on the wiki due to manpower shortages.16:57
duncan-nzLike that. Ok16:57
Old_Soldierlots of people just toss up a page without even checking to see if there is a page up on the topic16:58
duncan-nznot least because there is no structure to find out if ther is a page on that subject!16:58
duncan-nz... that's what I'm on about.16:58
duncan-nzand I don't know why we're using MoinMoin...16:59
Old_Soldieri think moin isn't necessarily the best tool but its what we have17:00
Old_Soldieryeah duncan, i'm with you. Moin isn't as well developed as other wikis and that doesn't help when people are trying to add pages17:01
Old_Soldierhonestly i'm on the fence, i'm almost at a point where i think that posting should be restricted. I know that defeats the whole purpose of community docs, but a temporary ban on posting by the general public would be good if we had a plan to fix the issues and were dedicated to implement the changes17:02
duncan-nzSurely the devs can implement a default template which includes help. And we need to write a macro which makes a list of new pages.17:06
Old_Soldier+1 for macros17:09
Old_Soldierand a default template for new pages would help. i think there are a couple templates out there already, but they aren't easily found17:09
duncan-nzthey're not applied by default.17:12
duncan-nzsee CategoryTemplate17:12
=== Syntux_ is now known as Syntux
Old_Soldieri can kind of nderstand why they arent applied by default but starting a new page should be able to give you a choice of templates? well perhaps that hack would be inelegant or even not possible17:23
Old_Soldierperhaps a default page should have a link to the templares and intructions to copy and paste. approved tempaltes could be stored as imuttable pages17:24
duncan-nzI always get presented with a choice of templates, but the templates are not very relevant.17:25
duncan-nzdo you know how to suppress wikimarkup?17:33
Old_Soldierno duncan i don't recall offhand how to do it, and a cursory search isn't helping. i'll google it17:37
duncan-nzfound it `code to suppress`17:38
duncan-nzwas not easy to find. That was my third attempt.17:38
Old_Soldierah17:38
Old_Soldieryeah the search isnt that great in moinmoin17:38
agyHello All - I need to perform some maintenance on the help.ubuntu.com wiki. This should only take about 15 minutes and the wiki will be placed in read-only mode for this period. The maintenance should modify any pages with doubled up 'Contents' headers in the Table of Contents and should clean up some of the code blocks to render correctly. I plan to start at 18h10 BST.18:07
agyI'm placing the help.ubuntu.com wiki in read-only mode now.18:10
agyMaintenance is complete - wiki is now read-write18:12
sahil_i was just wondering what the progress on the spanish desktop guide is18:31
duncan-nzhave a look at https://help.ubuntu.com/community/SoftwareRepoDefault and https://help.ubuntu.com/community/Software while I break for dinner... please review and comment.18:33
=== kirkland` is now known as kirkland
wallan1duncan-nz: ping22:13
duncan-nzhi allan22:13
duncan-nzI've been busy...22:13
wallan1hey duncan! i can see!22:14
wallan1so you've removed the applications page?22:15
duncan-nzwell, emptied it. All the http://help.ubuntu.com/ and local docs use the term 'software'.22:24
duncan-nzand moved the alphabetic list of software to it's own page to make huc/community/Software free22:25
duncan-nzit has a link doesn't it?22:25
wallan1what, the alphabetical list?22:26
wallan1https://help.ubuntu.com/community/SoftwareAlphabeticIndex22:26
duncan-nzyes22:26
duncan-nzit was on the [[Software]] page22:26
wallan1yeah22:27
wallan1what's happened to the old sound & video page?22:28
duncan-nzbe blunt if you disagree with something I've done. It's quicker than trying to say it nicely.22:28
wallan1i'm just trying to get my head around it ;)22:29
wallan1i haven't made my mind up, to be honest22:29
duncan-nzdon't know. I'll look...22:29
wallan1there are definitely things i would like to rephrase, but that's just a matter of detail22:29
duncan-nztry this: Software > Browse by menu entry > Applications > Sound & Video22:30
wallan1but wasn't there a lot more material on the sound & video page?22:31
duncan-nzFeel free to change the phrasing where you want.22:31
duncan-nzSorry, but I don't remember. There's another Sound & Video page, wait a mo...22:31
wallan1sure, i just want to make my mind up about structural issues first22:31
duncan-nzyou mean this: https://help.ubuntu.com/community/MultimediaApplications22:32
wallan1yes!22:32
wallan1does that have a place in the new schema?22:33
duncan-nzhey, there was a link to that page you were looking for in the Introduction of the sound and video page!22:34
duncan-nzIt's currently under 'See also' as well.22:35
wallan1cool - that page has a lot of good material on it22:35
duncan-nzyes22:35
wallan1duncan-nz: i'22:42
duncan-nzhi22:43
wallan1sorry about that! i was just writing that i'll have a hack at some of this, if that's ok22:43
duncan-nzsure.22:43
duncan-nzA hack at what?22:43
wallan1i like some of the changes... not so keen on others though22:43
duncan-nzof right. go for it.22:43
duncan-nzwell, I'm off to bed soon anyway... !22:44
duncan-nzwhich changes don't you like?22:44
wallan1i'm not keen on browsing by repository22:44
duncan-nzlet me know as you clarify what it is you dislike about them22:44
duncan-nz...neither am I. But using categories it's not hard to do.22:44
wallan1a section on default applications, yes, but i don't think it's a good idea to differentiate between universe and multiverse22:45
wallan1also, 'software' is awefully vague as a heading22:45
wallan1the whole of ubuntu is software!22:46
wallan1to me, it doesn't really mean anything22:46
duncan-nzwell, I didn't choose the word. Ubuntu-doc did.22:47
duncan-nz... and the documentation is for the whole of ubuntu...22:47
wallan1but they don't use it as a heading - they use it within specific sentences where it has meaning22:48
wallan1and they do use applications as well22:48
duncan-nzcan you give me an example?22:52
wallan1most of the official documentation pages use the word applications22:53
wallan1what does a link called software say? what's the idea that it's communicating? software is a generic term, whereas application refers to discrete pieces of software with their own identities22:56
wallan1i know when i've used these pages in the past, the applications link has always been the one that's jumped out22:58
duncan-nza.) https://help.ubuntu.com/ has "Adding and Removing Software"23:01
duncan-nzb.) ... which has "Add/Remove Applications" ...23:01
duncan-nzand "Installing packages without an Internet connection"23:01
duncan-nzand Synaptic Package Manager...23:01
duncan-nzSo as far as I can see there is no clean answer that I can see.23:02
duncan-nzThe terminology is a mess.23:02
duncan-nzbut that not today's probelm in my mind.23:02
wallan1of course, it's all about the semantics - but it's not about what we think, it's about the words that will be meaningful to the users of the wiki23:03
duncan-nzYou're very welcome to to find a pattern we can apply, I'd be happy to apply it.23:03
wallan1applications: https://help.ubuntu.com/8.04/internet/C/index.html, https://help.ubuntu.com/8.04/musicvideophotos/C/index.html23:03
duncan-nzand _we_ know what software _and_ application means. Auntie Martha has only ever heard of these two things called 'Software' and 'Hardware'23:04
duncan-nzI'm not disagreeing with you allan. I'm just saying that I don't have the enrgy to try and find a symantic pattern to apply which lees experienced users will understand. If someone else will I'll be happy to help apply it.23:05
duncan-nzwallan1, that's me for tonight. I'll get a flood of emails on what you've changed when I get on in the morning.23:11
duncan-nzNice working with you my friend. Good to work with people who do as much as they talk.23:11
=== duncan-nz is now known as duncan_zzz

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