/srv/irclogs.ubuntu.com/2013/12/06/#ubuntu-doc.txt

=== jono is now known as Guest52213
=== Tribaal_ is now known as Tribaal
knomehello belkinsa, slickymaster, pleia219:59
pleia2:)19:59
belkinsao/19:59
belkinsaI still need to the scrollback19:59
knomewell basically20:00
knomehttps://help.ubuntu.com/community/FrontPageRefresh20:00
knome"what information should we have on this page, where should we link from this page and how to format it (and in which order)"20:01
cprofitthello knome20:02
slickymastero/20:03
knomehey cprofitt20:03
belkinsaHey there cprofitt20:03
slickymasterhi cprofitt20:03
belkinsaThe scrollback if any one wants to know what's is the issue: http://paste.ubuntu.com/6531375/20:04
knomesince i have mostly only discussed with slickymaster, let me briefly introduce what my interest is20:05
belkinsaYes, that would be a good idea.20:05
knomesimply put, i want to make the front page *look* better20:06
knomei'm not familiar with the scope of the content on the wiki20:06
knomei've just moved topics from the current front page to the new front page20:07
knomei don't know if the signpost is a pet project of somebody20:07
knomeif you think it's used a lot, let's keep it, but let's make it look better20:07
knomeif it's not used, please by all means refactor it (and ask me to help), as long as we make the new thing look better20:07
belkinsaIt's hard to say if it's being used without seeing the stats of it20:07
knomesure20:07
knomefrom my point of view, the signpost is confusing20:08
belkinsaI agree.20:08
knomeand it seems to do assumptions that aren't necessary true20:08
knomefor example, it assumes all power users want to become programmers20:08
knomenice idea, but...20:08
knomeso back to the front page refresh itself;20:08
pleia2heh, "scope" is "everything anyone feels like writing about ubuntu that is not in the scope of the official docs"20:09
knomei want to make all usable resources more available for the users20:09
belkinsaAnd have it on the front page of the wiki?20:09
knomepleia2, sure, but what i meant is that i don't know how heavily the wiki leans on security, business environment or hardware issues20:09
pleia2so it's not actually possible to have an "an exhaustive list of all topics covered in this wiki"20:09
knomeor how important those might or might not be20:09
pleia2knome: I don't think anyone does, people write about all kinds of things, importance varies based on what you need ;)20:10
knomemy point is20:10
belkinsaDuh...yeah, I think it's possible to do it.20:10
knomei'm only interested in the looks.20:10
knome(not only, but think it that way, and you're close)20:10
knomethat naturally does lead to other considerations20:10
knomelike "is this information formatted nicely, and should we move the content around to make it better"20:11
knomeso if i'm asking whether something is useful or not, it's because i would like to present it in a more sane way for the users20:13
belkinsaKnome, I agree with what you talking about and I think the work you have already done to the page is what is needed.  Just focus on the important topics that new/old users would need.20:14
knomefor example, i think the signpost could be mostly split into "other resources" (which are scattered in other places as well, even in the front page "see also") and "ubuntu events" (which is more or less badly covered in the wiki, so could be dropped for the moment)20:14
belkinsaI like this idea.20:15
knomethat being said, see  https://help.ubuntu.com/community/FrontPageRefresh  now and find the other resources box in "more resources"20:15
knomeyes, it links to a page that doesn't exist, but it should be relatively easy to build that page20:16
knomeand extend as more resources are found in the wiki20:16
knomeand ultimately i don't think that should be an exhaustive list of any resource ever available20:16
knomejust the biggest and most useful ones20:16
belkinsaYes, it can.  Maybe using a tag, if that's allowed, to build a list.20:17
knomethe signpost lists #ubuntu-motu20:17
knomei don't know how useful that is from the bat to anyone who reads the wiki20:17
belkinsaI agree.20:17
knomerather try to point to #ubuntu and #ubuntu-devel (maybe)20:17
knomethose channels can point to right resources20:17
belkinsa+120:18
belkinsaOh, by the way, welcome to the team, knome.20:18
knomethey also point to ubuntu beginners20:18
knomeis that team even active?20:18
knometa ;)20:18
belkinsaI don't know.  I think they are disbanded.20:19
belkinsaCheck in the channel?20:19
knomethat was a rhetoric question20:19
knomeany listing is prone to get outdated20:19
knomeso let's try to keep them short20:19
belkinsaRIght.20:20
* slickymaster thinks that that is is closed for awhile now20:20
knomeunless it's something that's dynamically built from a resource that's always up-to-date20:20
belkinsaYeah, that's the problem the wiki.20:20
belkinsaeagles0513875, you felt this issue of outdated info, right?20:21
slickymasterthere are quite a few pages with outdated info20:21
belkinsaAnd that I want I somewhat brought up on the mailing list.20:22
eagles0513875belkinsa: correct20:22
eagles0513875whats up20:22
eagles0513875i think versioning of the docs would really help20:22
slickymastera just a small amount of them have been tagged with the proper Tag/NeedsUpdating20:22
eagles0513875ill be back to discuss this shortly20:22
belkinsaknome is another person who thinks the wiki needs major work on20:22
eagles0513875hey knome20:23
belkinsaScrollback: http://paste.ubuntu.com/6531375/20:23
eagles0513875belkinsa: ill read it now once i get things started at work20:23
knomehello20:23
belkinsaOkay20:23
knomehttps://help.ubuntu.com/community/OtherResources20:23
belkinsaI think the problem of outdated-ness could be fixed if we had someone that could be able to e-mail developers to give some docs on the new freatures.20:24
belkinsaWow, the favours list needs to have all of the favours20:24
knomeyeah, that's just what i gathered from the front pag20:25
knomeand we need to format that page in a better fashion as well20:25
belkinsaSo, this page a sandbox page?20:25
knomeyep20:25
belkinsaYes, we do.20:25
knomeor, a draft really20:25
belkinsaOkay.20:25
eagles0513875knome: belkinsa i really think versioning would help and i think alfresco would come in handy20:25
knomeonce we get some amount of the most used resources listed, let's format that20:25
eagles0513875as it has its own built in wiki20:25
knomeand start using it20:25
belkinsa+120:26
knomeeagles0513875, that's yet another tool though, right?20:26
belkinsa(to what knome said)20:26
eagles0513875yes knome20:26
eagles0513875i woudl need to create a juju charm for it if we want to deploy it20:26
knomewhy wouldn't we try to fix what we have now20:26
eagles0513875knome: its too much of a mess right now20:26
eagles0513875one perk with alfresco20:26
knomethe technology isn't the problem20:26
eagles0513875one framework can have multiple projects20:26
knomethe people are the problem20:26
eagles0513875knome:20:26
eagles0513875maybe so20:26
eagles0513875but we have version control of the docs20:27
eagles0513875and images20:27
knomei don't know how that would help20:27
eagles0513875so if we update a document and its not right we roll back to the previous version20:27
knomeif the docs are outdated, they are outdated20:27
belkinsaYes, people are the problem.  And I think we also have a major disconnection with other teams.20:27
eagles0513875that is on hold20:27
eagles0513875i think though duplication of the official wiki should be done20:27
eagles0513875official docs i mean20:27
eagles0513875and the copy of them be extended further20:27
knomeactually, i think the community wiki shouldn't cover those issues in the official docs20:28
knomeat most extend them20:28
knomebut duplication is just... duplication20:28
knomeand prone to getting outdated20:28
slickymaster+1 on that20:28
knomebecause nobody from the official docs is not going to update the help wiki20:28
knomeand that's fair enough20:28
knomewe should simply link in the official docs20:28
belkinsaUm, there are a part of this whole team.20:28
knomesure, socially... but not necessarily interested in the community help wiki20:29
belkinsaBut o agree, they just focus on their niche and we focus on ours.20:29
knomeyes20:29
belkinsas/o/I20:29
eagles0513875knome: look at the postfix official doc's for 12.04 for instance and compare to that of the community20:29
eagles0513875official docs is so scant its unusuable20:29
belkinsaI know that pleia2 wants to correct that.20:29
knomeand because of that, i think we should avoid duplication20:29
pleia2eagles0513875: we really need to fix the official docs20:30
pleia2eagles0513875: have you submitted bug reports for what is missing? if not, please please do20:30
knomethat's where my area of interest ends... :)20:30
pleia2we don't want to keep adding to the wiki if the official docs aren't even complete, the official docs are the *core focus* of this team20:30
eagles0513875pleia2: no i have not thing is i dont bother to use them as i go back ot the community ones and bam i get things working20:30
knomeyes, file bugs agaisnt the official docs, don't divert and try to "do it all better ourself"20:30
belkinsaIs there a way to have the offical docs updated for the system/sever docs as like a PPA and updates when its updated?20:30
belkinsaSorry for being offtopic.20:30
pleia2eagles0513875: you're only really solving this for yourself and not helping the team :( please help us improve these docs20:31
eagles0513875that is the problem i see wiht the official docs20:31
pleia2the problem is that people won't submit bugs20:31
eagles0513875and im just as guilty on that front20:31
knomeeagles0513875, we fixed the official xubuntu docs20:31
eagles0513875i wonder20:31
eagles0513875you got me wondering if we could on every page of the official docs put a link on how to submit a bug20:31
belkinsaOh, is there a way to get people to know that they can summit bugs?20:31
knomeeagles0513875, they are fantastic now, and since we put all our effort on that, we don't have too many pages in the community help wiki20:31
eagles0513875if someone finds one20:31
knome-> easier to maintain20:31
eagles0513875pleia2: i wasnt sure what to file against now i do know20:32
pleia2eagles0513875: there IS20:32
pleia2eagles0513875: see the footer of every single page in the server docs, for example I just clicked on one randomly https://help.ubuntu.com/13.10/serverguide/samba.html20:32
belkinsaMaybe a page in the docs for that could help users to bug things?20:32
pleia2"To report errors in this serverguide documentation, file a bug report."20:32
belkinsaOh, never mind.20:32
knomesame for the official docs20:33
pleia2yep20:33
knomeTo report errors in this documentation, file a bug.20:33
belkinsaOkay.20:33
pleia2I don't know how we can make this easier20:33
knomepleia2, file the bugs for the users so they don't have to20:33
eagles0513875is it worth filing bugs against 12.04 docs20:33
belkinsaIs the link to the LP included?20:33
* knome hides under the hardwoord table20:33
pleia2knome: hehe20:33
eagles0513875pleia2: ^ see above20:33
knomebelkinsa, yes, that's a link20:33
pleia2eagles0513875: yes, there is still a point release20:33
eagles0513875ok. i can already file a few20:34
pleia2eagles0513875: focusing on 14.04 would be better though20:34
belkinsaknome, thanks.20:34
eagles0513875but the problem is how often do updates be released for LTS docs20:34
knomeyes, at the moment we should get the 14.04 docs in shape20:34
pleia2that's the next LTS, and in development now so much easier to get changes into now20:34
pleia2it's not really worth spending time on 12.04 at the expense of 14.0420:34
eagles0513875what will its documentation be based off of?20:34
pleia2https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/UbuntuServerGuide20:35
pleia2has instructions for checking out the current branch :)20:35
eagles0513875pleia2: i dont feel confident writing them20:36
eagles0513875would it be ok if i checked them out and filed bugs against them in case there are issues or areas that need improvement?20:36
pleia2eagles0513875: you don't have to, just download them so you can look at them20:36
pleia2yep, that's perfectly fine20:36
knomeif you have the knowledge and time to write something for the docs, you should do that20:36
knomeit can always be reviewed and verified by somebody else20:37
knomeit's easier to review and merge than write20:37
eagles0513875knome: thing is I have alot on my plate20:37
eagles0513875from freelance work I have but I can provide improvements to the docs in the form of bugs20:38
knomeeagles0513875, that's fine. i said "if you have the knowledge and time"20:38
eagles0513875atm if my mentor resurfaces i hope to continue learning how to package20:38
eagles0513875and package right20:38
knomei'm an entrepreneur and the xubuntu project lead but i'm trying to find time to help the docs team to get better20:38
eagles0513875knome: im an entrepreneur as well20:38
eagles0513875starting my own IT business and have a few projects for it as well20:38
belkinsaThanks knome for joining.  We do need help for sure.20:39
knomei'm just saying we all have the time-constraints20:39
belkinsaWe all do.20:39
eagles0513875atm trying to raise funds for a low cost PoS system using open source point of sales software :)20:39
eagles0513875using kubuntu 13.10 on this laptop which i use for development work etc20:39
knomeeagles0513875, do you think you could use some of the time you have used to update the community help wiki to update the official docs instead?20:40
eagles0513875if you are telling me to focus on the official docs20:40
eagles0513875and pleia2 said they have managed to cut down on the number of pages the project shes on has i will focus on filing bugs against the official docs20:41
knomedo you think you could also take the responsibility of writing some of the pages, or at least start the work on them so others could get motivated and help you?20:41
eagles0513875I can try20:42
belkinsaSure.20:42
belkinsaIf that was directed also to me.20:42
eagles0513875knome: thing is most woudl be copy and paste from the community stuff20:42
eagles0513875i think its high time i get on a vm of 14.0420:42
knomebelkinsa, well anybody and everybody20:42
eagles0513875and teest setting things up on therwe20:42
belkinsaOkay, I figured, but I wante dto check20:42
knomeeagles0513875, that's fine, as long as you double-check the validity and quality20:42
eagles0513875sry im juggling between work20:42
knomeonce it's in the official docs, we can look into dropping it from the community help to avoid duplication20:43
eagles0513875wait isnt there a really high barrier to entry with the official docs20:43
eagles0513875to join the team that is20:43
pleia2anyone can submit merge proposals20:43
eagles0513875knome: pleia2 the problem is try this out. google ubuntu postfix20:43
eagles0513875community stuff is found first20:43
pleia2actually joining the team means you have full editorial control to edit things directly, so yes there is a higher barrier there :)20:43
knomeeagles0513875, let's fix that.20:43
eagles0513875what can be done to improve the search rankings of the official docs20:43
belkinsaAlso, to create a sandbox branch is allowed too20:43
eagles0513875i think as well we need to look into improving SEO for the official docs20:44
knomeeagles0513875, sounds fair; want to file a bug for that?20:44
eagles0513875knome: yes i will20:44
eagles0513875once i settle into work20:44
knomethanks20:45
eagles0513875juggling alot on my plate besides work tonight20:45
eagles0513875are their iso's available for 14.04 or one has to do a network upgrade?20:47
knomeiso's have been available for a while already20:47
pleia2http://iso.qa.ubuntu.com/qatracker/milestones/308/builds20:47
pleia2^^ daily isos20:47
eagles0513875knome: i never know where to find them :)20:47
knomehttp://cdimage.ubuntu.com/daily-live/current/20:47
knomeis always the newest daily ISO20:48
belkinsacproffit: Is it possible to have a link to the program guide from the wiki to the search page for that program on AskUbuntu?20:48
eagles0513875qa site is way to confusing to work with20:48
eagles0513875lol20:48
eagles0513875ill do a network upgrade from 13.10 to 12.0420:49
knomeit's very logical, but can look a bit daunting20:49
eagles0513875knome: just looking at it as we speak im finding it quite daunting20:49
slickymastereagles0513875, http://cdimage.ubuntu.com/xubuntu/daily-live/20131206/trusty-desktop-i386.iso20:49
knomeeagles0513875, there are people who can guide you through it if you are interested.20:50
slickymastereagles0513875,  http://cdimage.ubuntu.com/xubuntu/daily-live/20131206/trusty-desktop-amd64.iso20:50
eagles0513875what would be the best for me to work with if im working on server side stuff20:50
eagles0513875desktop or server or can i use desktop anyway that way i can work on stuff for both?20:51
knomei'm not able to answer that20:51
belkinsaknome, I think your work on the pages could be translated for the other favours because I think the way you have them is easier to use than the old ones.20:51
knomebelkinsa, other flavors?20:51
belkinsaThe format is what I was referring to.20:52
belkinsaLike Ubuntu, Kubuntu, ect.20:52
knomei don't think the flavors have such help wiki's really20:52
belkinsaOh.20:53
belkinsaBut wouldn't be nice though?20:53
knomei can't speak for other flavors, but xubuntu doesn't need one20:54
eagles0513875belkinsa: in terms of kubuntu usually points back to ubuntu docs20:54
belkinsaOh.20:54
eagles0513875the only seperation would be a wiki on kde i think if they even have one20:54
belkinsaUm...20:54
belkinsaNever midn.20:54
belkinsaBut I still like that format.20:54
belkinsaI think it could be used for the Ubuntu front page, if possible,20:55
eagles0513875ha20:55
eagles0513875kubuntu just poinst to the ask page20:55
knomethat's probably off our scope, and won't really happen20:55
eagles0513875http://www.kubuntu.org/support20:55
knomehere's what we do with xubuntu: http://xubuntu.org/help/20:56
belkinsaThey use a blog, don't they?20:56
eagles0513875http://www.kubuntu.org/community20:57
eagles0513875they dont even have a wiki actually20:57
eagles0513875just forums or even they link back to ubuntu forums20:57
belkinsaWow.20:57
eagles0513875belkinsa: it makes sense though20:57
eagles0513875core is technically ubuntu20:58
eagles0513875DE is the only difference20:58
belkinsaYeah, I know.20:58
eagles0513875hey mhall11920:58
belkinsaSigh, sometimes i think "why am I in this team".20:59
knomebecause you are interested in docs, and ultimately want to make them better20:59
eagles0513875whats wrong belkinsa20:59
belkinsaWell, not really, I joined because of the MoinMoin editing skills that I have.  But maybe I do have a interested in the docs and having them easy to use.21:00
eagles0513875belkinsa: imho ease of use is important to documentation21:02
belkinsaTrue, true.21:03
belkinsaMaybe I should focus on that.21:06
knomewhatever scratches your itch21:06
knomehttps://help.ubuntu.com/community/FrontPageRefresh  is now clean of most of the weird stuff on the current front page21:08
slickymasterno more signpost :)21:10
belkinsaYou guys are good now, right?21:10
knomeyep.21:10
knomewell, no, this is not where it ends.21:10
belkinsaOh.21:10
belkinsaI meant good from my help.21:10
knomewe should keep on working on the OtherResources page, for example21:11
knomeif you have any feedback or ideas, they are still welcome21:11
belkinsaThat newer one is cleaner and better.21:11
belkinsaI see and that works for me21:11
belkinsagodbyk, i like your idea!21:12
slickymastergot go, guys21:14
slickymastercy21:14
belkinsaSee ya21:14
belkinsaThanks for coming to the channel to talk about this21:15
slickymasternp21:15
godbykJust a reminder, the docs team is meeting in #ubuntu-meeting right now if you'd like to join us.22:06
belkinsaknome, I just noticed that that page is for the Ubuntu Community Help wiki, sorry!22:48
knomebelkinsa, yes?22:48
belkinsaI thought that page was for the Xubuntu front page.22:49
knomenah.22:51
knomewe don't do user-oriented stuff on wiki's22:52
knomehttps://help.ubuntu.com/community/OtherResources is mostly done. anybody have ideas on how to improve?23:17
belkinsaAwesome layout!23:47
belkinsaThough I think mailing-list should go a wiki page explaining what one is and have a link to the list.ubuntu.com, same with IRC, minus the channel list, but maybe the user support channels.23:48
belkinsaIf there are pages on those.23:50
bkerensa;)23:50
belkinsaknome, I thank  you for this. You just rock,23:52

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