{"id":121,"date":"2007-07-04T07:18:54","date_gmt":"2007-07-04T07:18:54","guid":{"rendered":"http:\/\/ubuntucat.wordpress.com\/2007\/07\/04\/documentation-fragmentation\/"},"modified":"2007-07-04T07:18:54","modified_gmt":"2007-07-04T07:18:54","slug":"documentation-fragmentation","status":"publish","type":"post","link":"https:\/\/www.psychocats.net\/ubuntucat\/documentation-fragmentation\/","title":{"rendered":"Documentation Fragmentation"},"content":{"rendered":"<p>I remember two years ago, when I first started using Ubuntu, I went to look for help and found <a href=\"https:\/\/help.ubuntu.com\/community\/\">the official Wiki.<\/a> I clicked about three links deep and decided it was too difficult to find what I was looking for. The page layouts were confusing, and I had no idea what the documentation was saying. Then, somehow, I found out about <a href=\"http:\/\/www.ubuntuguide.org\/\">the Ubuntu Guide<\/a> and fell in love with it. Before that, I had been deathly (and quite irrationally) afraid of the command-line. There was something comforting about seeing all those commands, one after the other, laid out together on one long page. Somehow, to me back then, that didn&#8217;t seem as overwhelming as the Wiki. <\/p>\n<p> Then I found out about <a href=\"http:\/\/www.ubuntuforums.org\">the Ubuntu Forums<\/a> and later about <a href=\"http:\/\/doc.gwos.org\">The Ubuntu Documentation Storage Facility<\/a>. <\/p>\n<p> At some point along the way, I decided to create my own Ubuntu tutorials site, which turned into <a href=\"http:\/\/www.psychocats.net\/ubuntu\/\">the Psychocats Ubuntu site<\/a>. Even though many people have been encouraging about my efforts and have told me how useful they&#8217;ve found my work to be, I have had a couple of people say something to the effect of <i>Why are you creating another tutorial site? Why not just contribute to the Wiki?<\/i> <\/p>\n<p> Well, there were a few reasons I didn&#8217;t contribute to the Wiki: <\/p>\n<ul>\n<li><b>For a beginner like me, the learning curve on <i>using<\/i> the Wiki was too much to deal with.<\/b> I was already coming to grips with learning Ubuntu. I didn&#8217;t need another thing to try to figure out. Even now, after I have contributed a few pages to the Wiki, I still can&#8217;t suss out how to include screenshots on Wiki pages.\n<li> Anyone can go in and fix the content of the Wiki to contain better explanations or more commands, but <b>you can&#8217;t just change the presentation, stylesheets, and organization willy-nilly<\/b>&#8230; not unless you want to step on a lot of people&#8217;s virtual toes.\n<li><b>I had different goals<\/b> from the Wiki, the Ubuntu Guide, and the Documentation Storage Facility.  My set of guides was never intended to be a comprehensive library (Wiki, Storage) or a quick reference (Ubuntu Guide). The Psychocats Ubuntu site is all about being digestible and focusing on new users. I also believe in the power of screenshots, even though I sometimes present command-line solutions, too.\n<li> <b>I haven&#8217;t found anything inherently bad about fragmentation<\/b>, especially since I&#8217;ve unofficially released Psychocats under an open license and have even migrated some of my tutorials over to the official Wiki. I love some of the other tutorials I&#8217;ve spotted, including <a href=\"http:\/\/www.monkeyblog.org\/ubuntu\/installing\">the How to Install ANYTHING in Ubuntu guide<\/a> and <a href=\"http:\/\/users.bigpond.net.au\/hermanzone\">Herman&#8217;s Guide to Dual-booting<\/a>.  <\/ul>\n<p> Yes, I realize it&#8217;s confusing to new users if &#8220;everything&#8221; isn&#8217;t all in one place, but I was a new user once, and I found &#8220;everything&#8221; confusing at the Wiki, so that argument doesn&#8217;t hold water. It&#8217;s 2007, and the internet is a big place, so get used to a little confusion. At least we have search engines to help us out. <\/p>\n<p> Collaboration doesn&#8217;t always take traditional forms, and so there&#8217;s no need to panic when you encounter documentation fragmentation, folks.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>I remember two years ago, when I first started using Ubuntu, I went to look for help and found the official Wiki. I clicked about three links deep and decided it was too difficult to find what I was looking for. The page layouts were confusing, and I had no idea what the documentation was&hellip; <a class=\"more-link\" href=\"https:\/\/www.psychocats.net\/ubuntucat\/documentation-fragmentation\/\">Continue reading <span class=\"screen-reader-text\">Documentation Fragmentation<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[21],"tags":[],"class_list":["post-121","post","type-post","status-publish","format-standard","hentry","category-ubuntu","entry"],"_links":{"self":[{"href":"https:\/\/www.psychocats.net\/ubuntucat\/wp-json\/wp\/v2\/posts\/121","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.psychocats.net\/ubuntucat\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.psychocats.net\/ubuntucat\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.psychocats.net\/ubuntucat\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.psychocats.net\/ubuntucat\/wp-json\/wp\/v2\/comments?post=121"}],"version-history":[{"count":0,"href":"https:\/\/www.psychocats.net\/ubuntucat\/wp-json\/wp\/v2\/posts\/121\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.psychocats.net\/ubuntucat\/wp-json\/wp\/v2\/media?parent=121"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.psychocats.net\/ubuntucat\/wp-json\/wp\/v2\/categories?post=121"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.psychocats.net\/ubuntucat\/wp-json\/wp\/v2\/tags?post=121"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}