{"id":109,"date":"2020-07-23T16:59:06","date_gmt":"2020-07-23T16:59:06","guid":{"rendered":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/?post_type=chapter&p=109"},"modified":"2020-11-10T16:37:57","modified_gmt":"2020-11-10T16:37:57","slug":"write-compose-information","status":"publish","type":"chapter","link":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/chapter\/write-compose-information\/","title":{"raw":"Draft the Document","rendered":"Draft the Document"},"content":{"raw":"

Complete an Idea Matrix Before you Draft<\/h2>\r\n\"\"Once you have your purpose, audience, information\/sources, extracted and sorted main points, and order in which to present those main points, you can draft the technical document. As you can see, drafting a document occurs as a planned process; technical writers rarely, if ever, just sit down and write. As part of the process, understand that your first writing is always<\/em> a draft. Even for communications created under time constraints, you need to leave a little time between drafting and finalizing\/submitting the document. Ideally, you can get feedback from others to help you finalize a draft. If you cannot or do not have time to get others' feedback, at least set the document aside for a short time so that you can come back to it with an editorial as opposed to a creator's eye.\r\n\r\nAs an important precursor to the actual draft, create a layout of main points with their accompanying content and source information first\u2014this will greatly help you draft. In fact, the draft will almost write itself if once you complete this step. This is called an idea matrix, and it can be set up in this way:\r\n\r\n\"\"\r\n\r\n\"\"\r\n\r\nHere's a copy of the Idea Matrix for a Technical Document<\/a>\u00a0 to download and use. And below is an idea matrix based on the ongoing sample in this section of the text.\r\n
\r\n

sample idea matrix - precursor to a draft<\/h3>\r\nRemember the ongoing sample situation:\r\n

Your manager tasks you to provide a briefing about a European Court of Justice ruling to search engine optimization specialists who work in the field with clients. Your manager suspects that clients of the firm will ask about the ruling and she wants consultants to be able to answer clients\u2019 questions with confidence based on the latest information.<\/p>\r\nPlease note that some cells are not filled in. A common point need not be shared by every source in a sample.\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
Sources<\/th>\r\nCommon Points<\/th>\r\n<\/tr>\r\n
Jurisdiction<\/th>\r\nProcess of De-listing<\/th>\r\nWho Can De-list<\/th>\r\n<\/tr>\r\n
Nieva, R. (2014, November 26). EU wants \u201cright to be forgotten\u201d applied globally.<\/strong> Retrieved from http:\/\/www.cnet.com\/news\/eu-wants-right-to-be-forgotten-applied-globally\/<\/td>\r\nRichard Nieva in an Cnet.com blog post titled \u201cEU Wants 'Right to Be Forgotten' Applied Globally\u201d that EU privacy regulators want their \u201cruling applied worldwide,\u201d which means applying the ruling not just to local domains like \u201cgoogle.fr in France or google.de in Germany,\u201d which Google would prefer, but to Google.com as well (Nieva, 2014).<\/td>\r\n\u201cIn May the European Union decided people could request that their names be excluded from search results in Europe, if the results were deemed outdated or irrelevant,\u201d writes Richard Nieva in a Cnet.com blog post titled \"EU Wants 'Right to Be Forgotten' Applied Globally' (Nieva, 2014).<\/td>\r\n<\/td>\r\n<\/tr>\r\n
Lomas, N. (2014, November 28). \u201cRight to be forgotten\u201d guidelines published by European regulators. <\/strong>Retrieved from http:\/\/techcrunch.com\/2014\/11\/28\/rtbf-29wp-guidelines\/<\/td>\r\n\"Earlier this week the 29WP said it wanted the search de-listing ruling to extend to cover results on .com domains, not just European sub-domains,\" reports Natasha Lomas in a Techcrunch.com blog post titled \u201c\u2018Right To Be Forgotten\u2019 Guidelines Published By European Regulators\u201d (Lomas, 2014).<\/td>\r\nThe ruling \u201ccreates a process\u201d for people to remove links to unwanted content from Google's search results, writes Mark Scott in a New York Times<\/em> article titled \u2018Right to Be Forgotten\u2019 Should Apply Worldwide, E.U. Panel Says\u201d (Scott, 2014). The process itself is unspecified\u2014who adjudicates among requests to be de-listed?\u2014who can appeal and on what grounds?\u2014though Nieva reports that 170,000 requests have been so far (Nieva, 2014).<\/td>\r\nThe guidelines themselves state that \u201cthe interest of the public will be significantly greater if the data subject plays a role in public life,\u201d this as quoted by Natasha Lomas in a Techcrunch.com blog post titled \u201c\u2018Right To Be Forgotten\u2019 Guidelines Published By European Regulators\u201d(Lomas, 2014). So presumably public figures would be exempt from the privacy protections of the ruling.<\/td>\r\n<\/tr>\r\n
Scott, M. (2014, November 26). \u201cRight to be forgotten\u201d should apply worldwide, E.U. panel says.<\/strong> The New York Times.<\/em> Retrieved from http:\/\/www.nytimes.com\/2014\/11\/27\/technology\/right-to-be-forgotten-should-be-extended-beyond-europe-eu-panel-says.html<\/td>\r\nMark Scott writing for The New York Times<\/em> in an article titled \u201c\u2018Right to Be Forgotten\u2019 Should Apply Worldwide, E.U. Panel Says\u201d states that the just-issued guidelines as they stand are not binding, which means that it will \u201cbe up to E.U. member countries to decide how to apply them\u2014or if they want to apply them at all\u201d (Scott, 2014). Whether the ruling could be enforced beyond the E.U., and whether American content providers would comply, remains an open question.<\/td>\r\n<\/td>\r\n<\/td>\r\n<\/tr>\r\n
Lovejoy, B. (2014, December 1). European Court of Justice publishes \u201cright to be forgotten\u201d guidelines \u2013 and they are vague.<\/strong> Retrieved from http:\/\/9to5google.com\/2014\/12\/01\/european-court-of-justice-publishes-right-to-be-forgotten-guidelines-and-they-are-vague\/<\/td>\r\n<\/td>\r\nBen Lovejoy writing for the Google blog \u201c9 to 5\u201d writes that individuals in Europe under the ruling can request to have links deleted that are \u201cinaccurate, outdated, or irrelevant\u201d(Lovejoy, 2014). The request process itself is unspecified\u2014who adjudicates among requests to be de-listed?\u2014who can appeal and on what grounds?\u2014though Nieva reports that 170,000 requests have been received so far (Nieva, 2014).<\/td>\r\nPublic figures\u2014or those for whom \u201cthe interest of the public overrides the rights of the data subject\u201d\u2014are an exception: their requests for de-listing may be denied, reports Ben Lovejoy writing for the Google blog \u201c9 to 5\u201d (Lovejoy, 2014). But, continues Lovejoy, the guidelines admit that it cannot be \u201cestablish[ed] with certainty\u201d who should be considered a public figure, and even public figures are entitled to some degree of privacy, hence every request whether by a private individual or a \u201cpublic figure\u201d becomes a matter of bureaucratic discretion over claims that cannot be ruled on in advance (Lovejoy, 2014).<\/td>\r\n<\/tr>\r\n<\/tbody>\r\n<\/table>\r\n<\/div>\r\n

Create a Title for the Draft<\/h2>\r\nReview your idea matrix in order to create a title that forecasts your entire briefing. Since your brief consists of three common points, you might use those points in your title. And you want your title to tell your audience precisely why this information is important and how to use it up front.\r\n\r\nHere's one example of a title that forecasts everything; if this is too lengthy, you could simply use the first part of the title before the colon.\r\n\r\nWhat you need to know if your clients ask about the \"right to be forgotten\" regulations issued by the E.U. Court of Justice with respect to Google.com: Where does the ruling apply? What is the process to de-list yourself? And who can de-list themselves?<\/strong>\r\n

Draft the Document<\/h2>\r\n\"\"\r\n\r\nOnce you have completed all steps in this process, your drafting task becomes relatively easy, because the steps walk you through the thinking<\/em> that underlies the writing. The substance of the document will basically be written, and the organization should be clear. Now, all you need to do is to decide what content you want to add to the source information, if anything, depending on your purpose and audience. Then compose section headers, topic sentences, and concluding sentences. Voila! You have a draft.\r\n\r\n ","rendered":"

Complete an Idea Matrix Before you Draft<\/h2>\n

\"\"Once you have your purpose, audience, information\/sources, extracted and sorted main points, and order in which to present those main points, you can draft the technical document. As you can see, drafting a document occurs as a planned process; technical writers rarely, if ever, just sit down and write. As part of the process, understand that your first writing is always<\/em> a draft. Even for communications created under time constraints, you need to leave a little time between drafting and finalizing\/submitting the document. Ideally, you can get feedback from others to help you finalize a draft. If you cannot or do not have time to get others’ feedback, at least set the document aside for a short time so that you can come back to it with an editorial as opposed to a creator’s eye.<\/p>\n

As an important precursor to the actual draft, create a layout of main points with their accompanying content and source information first\u2014this will greatly help you draft. In fact, the draft will almost write itself if once you complete this step. This is called an idea matrix, and it can be set up in this way:<\/p>\n

\"\"<\/p>\n

\"\"<\/p>\n

Here’s a copy of the Idea Matrix for a Technical Document<\/a>\u00a0 to download and use. And below is an idea matrix based on the ongoing sample in this section of the text.<\/p>\n

\n

sample idea matrix – precursor to a draft<\/h3>\n

Remember the ongoing sample situation:<\/p>\n

Your manager tasks you to provide a briefing about a European Court of Justice ruling to search engine optimization specialists who work in the field with clients. Your manager suspects that clients of the firm will ask about the ruling and she wants consultants to be able to answer clients\u2019 questions with confidence based on the latest information.<\/p>\n

Please note that some cells are not filled in. A common point need not be shared by every source in a sample.<\/p>\n\n\n\n\n\n\n\n\n
Sources<\/th>\nCommon Points<\/th>\n<\/tr>\n
Jurisdiction<\/th>\nProcess of De-listing<\/th>\nWho Can De-list<\/th>\n<\/tr>\n
Nieva, R. (2014, November 26). EU wants \u201cright to be forgotten\u201d applied globally.<\/strong> Retrieved from http:\/\/www.cnet.com\/news\/eu-wants-right-to-be-forgotten-applied-globally\/<\/td>\nRichard Nieva in an Cnet.com blog post titled \u201cEU Wants ‘Right to Be Forgotten’ Applied Globally\u201d that EU privacy regulators want their \u201cruling applied worldwide,\u201d which means applying the ruling not just to local domains like \u201cgoogle.fr in France or google.de in Germany,\u201d which Google would prefer, but to Google.com as well (Nieva, 2014).<\/td>\n\u201cIn May the European Union decided people could request that their names be excluded from search results in Europe, if the results were deemed outdated or irrelevant,\u201d writes Richard Nieva in a Cnet.com blog post titled “EU Wants ‘Right to Be Forgotten’ Applied Globally’ (Nieva, 2014).<\/td>\n<\/td>\n<\/tr>\n
Lomas, N. (2014, November 28). \u201cRight to be forgotten\u201d guidelines published by European regulators. <\/strong>Retrieved from http:\/\/techcrunch.com\/2014\/11\/28\/rtbf-29wp-guidelines\/<\/td>\n“Earlier this week the 29WP said it wanted the search de-listing ruling to extend to cover results on .com domains, not just European sub-domains,” reports Natasha Lomas in a Techcrunch.com blog post titled \u201c\u2018Right To Be Forgotten\u2019 Guidelines Published By European Regulators\u201d (Lomas, 2014).<\/td>\nThe ruling \u201ccreates a process\u201d for people to remove links to unwanted content from Google’s search results, writes Mark Scott in a New York Times<\/em> article titled \u2018Right to Be Forgotten\u2019 Should Apply Worldwide, E.U. Panel Says\u201d (Scott, 2014). The process itself is unspecified\u2014who adjudicates among requests to be de-listed?\u2014who can appeal and on what grounds?\u2014though Nieva reports that 170,000 requests have been so far (Nieva, 2014).<\/td>\nThe guidelines themselves state that \u201cthe interest of the public will be significantly greater if the data subject plays a role in public life,\u201d this as quoted by Natasha Lomas in a Techcrunch.com blog post titled \u201c\u2018Right To Be Forgotten\u2019 Guidelines Published By European Regulators\u201d(Lomas, 2014). So presumably public figures would be exempt from the privacy protections of the ruling.<\/td>\n<\/tr>\n
Scott, M. (2014, November 26). \u201cRight to be forgotten\u201d should apply worldwide, E.U. panel says.<\/strong> The New York Times.<\/em> Retrieved from http:\/\/www.nytimes.com\/2014\/11\/27\/technology\/right-to-be-forgotten-should-be-extended-beyond-europe-eu-panel-says.html<\/td>\nMark Scott writing for The New York Times<\/em> in an article titled \u201c\u2018Right to Be Forgotten\u2019 Should Apply Worldwide, E.U. Panel Says\u201d states that the just-issued guidelines as they stand are not binding, which means that it will \u201cbe up to E.U. member countries to decide how to apply them\u2014or if they want to apply them at all\u201d (Scott, 2014). Whether the ruling could be enforced beyond the E.U., and whether American content providers would comply, remains an open question.<\/td>\n<\/td>\n<\/td>\n<\/tr>\n
Lovejoy, B. (2014, December 1). European Court of Justice publishes \u201cright to be forgotten\u201d guidelines \u2013 and they are vague.<\/strong> Retrieved from http:\/\/9to5google.com\/2014\/12\/01\/european-court-of-justice-publishes-right-to-be-forgotten-guidelines-and-they-are-vague\/<\/td>\n<\/td>\nBen Lovejoy writing for the Google blog \u201c9 to 5\u201d writes that individuals in Europe under the ruling can request to have links deleted that are \u201cinaccurate, outdated, or irrelevant\u201d(Lovejoy, 2014). The request process itself is unspecified\u2014who adjudicates among requests to be de-listed?\u2014who can appeal and on what grounds?\u2014though Nieva reports that 170,000 requests have been received so far (Nieva, 2014).<\/td>\nPublic figures\u2014or those for whom \u201cthe interest of the public overrides the rights of the data subject\u201d\u2014are an exception: their requests for de-listing may be denied, reports Ben Lovejoy writing for the Google blog \u201c9 to 5\u201d (Lovejoy, 2014). But, continues Lovejoy, the guidelines admit that it cannot be \u201cestablish[ed] with certainty\u201d who should be considered a public figure, and even public figures are entitled to some degree of privacy, hence every request whether by a private individual or a \u201cpublic figure\u201d becomes a matter of bureaucratic discretion over claims that cannot be ruled on in advance (Lovejoy, 2014).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

Create a Title for the Draft<\/h2>\n

Review your idea matrix in order to create a title that forecasts your entire briefing. Since your brief consists of three common points, you might use those points in your title. And you want your title to tell your audience precisely why this information is important and how to use it up front.<\/p>\n

Here’s one example of a title that forecasts everything; if this is too lengthy, you could simply use the first part of the title before the colon.<\/p>\n

What you need to know if your clients ask about the “right to be forgotten” regulations issued by the E.U. Court of Justice with respect to Google.com: Where does the ruling apply? What is the process to de-list yourself? And who can de-list themselves?<\/strong><\/p>\n

Draft the Document<\/h2>\n

\"\"<\/p>\n

Once you have completed all steps in this process, your drafting task becomes relatively easy, because the steps walk you through the thinking<\/em> that underlies the writing. The substance of the document will basically be written, and the organization should be clear. Now, all you need to do is to decide what content you want to add to the source information, if anything, depending on your purpose and audience. Then compose section headers, topic sentences, and concluding sentences. Voila! You have a draft.<\/p>\n

 <\/p>\n\n\t\t\t

\n\t\t\t

Candela Citations<\/h3>\n\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t\t
CC licensed content, Original<\/div>