/srv/irclogs.ubuntu.com/2013/09/02/#ubuntu-doc.txt

phillwHi folks, https://wiki.ubuntu.com/phillw/GettingStarted is a copy of what is shown to new people. It's a darn mess. :: SIGH :: We will have a play with it on my sandbox area, and then it can be discussed and edited. As Beta 1 is fast approaching, I'm not too sure how much time I can give to it. Please feel free to put your thoughts and ideas forward. Thanks, Phill.01:20
pleia2phillw: can you be a big more specific than "darn mess"?01:21
pleia2it's just a bunch of links to the actual docs that we've written01:21
pleia2s/big/bit01:22
phillwpleia2: look at https://wiki.ubuntu.com/phillw/GettingStarted01:22
pleia2I am looking at it01:22
phillwthat is a copy of it01:22
pleia2it's a copy of our GettingStarted01:22
phillwindeed...01:22
pleia2aside from broken image links, what specifically troubles you about it?01:22
phillwthere is no explantion of anything.01:23
pleia2no, it's just a list of links to things that explain01:23
phillwpleia2: as mentioned in the email.. try https://wiki.ubuntu.com/Testing/Activities01:24
pleia2oh sure, it certainly can be improved :) that's why I'm asking for your feedback01:24
phillwjust stating a topic is insufficient01:24
pleia2this is just a first draft, please give us a break, we've worked hard this cycle to even get this far01:25
phillwpleia2: hey do you know how many man-hours were put into the https://wiki.ubuntu.com/Testing/Activities ?01:25
pleia2coming in here and complaining that something is a "darn mess" isn't particularly respective of the work we've put in this cycle01:25
pleia2respectful too01:25
pleia2so please, try to calm down a bit, we're doing our best01:26
phillwpleia2: it's a darn mess, what I came here to ask, was we can do better :D01:26
pleia2can you please use kinder words?01:26
pleia2you're really being quite insulting right now01:26
pleia2it's a very basic listing of resources, we'll work on improving it01:27
phillwAnd, I'm quite calm, but for a n00b, they would have no idea of where to go. As you have told be off in the past on my classroom sessions, it does seem rather odd that having taken your advice on board I now get told off?01:28
pleia2I'll go and pull out the broken images now01:28
pleia2I am not telling you off, I really wish you'd stop usin that phrase :(01:28
pleia2I am explaining that we're working very hard here, please try to respect that01:28
phillwpleia2: please accept my apologies, but I am also getting fed up of people stating that "wiki is where documents go to die".01:29
pleia2I never said any such thing, we're actively working on this wiki page01:30
pleia2ok, removed broken links so at least it doesn't *look* like it's been abandoned anymore01:30
phillwpleia2: you did not, others have. that is why I added the new tab. At least people will now know if the wiki page has gone out to die.01:31
phillws/the/any/01:32
pleia2phillw: do you know where is the GettingStarted page linked? I can only find the direct system documentation pages01:35
phillwpleia2: we *will* get that page sorted out. Once it has a bit of love and attention, it will be proposed to leave the sandbox area and re-join the main area. My words may seem wrong and attack mode at times, but I'm a wiki guy and *hate* instances when others can state we have got it wrong :)01:35
pleia2https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation should really be where folks start01:36
pleia2that's linked directly on https://wiki.ubuntu.com/DocumentationTeam when folks look to contribute to system documentation01:36
phillwI only held the docs getting started area whilst the team discussed things to make it more n00b friendly. It went live a couple of days ago. although, I am struggling to see the links that were in the final email01:38
pleia2https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/UbuntuDesktopGuide is where the one we were working on ended up01:38
phillwpleia2: it could well be the cache on my broweser...  let me just kill it01:39
pleia2GettingStarted wasn't appropriate for it, since it's very specific to Desktop guide, completely ignores wiki, server guide and everything else01:39
phillwpleia2: so, where should be heading?01:41
pleia2phillw: we can work on improving /GettingStarted if needed, but for now I think we should really focus on the existing docs01:42
pleia2I just blogged earlier about the basics of how folks can get involved and linked to the appropriate pages: http://princessleia.com/journal/?p=844301:42
pleia2we still have a long way to go, but we're getting there01:44
phillwpleia2: I'm quite happy to drop getting stated. As I mentioned on the ML - We have to do the best we can for 13.10, but really do have to aim for 14,04 LTS.01:44
* pleia2 nods01:44
phillwLet us concentrate our scant resources to what we can. Where if https://wiki.ubuntu.com/phillw/GettingStarted is not a 'GO', where is?01:46
pleia2https://wiki.ubuntu.com/DocumentationTeam01:46
pleia2from there you look at the headings and see what you find interesting01:46
pleia2if you click on "System Documentation" you get taken to the instructions for getting started with that, same for "Wiki Documentation"01:46
phillw:: SIGH :: okies, you are the bosses. I'd rather the 'get involved' part have higher notification, just as Nicholas on QA/ Testing wanted me to highlight our classroom sessions on https://wiki.ubuntu.com/Testing/Activities/ His view was that "I want to help" should be top of the list.01:50
pleia2well the whole thing is "get involved"01:52
pleia2fixed up the header so the broken Mentoring link is gone and everything is shiny01:54
phillwpleia2: you do not know how much 'customer' input we held on that re-write :) But, their input, whilst stinging at times, was taken on board. We do forget the input of new commers.01:54
pleia2the subheading pages linked in https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation need a lot of work since many still mention DocBook, but one thing at a time01:55
pleia2phillw: I guess I just don't understand what different material would go on a GettingStarted specific page, since all of https://wiki.ubuntu.com/DocumentationTeam is already explaining what it is and how to get started01:55
pleia2we have that root page, and a "Joining the Team" page and specific quickstarts for various types of documentation01:56
phillwpleia2: indeed, we can only do so much at once.  But once I ask people to overview work and they get a messed up page that has no descriptions and broken links; the new comers are totally allowed to give me grief :D01:57
phillwthat is why we have testers :)01:58
pleia2yeah, that broken /GettingStarted page really shouldn't be linked anywhere01:59
phillwliz, I even have managed to have a broken link for lubuntu release. It happens; we need the testers to check these things out. It is not a failure, it is a mark of us having a testing system in place.02:01
pleia2did you figure out where it's linked from?02:02
pleia2(aside from the mailing list :))02:03
pleia2I have to head out for a bit, will have to pick this up later02:04
phillwpleia2: I'm off to bed, catch up later.02:38
=== smartboyhw_ is now known as smartboyhw
bkerensapleia2: I have reviewed the collect screenshots tool20:53
bkerensaand basically some programs it used are no longer shipped with Ubuntu20:53
bkerensaand Unity has changed too so it seems to not know how to manipulate it to take screenshots at the right resolution20:53
bkerensaits a mess20:53
bkerensa:)20:53
pleia2godbyk and I tried it out yesterday, he wrote some patches yesterday for it21:35
godbykbkerensa: Yeah, you have to install a few extra packages (see the comments at the top of the script).21:36
godbykI've written some code to check for and install the missing programs, but I haven't committed it yet.21:36
godbykI'm commenting the script a bit more, too.21:36
godbykThen I want to sort out the timing issues.21:36
pleia2\o/21:37
godbykThe script itself is quite brittle as it stands. It relies on a lot of assumptions.21:38

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