{"id":621,"date":"2019-08-15T10:45:50","date_gmt":"2019-08-15T17:45:50","guid":{"rendered":"https:\/\/www.encyclopediabriannica.com\/?p=621"},"modified":"2019-08-16T20:19:37","modified_gmt":"2019-08-17T03:19:37","slug":"step-2-editing-step-3-profit","status":"publish","type":"post","link":"https:\/\/www.encyclopediabriannica.com\/?p=621","title":{"rendered":"Step 2: Editing, Step 3: Profit"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">I recently gave a 20-minute talk at <a href=\"https:\/\/www.dianainitiative.org\/\">the Diana Initiative <\/a>in Las Vegas to help security writers take control of their writing and editing process.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">As I&#8217;ve started to shift roles from Technical Editor to Technical Marketing Writer this year, I wanted to pass on the practical advice I&#8217;ve learned in the last 3 years to the security writers in the industry who don&#8217;t have the benefit of editors on call like the consultants at Bishop Fox do.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">My slides and notes from the presentation are attached as a PDF:<\/p>\n\n\n\n<div class=\"wp-block-file\"><a href=\"https:\/\/www.encyclopediabriannica.com\/wp-content\/uploads\/2019\/08\/Step-2-Editing-Step-3-Profit-shared-notes.pdf\"><strong>Step-2-Editing-Step-3-Profit&#8211;notes<\/strong><\/a><a href=\"https:\/\/www.encyclopediabriannica.com\/wp-content\/uploads\/2019\/08\/Step-2-Editing-Step-3-Profit-shared-notes.pdf\" class=\"wp-block-file__button\" download>Download<\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Helpful Resources I&#8217;ve Made:<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Cybersecurity Style Guide: <a href=\"https:\/\/cybersecuritystyleguide.bishopfox.com\/\">https:\/\/cybersecuritystyleguide.com<\/a><br><br>Cyberdic (Spellcheck augmenter) <a href=\"https:\/\/github.com\/bishopfox\/cyberdic\">https:\/\/github.com\/bishopfox\/cyberdic<\/a><br><br>Chaos in the Machine: Why Security Needs a Style Guide: <a href=\"https:\/\/youtu.be\/Yl-4BWKpC28\">https:\/\/youtu.be\/Yl-4BWKpC28<\/a><br>(My 20 minute CactusCon talk about the benefits of choosing language intentionally)<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Helpful Resources From Others:<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">AP Style: <a href=\"https:\/\/www.apstylebook.com\/\">https:\/\/www.apstylebook.com\/<\/a><br><br>BuzzFeed Style Guide: <a href=\"https:\/\/www.buzzfeed.com\/emmyf\/buzzfeed-style-guide\">https:\/\/www.buzzfeed.com\/emmyf\/buzzfeed-style-guide<\/a><br><br>Conscious Style Guide: <a href=\"https:\/\/consciousstyleguide.com\/\">https:\/\/consciousstyleguide.com\/<\/a><br><br>How to Name Files:  <a href=\"https:\/\/speakerdeck.com\/jennybc\/how-to-name-files\">https:\/\/speakerdeck.com\/jennybc\/how-to-name-files <\/a><br><br>It Was the Best of Sentences, It Was the Worst of Sentences by June Casagrande <a href=\"https:\/\/www.goodreads.com\/en\/book\/show\/40717966-it-was-the-best-of-sentences-it-was-the-worst-of-sentences\">https:\/\/www.goodreads.com\/en\/book\/show\/40717966-it-was-the-best-of-sentences-it-was-the-worst-of-sentences<\/a><br><br>Lawyerist: How to Redact a PDF: <a href=\"https:\/\/lawyerist.com\/how-to-redact-a-pdf\/\">https:\/\/lawyerist.com\/how-to-redact-a-pdf\/<\/a><br><br>Lifehacker: Should You Use Grammarly Anymore? <a href=\"https:\/\/lifehacker.com\/should-you-use-grammarly-anymore-1833585995\">https:\/\/lifehacker.com\/should-you-use-grammarly-anymore-1833585995<\/a><br><br>Writing Tools: 50 Essential Tools for Every Writer by Roy Peter Clark <a href=\"https:\/\/www.goodreads.com\/book\/show\/51750.Writing_Tools\">https:\/\/www.goodreads.com\/book\/show\/51750.Writing_Tools<\/a><br><br>Ze Frank: An Invocation for Beginnings (start writing now!)<\/p>\n\n\n\n<figure class=\"wp-block-embed-youtube wp-block-embed is-type-video is-provider-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<span class=\"embed-youtube\" style=\"text-align:center; display: block;\"><iframe loading=\"lazy\" class=\"youtube-player\" width=\"580\" height=\"327\" src=\"https:\/\/www.youtube.com\/embed\/RYlCVwxoL_g?version=3&#038;rel=1&#038;showsearch=0&#038;showinfo=1&#038;iv_load_policy=1&#038;fs=1&#038;hl=en-US&#038;autohide=2&#038;wmode=transparent\" allowfullscreen=\"true\" style=\"border:0;\" sandbox=\"allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox\"><\/iframe><\/span>\n<\/div><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Other Notes:<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Use bullet points to clean up sentences with long lists.<br>(They also trick readers into reading more than they would.)<br><br>Only capitalize nouns that deserve it.<br>(Just because it&#8217;s part of an acronym doesn&#8217;t mean you need to show where the acronym comes from.)<br><br>Watch out for -ing words.<br>Going, accessing, uploading&#8230; these words can be nouns or verbs, so they are often the cause of confusion in a sentence. Seek them out and see if you can rephrase to use a stronger form (go, access, upload).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><br><\/p>\n","protected":false},"excerpt":{"rendered":"<p>I recently gave a 20-minute talk at the Diana Initiative in Las Vegas to help security writers take control of their writing and editing process. As I&#8217;ve started to shift roles from Technical Editor to Technical Marketing Writer this year, I wanted to pass on the practical advice I&#8217;ve learned in the last 3 years [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","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},"jetpack_post_was_ever_published":false},"categories":[31,36,39],"tags":[],"class_list":["post-621","post","type-post","status-publish","format-standard","hentry","category-elsewhere","category-security-style-guide","category-technical-editing","cat-31-id","cat-36-id","cat-39-id"],"jetpack_publicize_connections":[],"jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p4SNLB-a1","jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/www.encyclopediabriannica.com\/index.php?rest_route=\/wp\/v2\/posts\/621","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.encyclopediabriannica.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.encyclopediabriannica.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.encyclopediabriannica.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.encyclopediabriannica.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=621"}],"version-history":[{"count":7,"href":"https:\/\/www.encyclopediabriannica.com\/index.php?rest_route=\/wp\/v2\/posts\/621\/revisions"}],"predecessor-version":[{"id":633,"href":"https:\/\/www.encyclopediabriannica.com\/index.php?rest_route=\/wp\/v2\/posts\/621\/revisions\/633"}],"wp:attachment":[{"href":"https:\/\/www.encyclopediabriannica.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=621"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.encyclopediabriannica.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=621"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.encyclopediabriannica.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=621"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}