View Poll Results:

Voters
0. You may not vote on this poll
  • 0 0%
Page 1 of 24 12311 ... LastLast
Results 1 to 10 of 235

Thread: Ideas and Plans for Improving Ubuntu Documentation

  1. #1

    Ideas and Plans for Improving Ubuntu Documentation

    Does anybody else hesitate to refer new users to the wiki?

    There's a lot of valuable information on the wiki, but it just isn't very noob friendly. For one, everything is WrittenLikeThis. And then there's the fact that wikis are usually so loosely structured that users feel really confused.

    As long as there is a doc team, why not just set up a new user docs-only site with a simple-to-navigate CMS and call it the official ubuntu guide? If people are going to wet their pants if they can't edit a page, let them leave a comment or sign up to be on the doc team.

    If this isn't possible, let's at least have a "New users click here for the manual" link above all the "You too can edit wiki pages!" self-gratifying snarf on the home page.

    EndOfRant

  2. #2
    Join Date
    Apr 2005
    Location
    Not-So-Sunny Hawaii
    Beans
    Hidden!

    Re: Opinions on the Wiki

    Quote Originally Posted by maruchan
    Does anybody else hesitate to refer new users to the wiki?

    There's a lot of valuable information on the wiki, but it just isn't very noob friendly. For one, everything is WrittenLikeThis. And then there's the fact that wikis are usually so loosely structured that users feel really confused.

    As long as there is a doc team, why not just set up a new user docs-only site with a simple-to-navigate CMS and call it the official ubuntu guide? If people are going to wet their pants if they can't edit a page, let them leave a comment or sign up to be on the doc team.

    If this isn't possible, let's at least have a "New users click here for the manual" link above all the "You too can edit wiki pages!" self-gratifying snarf on the home page.

    EndOfRant
    the Wiki isn't organised well... it's really hard to find stuff...

    surely some CMS's can be set up to work Wiki style?

  3. #3
    Join Date
    Oct 2004
    Location
    Canada
    Beans
    208

    Re: Opinions on the Wiki

    The wiki has been neglected by us recently. This is now coming to an end. We are also working on getting our official help that is shipped with the distro to a new webspace as well.

    And as for CamelCase, I wish it would go away too, but I don't have enough clout.

    Corey
    Last edited by Burgundavia; July 21st, 2005 at 01:53 AM. Reason: typo

  4. #4
    Join Date
    Nov 2004
    Location
    Texas
    Beans
    2,434

    Re: Opinions on the Wiki

    Quote Originally Posted by maruchan
    Does anybody else hesitate to refer new users to the wiki?
    Depends. Some of the wiki pages are well written (like the synaptic howto). But unlike the guide, I would never say "look in the wiki for your answer."

    The wiki REALLY needs a page like this:

    http://www.ubuntuforums.org/showthread.php?t=31094
    Those folks who try to impose analog rules on digital content will find themselves on the wrong side of the tidal wave.
    - Mark Shuttleworth

  5. #5
    Join Date
    Oct 2004
    Location
    Canada
    Beans
    208

    Re: Opinions on the Wiki


  6. #6

    Re: Opinions on the Wiki

    Quote Originally Posted by burgundavia
    The wiki has been neglected by us recently. This is now coming to an end.
    So the wiki is closing down, or what?

    Quote Originally Posted by poofyhairguy
    The wiki REALLY needs a page like this:

    http://www.ubuntuforums.org/showthread.php?t=31094
    That is one awesome forum post.

  7. #7
    Join Date
    Oct 2004
    Location
    Kingston, On
    Beans
    Hidden!

    Re: Opinions on the Wiki

    Have you seen this?

    https://wiki.ubuntu.com/UserDocumentation

    There is also

    https://wiki.ubuntu.com/forum

    But the first link is way better. The goal is for forum staff to encourage people to use and contribute back to the wiki. We will get on this shortly, just as soon as we get our act together.

    Think contests.....

  8. #8
    Join Date
    Oct 2004
    Location
    Kingston, On
    Beans
    Hidden!

    Re: Opinions on the Wiki

    I get up for five minutes and twelve people post before I do....

    What the heck is CamelCase? Like, where does the word ComeFrom?

    http://www.ubuntuforums.org/showthread.php?t=31094

    *That* is a taget of opportunity for a wiki porting contest. RastaMahata should get a prize right off the bat..

  9. #9
    Join Date
    Jun 2005
    Location
    Toronto
    Beans
    100

    Re: Opinions on the Wiki

    Quote Originally Posted by maruchan
    ..For one, everything is WrittenLikeThis.
    Ha!ThatisTooFunny! WritingLikeThisIsWayBetterThanUsingSpaces which would just be, you know, readable....
    Registered Linux User: #182084 - July 2000
    http://counter.li.org/ | Ubuntu Hardy Heron 8.04

  10. #10
    Join Date
    Nov 2004
    Location
    Texas
    Beans
    2,434

    Re: Opinions on the Wiki

    Quote Originally Posted by Burgundavia
    That link should be at the top of the Ubuntu.com home page.
    Those folks who try to impose analog rules on digital content will find themselves on the wrong side of the tidal wave.
    - Mark Shuttleworth

Page 1 of 24 12311 ... LastLast

Bookmarks

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •