{"id":2442,"date":"2010-03-14T13:29:34","date_gmt":"2010-03-14T19:29:34","guid":{"rendered":"http:\/\/tancos.net\/wp2\/?p=2442"},"modified":"2010-03-14T13:29:34","modified_gmt":"2010-03-14T19:29:34","slug":"the-iron-laws-of-software-documentation","status":"publish","type":"post","link":"https:\/\/shuffly.net\/zoop\/the-iron-laws-of-software-documentation\/","title":{"rendered":"The iron laws of software documentation"},"content":{"rendered":"<p>1. Those who understand software don&#8217;t know how to write.<\/p>\n<p>2. The usefulness of a manual is inversely proportional to its length.<br \/>\nCorollary: a manual is only as good as its index.<\/p>\n<p>3. Most computer users are neither software engineers nor dummies. Publishers of computer literature have yet to realize that.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>1. Those who understand software don&#8217;t know how to write. 2. The usefulness of a manual is inversely proportional to its length. Corollary: a manual is only as good as its index. 3. Most computer users are neither software engineers nor dummies. Publishers of computer literature have yet to realize that.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[10],"tags":[662,284],"class_list":["post-2442","post","type-post","status-publish","format-standard","hentry","category-decline-and-fall","tag-decline-and-fall","tag-irritations"],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/p4xam3-Do","jetpack_likes_enabled":true,"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/shuffly.net\/zoop\/wp-json\/wp\/v2\/posts\/2442","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/shuffly.net\/zoop\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/shuffly.net\/zoop\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/shuffly.net\/zoop\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/shuffly.net\/zoop\/wp-json\/wp\/v2\/comments?post=2442"}],"version-history":[{"count":0,"href":"https:\/\/shuffly.net\/zoop\/wp-json\/wp\/v2\/posts\/2442\/revisions"}],"wp:attachment":[{"href":"https:\/\/shuffly.net\/zoop\/wp-json\/wp\/v2\/media?parent=2442"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/shuffly.net\/zoop\/wp-json\/wp\/v2\/categories?post=2442"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/shuffly.net\/zoop\/wp-json\/wp\/v2\/tags?post=2442"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}