<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Rolfe Dlugy-Hegwer on Medium]]></title>
        <description><![CDATA[Stories by Rolfe Dlugy-Hegwer on Medium]]></description>
        <link>https://medium.com/@rolfedh?source=rss-c1a6f6fc96c5------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*Ldbq3rq8FbjdPAA8nM2LGg.jpeg</url>
            <title>Stories by Rolfe Dlugy-Hegwer on Medium</title>
            <link>https://medium.com/@rolfedh?source=rss-c1a6f6fc96c5------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 19:44:05 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@rolfedh/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Disclosing AI-Assisted Writing]]></title>
            <link>https://medium.com/@rolfedh/disclosing-ai-assisted-writing-6250de57741d?source=rss-c1a6f6fc96c5------2</link>
            <guid isPermaLink="false">https://medium.com/p/6250de57741d</guid>
            <category><![CDATA[medium]]></category>
            <category><![CDATA[writing]]></category>
            <category><![CDATA[chatgpt]]></category>
            <category><![CDATA[ai]]></category>
            <dc:creator><![CDATA[Rolfe Dlugy-Hegwer]]></dc:creator>
            <pubDate>Sun, 30 Jul 2023 23:41:36 GMT</pubDate>
            <atom:updated>2023-07-30T23:41:36.706Z</atom:updated>
            <content:encoded><![CDATA[<h4>Adhering to Medium’s Disclosure Requirement</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*BOHSYuN66Q7ZiE_I" /><figcaption>Photo by <a href="https://unsplash.com/@tonikoraza?utm_source=medium&amp;utm_medium=referral">Toni Koraza</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>Publishing platforms such as Medium mandate including a disclosure statement when using AI assistance in writing. According to Medium’s quality standards, stories lacking AI disclosure are limited in distribution to only the writer’s or the publication’s followers. Medium expresses its position as follows:</p><blockquote>We welcome the responsible use of AI-assistive technology on Medium. To promote transparency and help set reader expectations, we require that any story created with AI assistance be clearly labeled as such.</blockquote><h3>Consistent Disclosure: A Challenge</h3><p>The consistent implementation of AI disclosure can take time and effort. It necessitates copying the disclosure from a predefined file and pasting it into the footer of the story. Often, writers must remember to do this before publishing, leading to post-publication edits. An ideal feature on Medium would prompt the inclusion of a standard disclosure during every story publication.</p><h3>Using ChatGPT’s Custom Instructions: A Solution</h3><p>Incorporating the disclosure into ChatGPT’s custom instructions presents a viable solution. The implementation looks like this:</p><blockquote>Include the following text at the end of every response: “(Disclosure: I ideate and draft content in a text editor, refine it with the aid of paid artificial intelligence tools like ChatGPT and Grammarly, and revise it to reflect my intended message.)”</blockquote><p>By automating the disclosure’s inclusion, it becomes an integral part of the publication workflow, increasing the chances of its consistent implementation.</p><h3>Grammarly and AI</h3><p>Clarification is required about the use of Grammarly, another widely used tool. It’s confirmed that Grammarly utilizes AI technology in its GrammarlyGo tool and its standard grammar and spell-checking interface. Given this fact and the similar functionality of Grammarly and ChatGPT, it is appropriate to disclose the use of both in the writing process.</p><p>Previously published as <a href="https://medium.com/@rolfedh/example-of-how-to-disclose-ai-27c319f0bed6">Example of how to disclose AI</a>. Which version to you like most?</p><p>(Disclosure: I ideate and draft content in a text editor, refine it with artificial intelligence tools like ChatGPT and Grammarly and revise it to reflect my intended message.)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6250de57741d" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Example of how to disclose AI]]></title>
            <link>https://medium.com/@rolfedh/example-of-how-to-disclose-ai-27c319f0bed6?source=rss-c1a6f6fc96c5------2</link>
            <guid isPermaLink="false">https://medium.com/p/27c319f0bed6</guid>
            <category><![CDATA[technical-writing]]></category>
            <category><![CDATA[writing]]></category>
            <category><![CDATA[chatgpt]]></category>
            <category><![CDATA[medium]]></category>
            <dc:creator><![CDATA[Rolfe Dlugy-Hegwer]]></dc:creator>
            <pubDate>Sat, 29 Jul 2023 14:32:48 GMT</pubDate>
            <atom:updated>2023-07-29T14:48:21.227Z</atom:updated>
            <cc:license>https://creativecommons.org/licenses/by-sa/4.0/</cc:license>
            <content:encoded><![CDATA[<p>Disclose AI assistance to keep your story eligible for distribution.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*jWI6Bkn5NeKdjnsu" /><figcaption>Photo by <a href="https://unsplash.com/@drewbutler?utm_source=medium&amp;utm_medium=referral">Andrew Butler</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><h4>The problem</h4><p>Increasingly, publishing platforms and ethical guidelines for writers require that you disclose using AI in your writing process.</p><p>For example, as noted in <a href="https://help.medium.com/hc/en-us/articles/360006362473-Medium-s-Distribution-Standards-What-Writers-and-Publications-Need-to-Know#distribution-disqualification-0-3">Medium’s quality standards: how we review stories for distribution</a>:</p><blockquote>We welcome the responsible use of AI-assistive technology on Medium. To promote transparency, and help set reader expectations, we require that any story created with AI assistance be clearly labeled as such.</blockquote><p>Stories that don’t include an AI disclosure “will not be eligible for distribution to Medium’s network. Distribution will be restricted to a writer’s or publication’s followers.”</p><p>Although I’ve included such disclosures in some of my articles, I’d like to automate the inclusion of a message so I don’t omit them by accident.</p><h4>What about Grammarly?</h4><p>The guidelines are clear if using ChatGPT, but what about Grammarly? Its GrammarlyGo tool, which I <strong>don’t</strong> use, is AI-based. But what about its typical grammar and spell-checking interface? Although I haven’t found a clear answer to this question yet, I’m going to guess that it might use some AI-assistive technology in the recommendations it generates. (Please comment if you have any insights on this question!) Because of this possibility, and because I use Grammarly and ChatGPT similarly, I’ve decided to disclose both.</p><h4>A solution</h4><p>I recommend adding a disclosure to your ChatGPT custom instructions. For example:</p><blockquote>Include the following text at the end of every response: “(Disclosure: I ideate and draft content in a text editor, refine it with the aid of artificial intelligence tools like ChatGPT and Grammarly, and revise it to reflect my intended message.)”</blockquote><p>By automating the inclusion of this disclosure in my typical workflow, I’m much more likely to include it in the stories I publish.</p><p>(Disclosure: I ideate and draft content in a text editor, refine it with the aid of artificial intelligence tools like ChatGPT and Grammarly, and revise it to reflect my intended message.)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=27c319f0bed6" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Confirmation: Scenarios work!]]></title>
            <link>https://medium.com/@rolfedh/scenarios-do-work-870982701574?source=rss-c1a6f6fc96c5------2</link>
            <guid isPermaLink="false">https://medium.com/p/870982701574</guid>
            <category><![CDATA[ai]]></category>
            <category><![CDATA[technical-writing]]></category>
            <category><![CDATA[chatgpt]]></category>
            <category><![CDATA[writing]]></category>
            <dc:creator><![CDATA[Rolfe Dlugy-Hegwer]]></dc:creator>
            <pubDate>Sun, 23 Jul 2023 17:35:50 GMT</pubDate>
            <atom:updated>2023-07-29T19:26:48.650Z</atom:updated>
            <content:encoded><![CDATA[<p>Confirmation that scenarios work in ChatGPT custom instructions. Look at this!</p><p>Yesterday, I showed you <a href="https://medium.com/@rolfedh/say-goodbye-to-repetitive-chatgpt-prompts-and-hello-to-streamlined-conversations-aa730620da7a">example scenarios to use in ChatGPT</a> Custom Instructions. Today, I put them to the test:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/822/1*9OiH41ohm2ydXBdRsD6Srg.png" /></figure><p>ChatGPT clearly understands what I’m referring to, and its responses demonstrate that it understands the style each one requires. The Scenario A response is enthusiastic and conversational. The Scenario B response clear, direct, and formal. Perfect!</p><p>Tomorrow, I’ll test Scenario A and show you how to fine-tune the style for better results!</p><p>To find out more, <strong>please click the Follow button</strong>.</p><ul><li>You can also find a copy of this story at <a href="https://rolfe.blog/">rolfe.blog</a>.</li><li>CC BY 2.0: <a href="https://creativecommons.org/licenses/by/2.0/](https://creativecommons.org/licenses/by/2.0/](https://creativecommons.org/licenses/by/2.0/))">https://creativecommons.org/licenses/by/2.0/</a></li><li>Toolchain disclosure: I typically use Obsidian (<a href="https://obsidian.md/">https://obsidian.md/</a>) to draft content, ChatGPT (<a href="https://openai.com/blog/chatgpt">https://openai.com/blog/chatgpt</a>) to improve it, and Grammarly (<a href="https://www.grammarly.com/">https://www.grammarly.com/</a>) to copy edit it.</li><li>I welcome and value your comments, including ones that express differing viewpoints.</li><li>My writing reflects my views, not those of my employer.</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=870982701574" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Examples to get the most from ChatGPT custom instructions]]></title>
            <link>https://medium.com/@rolfedh/say-goodbye-to-repetitive-chatgpt-prompts-and-hello-to-streamlined-conversations-aa730620da7a?source=rss-c1a6f6fc96c5------2</link>
            <guid isPermaLink="false">https://medium.com/p/aa730620da7a</guid>
            <category><![CDATA[ai]]></category>
            <category><![CDATA[chatgpt]]></category>
            <category><![CDATA[writing]]></category>
            <category><![CDATA[technical-writing]]></category>
            <dc:creator><![CDATA[Rolfe Dlugy-Hegwer]]></dc:creator>
            <pubDate>Sat, 22 Jul 2023 19:28:16 GMT</pubDate>
            <atom:updated>2023-07-23T17:52:30.734Z</atom:updated>
            <content:encoded><![CDATA[<p>If you, like me, are tired of giving ChatGPT repetitive style instructions before each task, you’re in for a treat. With the latest feature, ‘Custom Instructions’, you can input your instructions once and apply them to all future sessions.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/588/1*Xx_vRljjSuLmJw1guFemjg.png" /></figure><h3>How to use Custom Instructions</h3><p>In my previous post, I <a href="https://medium.com/@rolfedh/using-chatgpt-custom-instructions-480ced6c5807">showed you the Custom Instructions settings</a>. Today, I’ll show you how I answered the questions for these settings.</p><p>Remember, these are just examples. Feel free to draw inspiration from them while crafting your unique responses.</p><h4>Question #1: “What would you like ChatGPT to know about you to provide better responses?”</h4><p>ChatGPT gives the following thought starters to help you answer this question.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/342/1*XXNmCGRJkQzsgpYzyDIqQw.png" /></figure><p>To these questions, I answered:</p><blockquote>I live in &lt;cityname, &lt;state&gt;, USA, and my worldview is colored by my travels and stays in several countries worldwide. My professional role as a Principal Technical Writer at &lt;companyname&gt; involves remote work with a global team. I’m passionate about non-fiction writing, particularly about ChatGPT, and I frequently publish on Medium.com. I also have an affinity for open-source technology. I strive to generate additional income from writing and publishing on platforms like Kindle and Audible. When interacting with me, I value a collaborative approach, appreciating insightful contributions to our discussions.</blockquote><h4>Question #2: “How would you like ChatGPT to respond?”</h4><p>And for this question, ChatGPT gives another set of thought starters.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/347/1*PvIBQRfPf5TTLuhOP01Nnw.png" /></figure><p>To these, I answered:</p><blockquote>When I prompt ChatGPT, I will specify one of the following scenarios. ChatGPT should apply the style rules of that one scenario from then on and ignore the other scenario.<br>Scenario A: For my writing tasks at Medium.com, Kindle, and Audible, ChatGPT should use everyday English, maintaining a warm and lighthearted tone. I appreciate ChatGPT’s insights and opinions in these contexts.<br>Scenario B: For my technical writing tasks at &lt;companyname&gt;, ChatGPT should use the following style guide:<br>- Be clear and direct, avoiding jargon.<br>- Maintain a formal, objective tone without personal opinions.<br>- Use the second person when addressing the reader.<br>- Focus on the present tense, avoiding the future tense.<br>- Use Asciidoc markup for formatting, not Markdown.<br>- Ensure instructions are actionable, especially concerning software changes.<br>- Use plain language — be clear, concise, and straightforward. Avoid complex terms.<br>- Use backticks (` `) for inline code and object names.<br>- Use sentence case for titles, not title case.<br>- Keep responses concise and essential, and provide actionable guidance.<br>- Avoid the subjunctive mood. Be clear and assertive.<br>- Omit ‘Please’ in instructions. Be direct.<br>- Favor everyday English over complex vocabulary.</blockquote><h4>But can it handle multiple scenarios?</h4><p>Like most authors, I use different styles of writing for different audiences. As you can see in my answer to Question #2, I’m testing whether I can get ChatGPT to change styles by specifying the scenario in my prompt.</p><p>Wouldn’t it be great if I could say, “For scenario B, generate a release note from the following text,” or “For scenario A, generate a blog post from the following notes”?</p><p>I’ll be testing this over the next few days and will get back to you with the results here:</p><ul><li>The next day’s story: <a href="https://medium.com/@rolfedh/scenarios-do-work-870982701574">Scenarios do work!</a></li></ul><p>To keep learning more, <strong>please click the Follow button</strong>.</p><ul><li>You can also find a copy of this story at <a href="https://rolfe.blog/">https://rolfe.blog/</a>.</li><li>CC BY 2.0: <a href="https://creativecommons.org/licenses/by/2.0/">https://creativecommons.org/licenses/by/2.0/</a></li><li>Toolchain disclosure: I typically use Obsidian to draft content, ChatGPT to improve it, and Grammarly to copy edit it.</li><li>I welcome and value your comments, including ones that express differing viewpoints.</li><li>My writing reflects my views, not those of my employer.</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=aa730620da7a" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Using ChatGPT custom instructions]]></title>
            <link>https://medium.com/@rolfedh/using-chatgpt-custom-instructions-480ced6c5807?source=rss-c1a6f6fc96c5------2</link>
            <guid isPermaLink="false">https://medium.com/p/480ced6c5807</guid>
            <category><![CDATA[ai]]></category>
            <category><![CDATA[chatgpt]]></category>
            <dc:creator><![CDATA[Rolfe Dlugy-Hegwer]]></dc:creator>
            <pubDate>Fri, 21 Jul 2023 11:08:24 GMT</pubDate>
            <atom:updated>2023-07-21T12:15:10.515Z</atom:updated>
            <content:encoded><![CDATA[<h3>Try out ChatGPT pro’s newest feature: custom instructions</h3><h3>Give ChatGPT persistent information about you and how you want it to reply</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/325/1*t7TjPxQjL594J2xU9pzHtg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/779/1*EIRYVty3NaLqBkAbos4sKg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/283/1*Cq8JtsK4ev4BTixe3aItcg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/949/1*SSTDz65EmW9fOOj7pmPNdA.png" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=480ced6c5807" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Revolutionize your release notes with ChatGPT]]></title>
            <description><![CDATA[<div class="medium-feed-item"><p class="medium-feed-image"><a href="https://medium.com/@rolfedh/revolutionize-your-release-notes-with-chatgpt-c91cc1d4a62b?source=rss-c1a6f6fc96c5------2"><img src="https://cdn-images-1.medium.com/max/2600/0*ZXB5ELmcwxJZGI2g" width="4000"></a></p><p class="medium-feed-snippet">Hello, fellow technical writers! It&#x2019;s time to add some AI power to our writing tools and turbocharge our release notes. If you&#x2019;ve ever&#x2026;</p><p class="medium-feed-link"><a href="https://medium.com/@rolfedh/revolutionize-your-release-notes-with-chatgpt-c91cc1d4a62b?source=rss-c1a6f6fc96c5------2">Continue reading on Medium »</a></p></div>]]></description>
            <link>https://medium.com/@rolfedh/revolutionize-your-release-notes-with-chatgpt-c91cc1d4a62b?source=rss-c1a6f6fc96c5------2</link>
            <guid isPermaLink="false">https://medium.com/p/c91cc1d4a62b</guid>
            <category><![CDATA[technical-writing]]></category>
            <category><![CDATA[ai]]></category>
            <category><![CDATA[release-notes]]></category>
            <dc:creator><![CDATA[Rolfe Dlugy-Hegwer]]></dc:creator>
            <pubDate>Fri, 21 Jul 2023 03:09:31 GMT</pubDate>
            <atom:updated>2023-07-21T03:09:31.864Z</atom:updated>
        </item>
        <item>
            <title><![CDATA[Me: 
If Shakespeare were alive, what would he say about ChatGPT — compose a sonnet.]]></title>
            <description><![CDATA[<div class="medium-feed-item"><p class="medium-feed-image"><a href="https://medium.com/@rolfedh/me-if-shakespeare-were-alive-what-would-he-say-about-chatgpt-compose-a-sonnet-b80e7855a78?source=rss-c1a6f6fc96c5------2"><img src="https://cdn-images-1.medium.com/max/2600/0*PVIbohkqNB0uDf_6" width="3172"></a></p><p class="medium-feed-snippet">ChatGPT:</p><p class="medium-feed-link"><a href="https://medium.com/@rolfedh/me-if-shakespeare-were-alive-what-would-he-say-about-chatgpt-compose-a-sonnet-b80e7855a78?source=rss-c1a6f6fc96c5------2">Continue reading on Medium »</a></p></div>]]></description>
            <link>https://medium.com/@rolfedh/me-if-shakespeare-were-alive-what-would-he-say-about-chatgpt-compose-a-sonnet-b80e7855a78?source=rss-c1a6f6fc96c5------2</link>
            <guid isPermaLink="false">https://medium.com/p/b80e7855a78</guid>
            <category><![CDATA[shakespeare]]></category>
            <category><![CDATA[aritificial-intelligence]]></category>
            <dc:creator><![CDATA[Rolfe Dlugy-Hegwer]]></dc:creator>
            <pubDate>Tue, 18 Jul 2023 22:48:24 GMT</pubDate>
            <atom:updated>2023-07-18T22:48:24.133Z</atom:updated>
        </item>
        <item>
            <title><![CDATA[Technical Writing and AI: A Tale of Tractors, Fields, and Fresh Beginnings]]></title>
            <description><![CDATA[<div class="medium-feed-item"><p class="medium-feed-image"><a href="https://medium.com/@rolfedh/technical-writing-and-ai-a-tale-of-tractors-fields-and-fresh-beginnings-3f4048986b96?source=rss-c1a6f6fc96c5------2"><img src="https://cdn-images-1.medium.com/max/1920/1*nNuzxxj28AS6LgM-Lbtotg.jpeg" width="1920"></a></p><p class="medium-feed-snippet">If life was a sitcom, we&#x2019;d be at that point in the episode where the character stares at a mirror, questioning their career choice. But&#x2026;</p><p class="medium-feed-link"><a href="https://medium.com/@rolfedh/technical-writing-and-ai-a-tale-of-tractors-fields-and-fresh-beginnings-3f4048986b96?source=rss-c1a6f6fc96c5------2">Continue reading on Medium »</a></p></div>]]></description>
            <link>https://medium.com/@rolfedh/technical-writing-and-ai-a-tale-of-tractors-fields-and-fresh-beginnings-3f4048986b96?source=rss-c1a6f6fc96c5------2</link>
            <guid isPermaLink="false">https://medium.com/p/3f4048986b96</guid>
            <category><![CDATA[future-of-work]]></category>
            <category><![CDATA[technical-writing]]></category>
            <category><![CDATA[artificial-intelligence]]></category>
            <dc:creator><![CDATA[Rolfe Dlugy-Hegwer]]></dc:creator>
            <pubDate>Sat, 15 Jul 2023 18:39:59 GMT</pubDate>
            <atom:updated>2023-07-16T20:19:11.942Z</atom:updated>
        </item>
        <item>
            <title><![CDATA[Creating a personal Red Hat Virtualization (oVirt) lab, part 1]]></title>
            <description><![CDATA[<div class="medium-feed-item"><p class="medium-feed-image"><a href="https://medium.com/@rolfedh/creating-a-personal-red-hat-virtualization-ovirt-lab-part-1-b680f1f8a866?source=rss-c1a6f6fc96c5------2"><img src="https://cdn-images-1.medium.com/max/2600/1*UjN-C_7TGbfio5iTSZthwA.jpeg" width="3024"></a></p><p class="medium-feed-snippet">This is my experience creating a personal computer lab for Red Hat Virtualization (RHV).</p><p class="medium-feed-link"><a href="https://medium.com/@rolfedh/creating-a-personal-red-hat-virtualization-ovirt-lab-part-1-b680f1f8a866?source=rss-c1a6f6fc96c5------2">Continue reading on Medium »</a></p></div>]]></description>
            <link>https://medium.com/@rolfedh/creating-a-personal-red-hat-virtualization-ovirt-lab-part-1-b680f1f8a866?source=rss-c1a6f6fc96c5------2</link>
            <guid isPermaLink="false">https://medium.com/p/b680f1f8a866</guid>
            <category><![CDATA[ovirt]]></category>
            <category><![CDATA[documentation]]></category>
            <category><![CDATA[technical-writing]]></category>
            <category><![CDATA[red-hat-training]]></category>
            <dc:creator><![CDATA[Rolfe Dlugy-Hegwer]]></dc:creator>
            <pubDate>Sat, 07 Mar 2020 22:50:48 GMT</pubDate>
            <atom:updated>2020-03-07T22:52:49.914Z</atom:updated>
        </item>
        <item>
            <title><![CDATA[Do you need tech writing experience? Write for one of these open source projects.]]></title>
            <link>https://medium.com/technical-writing-is-easy/do-you-need-tech-writing-experience-write-for-one-of-these-open-source-projects-14aa84de827b?source=rss-c1a6f6fc96c5------2</link>
            <guid isPermaLink="false">https://medium.com/p/14aa84de827b</guid>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[editing]]></category>
            <category><![CDATA[technical-writing]]></category>
            <category><![CDATA[jobs]]></category>
            <dc:creator><![CDATA[Rolfe Dlugy-Hegwer]]></dc:creator>
            <pubDate>Tue, 20 Aug 2019 13:43:22 GMT</pubDate>
            <atom:updated>2019-09-03T11:31:57.027Z</atom:updated>
            <content:encoded><![CDATA[<h3>Do you need tech writing experience? Write for one of these open-source projects</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*oT-ftfrBJ_BvmaZk2zumpg.jpeg" /><figcaption>Find a welcoming community of developers and users who need your writing skills!</figcaption></figure><p>Recently, I met an Uber driver with a degree in English and experience as a professional writer in Los Angeles who wants to transition into technical writing. She has the skills and smarts to do it, but needs several things to get hired:</p><ul><li>Experience working with software development teams</li><li>Knowledge of particular platforms and technologies</li><li>Doc tools experience</li><li>A portfolio of tech writing samples</li></ul><p>I recommended she start by contributing to open source projects; copyediting at first and creating content later. Most open-source projects welcome newcomers with the skills to improve existing content and document new capabilities.</p><blockquote><a href="https://github.com/darh">Denis Arh</a>, a contributor on the Corteza project, says “…this work is rarely paid but all contributions and contributors are public. And this makes it a very valuable CV/LinkedIn/Portfolio material.”</blockquote><p>Below, I’ve listed a handful of writer-friendly open-source projects. Reader, if you have any project recommendations, please comment and I’ll add them to the following list. <em>If you know a project team is looking for writers, tell me, and I’ll </em><strong><em>highlight it in bold italics</em></strong>.</p><p>If the thought of just showing up and making commits to a repo triggers imaginary scenarios where you’re being shunned for reason x, y, or z, keep in mind that many open-source projects have <a href="https://ovirt.org/community/about/community-guidelines.html">inclusive codes of conduct</a> and intentionally walk their talk in a variety of ways.</p><blockquote><a href="https://medium.com/@miaarh">Mia Arh</a>, VP of Services at Crust Technology and Director at Corteza Project says “I’m thrilled the <a href="https://cortezaproject.org/">Corteza project</a> is making a step towards fixing a problem of diversity in IT with a majority women in the <a href="https://cortezaproject.org/about/board-of-directors/">board of directors</a> and I’m excited to be part of the organization that truly breathes and lives its values.”</blockquote><h4>Contribute to these open source projects</h4><ul><li><a href="https://angular.io/">Angular</a> (<a href="https://github.com/angular/material2-docs-content">docs repo</a>) — build js apps for any deployment target</li><li><a href="http://mesos.apache.org/">Apache Mesos</a> (<a href="https://github.com/apache/mesos">docs repo</a>) — a distributed systems kernel</li><li><a href="https://cortezaproject.org/"><strong><em>Corteza</em></strong></a><strong><em> (</em></strong><a href="https://github.com/cortezaproject/corteza-docs"><strong><em>docs repo</em></strong></a><strong><em>) — an open-source alternative to Salesforce</em></strong></li><li><a href="https://docs.docker.com/">Docker</a> (<a href="https://github.com/docker/docker.github.io#contributing">docs_repo</a>) — a way to run applications securely isolated in a container, packaged with all its dependencies and libraries.</li><li><a href="https://www.fluentd.org/">Fluentd</a>(<a href="https://github.com/fluent/fluentd-docs-gitbook/tree/1.0">docs repo#1</a> <a href="https://github.com/fluent/fluent-bit-docs">docs repo#2</a>) — a fast and lightweight log processor and forwarder</li><li><a href="https://kubernetes.io/"><strong><em>Kubernetes</em></strong></a><strong><em> (</em></strong><a href="https://kubernetes.io/docs/contribute/"><strong><em>contribute</em></strong></a><strong><em>, </em></strong><a href="https://github.com/kubernetes/website"><strong><em>docs repo</em></strong></a><strong><em>) — automated container deployment, scaling, and management</em></strong></li></ul><h4>Other resources for becoming a tech writer</h4><ul><li><a href="https://www.writethedocs.org/">https://www.writethedocs.org</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=14aa84de827b" width="1" height="1" alt=""><hr><p><a href="https://medium.com/technical-writing-is-easy/do-you-need-tech-writing-experience-write-for-one-of-these-open-source-projects-14aa84de827b">Do you need tech writing experience? Write for one of these open source projects.</a> was originally published in <a href="https://medium.com/technical-writing-is-easy">Technical Writing is Easy</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>