{"id":28292,"date":"2017-12-23T11:21:48","date_gmt":"2017-12-23T09:21:48","guid":{"rendered":"https:\/\/mamchenkov.net\/wordpress\/?p=28292"},"modified":"2017-12-23T11:21:48","modified_gmt":"2017-12-23T09:21:48","slug":"the-strange-art-of-writing-release-notes","status":"publish","type":"post","link":"https:\/\/mamchenkov.net\/wordpress\/2017\/12\/23\/the-strange-art-of-writing-release-notes\/","title":{"rendered":"The Strange Art of Writing Release Notes"},"content":{"rendered":"<!-- google_ad_section_start -->\n<p><a href=\"https:\/\/i0.wp.com\/mamchenkov.net\/wordpress\/wp-content\/uploads\/2017\/12\/release-notes.jpeg?ssl=1\"><img data-recalc-dims=\"1\" loading=\"lazy\" decoding=\"async\" data-attachment-id=\"28293\" data-permalink=\"https:\/\/mamchenkov.net\/wordpress\/2017\/12\/23\/the-strange-art-of-writing-release-notes\/directly-above-shot-of-smart-phone-on-diary-at-desk\/\" data-orig-file=\"https:\/\/i0.wp.com\/mamchenkov.net\/wordpress\/wp-content\/uploads\/2017\/12\/release-notes.jpeg?fit=1240%2C930&amp;ssl=1\" data-orig-size=\"1240,930\" data-comments-opened=\"1\" data-image-meta=\"{&quot;aperture&quot;:&quot;9&quot;,&quot;credit&quot;:&quot;Getty Images\/EyeEm&quot;,&quot;camera&quot;:&quot;Canon EOS 650D&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;1467476717&quot;,&quot;copyright&quot;:&quot;This content is subject to copyright.&quot;,&quot;focal_length&quot;:&quot;50&quot;,&quot;iso&quot;:&quot;200&quot;,&quot;shutter_speed&quot;:&quot;0.008&quot;,&quot;title&quot;:&quot;Directly Above Shot Of Smart Phone On Diary At Desk&quot;,&quot;orientation&quot;:&quot;1&quot;}\" data-image-title=\"Directly Above Shot Of Smart Phone On Diary At Desk\" data-image-description=\"\" data-image-caption=\"\" data-large-file=\"https:\/\/i0.wp.com\/mamchenkov.net\/wordpress\/wp-content\/uploads\/2017\/12\/release-notes.jpeg?fit=660%2C495&amp;ssl=1\" class=\"aligncenter size-medium wp-image-28293\" src=\"https:\/\/i0.wp.com\/mamchenkov.net\/wordpress\/wp-content\/uploads\/2017\/12\/release-notes-500x375.jpeg?resize=500%2C375&#038;ssl=1\" alt=\"\" width=\"500\" height=\"375\" srcset=\"https:\/\/i0.wp.com\/mamchenkov.net\/wordpress\/wp-content\/uploads\/2017\/12\/release-notes.jpeg?resize=500%2C375&amp;ssl=1 500w, https:\/\/i0.wp.com\/mamchenkov.net\/wordpress\/wp-content\/uploads\/2017\/12\/release-notes.jpeg?resize=768%2C576&amp;ssl=1 768w, https:\/\/i0.wp.com\/mamchenkov.net\/wordpress\/wp-content\/uploads\/2017\/12\/release-notes.jpeg?resize=1024%2C768&amp;ssl=1 1024w, https:\/\/i0.wp.com\/mamchenkov.net\/wordpress\/wp-content\/uploads\/2017\/12\/release-notes.jpeg?w=1240&amp;ssl=1 1240w\" sizes=\"auto, (max-width: 500px) 100vw, 500px\" \/><\/a><\/p>\n<p>Software development is never just about writing code.\u00a0 Programming is only a small part of the software development work.\u00a0 The rest touches and intervenes with a whole lot of other areas &#8211; documentation, support, testing, marketing, and so on and so forth.\u00a0 Recently, Slashdot ran <a href=\"https:\/\/tech.slashdot.org\/story\/17\/11\/14\/1632228\/the-strange-art-of-writing-release-notes\">this story<\/a> on the art of writing release notes.\u00a0 There are a couple of links from the story to <a href=\"https:\/\/spectrum.ieee.org\/tech-talk\/telecom\/internet\/the-art-of-writing-app-release-notes\">this article on IEEE<\/a> and <a href=\"https:\/\/techcrunch.com\/2015\/09\/04\/app-release-notes-are-getting-stupid\/\">this on TechCrunch<\/a>.<\/p>\n<p>These provide a lot to think about, at least for someone who wrote <a href=\"https:\/\/qobrix.com\/knowledge-base\/release-notes\/\">nearly 300 release notes<\/a> just this year alone (yeah, we had to catch up on historical releases).<\/p>\n<!-- google_ad_section_end -->\n","protected":false},"excerpt":{"rendered":"<!-- google_ad_section_start -->\n<p>Software development is never just about writing code.\u00a0 Programming is only a small part of the software development work.\u00a0 The rest touches and intervenes with a whole lot of other areas &#8211; documentation, support, testing, marketing, and so on and so forth.\u00a0 Recently, Slashdot ran this story on the art of writing release notes.\u00a0 There &hellip; <a href=\"https:\/\/mamchenkov.net\/wordpress\/2017\/12\/23\/the-strange-art-of-writing-release-notes\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">The Strange Art of Writing Release Notes<\/span><\/a><\/p>\n<!-- google_ad_section_end -->\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"The Strange Art of Writing Release Notes #WebDev #marketing #PR #writing","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"_links_to":"","_links_to_target":""},"categories":[62,1334],"tags":[1290,1330,1203],"keyring_services":[],"class_list":["post-28292","post","type-post","status-publish","format-standard","hentry","category-technology","category-web-work","tag-marketing","tag-web-development","tag-writing"],"aioseo_notices":[],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack-related-posts":[{"id":10060,"url":"https:\/\/mamchenkov.net\/wordpress\/2006\/04\/19\/daily-del-icio-us-bookmarks\/","url_meta":{"origin":28292,"position":0},"title":"Daily del.icio.us bookmarks","author":"Leonid Mamchenkov","date":"April 19, 2006","format":false,"excerpt":"Shared bookmarks for del.icio.us user tvset on 2006-04-18 JotSpot Family Site [Beta] -- Excellent tool for bringing families closer together - family tree, blogs, photo albums, recipes, polls, etc. Tagged as: blog communications cool family photos tools web2.0 webservices wiki Open Loops: Boosting Productivity With a Timer Tagged as: howto\u2026","rel":"","context":"In &quot;All&quot;","block_context":{"text":"All","link":"https:\/\/mamchenkov.net\/wordpress\/category\/general\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":47591,"url":"https:\/\/mamchenkov.net\/wordpress\/2020\/03\/12\/tips-for-implementing-a-software-release-process\/","url_meta":{"origin":28292,"position":1},"title":"Tips for Implementing a Software Release Process","author":"Leonid Mamchenkov","date":"March 12, 2020","format":false,"excerpt":"I came across this nice article outlining some of the tips for implementing the software release process. Software Development process is not complete and mature without a well-defined release process for the software applications. Every software application needs to be delivered or deployed at some point in time and for\u2026","rel":"","context":"In &quot;All&quot;","block_context":{"text":"All","link":"https:\/\/mamchenkov.net\/wordpress\/category\/general\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":28139,"url":"https:\/\/mamchenkov.net\/wordpress\/2017\/10\/23\/what-you-should-know-as-a-founder-of-a-software-company\/","url_meta":{"origin":28292,"position":2},"title":"What you should know as a founder of a software company","author":"Leonid Mamchenkov","date":"October 23, 2017","format":false,"excerpt":"\"What you should know as a founder of a software company\" is a nice overview of subjects, with links to learn more, for anyone who is thinking about or have already started a software company.\u00a0 The article goes through: UX design Visual design Customer support Marketing SEO Press outreach Writing\u2026","rel":"","context":"In &quot;All&quot;","block_context":{"text":"All","link":"https:\/\/mamchenkov.net\/wordpress\/category\/general\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":9741,"url":"https:\/\/mamchenkov.net\/wordpress\/2005\/12\/07\/daily-del-icio-us-bookmarks\/","url_meta":{"origin":28292,"position":3},"title":"Daily del.icio.us bookmarks","author":"Leonid Mamchenkov","date":"December 7, 2005","format":false,"excerpt":"Shared bookmarks for del.icio.us user tvset on 2005-12-06 Google recommends -- Interesting usage of Google API Tagged as: api code google ideas python services web Make the Software Shine: How to Write Comments Tagged as: article blog code comments computers development documentation howto programming software tips How to Handle Your\u2026","rel":"","context":"In &quot;All&quot;","block_context":{"text":"All","link":"https:\/\/mamchenkov.net\/wordpress\/category\/general\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":9660,"url":"https:\/\/mamchenkov.net\/wordpress\/2005\/11\/12\/daily-del-icio-us-bookmarks\/","url_meta":{"origin":28292,"position":4},"title":"Daily del.icio.us bookmarks","author":"Leonid Mamchenkov","date":"November 12, 2005","format":false,"excerpt":"Shared bookmarks for del.icio.us user tvset on 2005-11-11 Course: Digital Photography Tagged as: courses education photography tutorials Comixpedia -- Free encyclopedia about comics Tagged as: comics encyclopedia reference wiki Cornell Notetaking Method Custom PDF Generator Tagged as: class cool diy education ideas notes paper pdf pim software study tools web\u2026","rel":"","context":"In &quot;All&quot;","block_context":{"text":"All","link":"https:\/\/mamchenkov.net\/wordpress\/category\/general\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":28282,"url":"https:\/\/mamchenkov.net\/wordpress\/2017\/12\/18\/the-2018-guide-to-building-secure-php-software\/","url_meta":{"origin":28292,"position":5},"title":"The 2018 Guide to Building Secure PHP Software","author":"Leonid Mamchenkov","date":"December 18, 2017","format":false,"excerpt":"\"The 2018 Guide to Building Secure PHP Software\" is an excellent guide to writing modern PHP applications with security in mind.\u00a0 It covers a bunch of the usual topics, but provides fresher solutions than most other similar guides.","rel":"","context":"In &quot;All&quot;","block_context":{"text":"All","link":"https:\/\/mamchenkov.net\/wordpress\/category\/general\/"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/mamchenkov.net\/wordpress\/wp-content\/uploads\/2017\/12\/php-security-2018-500x204.png?resize=350%2C200&ssl=1","width":350,"height":200},"classes":[]}],"jetpack_sharing_enabled":true,"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/mamchenkov.net\/wordpress\/wp-json\/wp\/v2\/posts\/28292","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mamchenkov.net\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mamchenkov.net\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/mamchenkov.net\/wordpress\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/mamchenkov.net\/wordpress\/wp-json\/wp\/v2\/comments?post=28292"}],"version-history":[{"count":0,"href":"https:\/\/mamchenkov.net\/wordpress\/wp-json\/wp\/v2\/posts\/28292\/revisions"}],"wp:attachment":[{"href":"https:\/\/mamchenkov.net\/wordpress\/wp-json\/wp\/v2\/media?parent=28292"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mamchenkov.net\/wordpress\/wp-json\/wp\/v2\/categories?post=28292"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mamchenkov.net\/wordpress\/wp-json\/wp\/v2\/tags?post=28292"},{"taxonomy":"keyring_services","embeddable":true,"href":"https:\/\/mamchenkov.net\/wordpress\/wp-json\/wp\/v2\/keyring_services?post=28292"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}