{"id":3124,"date":"2009-08-10T13:01:41","date_gmt":"2009-08-10T17:01:41","guid":{"rendered":"http:\/\/www.libology.com\/blog\/?p=3124"},"modified":"2009-08-10T13:01:41","modified_gmt":"2009-08-10T17:01:41","slug":"open-source-documentation","status":"publish","type":"post","link":"https:\/\/www.libology.com\/blog\/2009\/08\/10\/open-source-documentation.html","title":{"rendered":"Open Source Documentation"},"content":{"rendered":"<p>One of the more frustrating things about open source software is the fact that many projects have little-to-no documentation.\u00a0 William Shields, a software developer from Australia,<a href=\"http:\/\/www.cforcoding.com\/2009\/08\/its-time-we-stopped-rewarding-projects.html\"> <strong>posts about his experiences<\/strong><\/a> and concludes that he isn&#8217;t going to patronize projects that don&#8217;t pay attention to their documentation.<\/p>\n<p>He is correct.\u00a0 Any mature software project, whether open-source or proprietary, should have resources available to provide information, specifications, options, and assistance to users.\u00a0 This doesn&#8217;t mean that every piece of software needs a manual and a call desk; there should be options available to provide assistance.<\/p>\n<p>For a smaller, lesser-used product, a brief overview and contact information for further questions may suffice.\u00a0 As the user base grows, group maintained resources (wiki, lists, forums) can allow those with more experience aid novices.<\/p>\n<p>The ultimate goal with any software is for people to use it, and use it effectively to improve their lives.\u00a0 Good information on using the software is part of that picture.\u00a0 When you find an open source project that needs documentation, consider how you might be able to add your knowledge and experience to the project (i.e. when life hands you lemons, make lemonade).<\/p>\n<p><em>found via <a href=\"http:\/\/networkedblogs.com\/p8650301?ref=nf\">What I Learned Today&#8230;<\/a><\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>One of the more frustrating things about open source software is the fact that many projects have little-to-no documentation.\u00a0 William Shields, a software developer from Australia, posts about his experiences and concludes that he isn&#8217;t going to patronize projects that &hellip; <a href=\"https:\/\/www.libology.com\/blog\/2009\/08\/10\/open-source-documentation.html\">Continue reading <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[2936,2982,2966,2971,2974,2979],"tags":[5008,5388,3241,5011,5010,4960,5383,5386,5009],"class_list":["post-3124","post","type-post","status-publish","format-standard","hentry","category-groups","category-open-source","category-software","category-training","category-tutorials","category-wiki","tag-computer-software","tag-open-source","tag-open-source-software","tag-software-needs","tag-software-project","tag-technologyinternet","tag-tutorials","tag-wiki","tag-william-shields"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/pSU5g-Oo","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.libology.com\/blog\/wp-json\/wp\/v2\/posts\/3124","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.libology.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.libology.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.libology.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.libology.com\/blog\/wp-json\/wp\/v2\/comments?post=3124"}],"version-history":[{"count":0,"href":"https:\/\/www.libology.com\/blog\/wp-json\/wp\/v2\/posts\/3124\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.libology.com\/blog\/wp-json\/wp\/v2\/media?parent=3124"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.libology.com\/blog\/wp-json\/wp\/v2\/categories?post=3124"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.libology.com\/blog\/wp-json\/wp\/v2\/tags?post=3124"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}