{"id":180,"date":"2020-03-18T14:15:12","date_gmt":"2020-03-18T18:15:12","guid":{"rendered":"https:\/\/robsteiner.net\/pro\/?p=180"},"modified":"2020-03-18T14:15:12","modified_gmt":"2020-03-18T18:15:12","slug":"say-no-to-alphabet-soup","status":"publish","type":"post","link":"https:\/\/robsteiner.net\/pro\/2020\/03\/18\/say-no-to-alphabet-soup\/","title":{"rendered":"Say &#8220;NO&#8221; to alphabet soup"},"content":{"rendered":"\n<p>Write out your acronyms the first time you use them on the page. <\/p>\n\n\n\n<p>Just because you know <a href=\"https:\/\/cloud.google.com\/\">GCP<\/a>, <a href=\"https:\/\/aws.amazon.com\/\">AWS<\/a>, and the web programming language on which <a href=\"https:\/\/www.json.org\/json-en.html\">JSON<\/a> is based, doesn&#8217;t mean your readers do. If they do, they&#8217;ll skim over your description. If they don&#8217;t, you&#8217;ll save them a Google search.<\/p>\n\n\n\n<p>That said, know your audience. Web developers should know <a href=\"https:\/\/en.wikipedia.org\/wiki\/HTML\">HTML<\/a> as well as baseball managers know the difference between <a href=\"https:\/\/en.wikipedia.org\/wiki\/Walks_plus_hits_per_inning_pitched\">WHIP<\/a> and <a href=\"https:\/\/en.wikipedia.org\/wiki\/Earned_run_average\">ERA<\/a>. <\/p>\n\n\n\n<p>In those cases, a link to a definition is nice.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Write out your acronyms the first time you use them on the page. Just because you know GCP, AWS, and the web programming language on which JSON is based, doesn&#8217;t mean your readers do. If they do, they&#8217;ll skim over your description. If they don&#8217;t, you&#8217;ll save them a Google search. That said, know your &hellip; <a href=\"https:\/\/robsteiner.net\/pro\/2020\/03\/18\/say-no-to-alphabet-soup\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">Say &#8220;NO&#8221; to alphabet soup<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7,4,9],"tags":[],"class_list":["post-180","post","type-post","status-publish","format-standard","hentry","category-acronyms","category-technical-writer","category-writing","without-featured-image"],"_links":{"self":[{"href":"https:\/\/robsteiner.net\/pro\/wp-json\/wp\/v2\/posts\/180","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/robsteiner.net\/pro\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/robsteiner.net\/pro\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/robsteiner.net\/pro\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/robsteiner.net\/pro\/wp-json\/wp\/v2\/comments?post=180"}],"version-history":[{"count":2,"href":"https:\/\/robsteiner.net\/pro\/wp-json\/wp\/v2\/posts\/180\/revisions"}],"predecessor-version":[{"id":184,"href":"https:\/\/robsteiner.net\/pro\/wp-json\/wp\/v2\/posts\/180\/revisions\/184"}],"wp:attachment":[{"href":"https:\/\/robsteiner.net\/pro\/wp-json\/wp\/v2\/media?parent=180"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/robsteiner.net\/pro\/wp-json\/wp\/v2\/categories?post=180"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/robsteiner.net\/pro\/wp-json\/wp\/v2\/tags?post=180"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}