{"id":7597,"date":"2024-10-20T02:00:00","date_gmt":"2024-10-20T06:00:00","guid":{"rendered":"https:\/\/www.both.org\/?p=7597"},"modified":"2024-10-17T11:28:51","modified_gmt":"2024-10-17T15:28:51","slug":"celebrating-technical-writing-with-open-source-software","status":"publish","type":"post","link":"https:\/\/www.both.org\/?p=7597","title":{"rendered":"Celebrating technical writing with open source software"},"content":{"rendered":"<div class=\"pld-like-dislike-wrap pld-template-1\">\r\n    <div class=\"pld-like-wrap  pld-common-wrap\">\r\n    <a href=\"javascript:void(0)\" class=\"pld-like-trigger pld-like-dislike-trigger  \" title=\"\" data-post-id=\"7597\" data-trigger-type=\"like\" data-restriction=\"cookie\" data-already-liked=\"0\">\r\n                        <i class=\"fas fa-thumbs-up\"><\/i>\r\n                <\/a>\r\n    <span class=\"pld-like-count-wrap pld-count-wrap\">    <\/span>\r\n<\/div><\/div>\n<p class=\"wp-block-paragraph\">At Both.org, we want to share your stories about using and creating open source software. October 20 is the National Day of Writing, and what a great opportunity to celebrate technical writing using open source software.&nbsp;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To highlight writing with and writing about open source software, writers and editors across open source communities joined a roundtable &#8220;panel&#8221; discussion about how they use open source software in their writing process. The panel from 2023 included Both.org writers Don Watkins and Chris Hermansen, Lauren Maffeo (author), Lauren Pritchett (editor), and Jim Hall (editor, Technically We Write).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Topics ranged from how we first started writing about open source software, to what open source tools we use in our writing. Here are a few highlights from the discussion:<\/p>\n\n\n\n<div class=\"wp-block-group has-global-padding is-layout-constrained wp-block-group-is-layout-constrained\">\n<p class=\"wp-block-paragraph\"><strong>How did you get started writing about open source software?<\/strong> Most panelists started by joining an open source community. Writing our first &#8220;how-to&#8221; article about using open source software was our &#8220;gateway&#8221; to a love of writing.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>What open source tools do you use for your writing?<\/strong> We use several open source tools, including Markdown and LibreOffice.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>What advice would you give to someone who wants to get started in writing about open source software?<\/strong> One theme from this discussion was don&#8217;t overthink it. If you find the topic interesting, others will too.\u00a0<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>How can people write about open source software?<\/strong> We highlighted how to write about open source software. Pick a topic you are interested in, and write about it.\u00a0<\/p>\n<\/div>\n\n\n\n<figure class=\"wp-block-embed aligncenter is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"Technical Writing and Open Source Software (panel discussion)\" width=\"640\" height=\"360\" src=\"https:\/\/www.youtube.com\/embed\/NGh8ZluxMZc?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Both.org welcomes all articles about open source software. We welcome everyone to share an article, and open source software writing tools are a great place to start. For example, you might download LibreOffice and write an article about &#8220;I tried LibreOffice for the first time, here are 3 things I learned how to do over a weekend.&#8221;\u00a0Join the community and share your first article with us! We\u2019re looking for ideas or articles on open source software, hardware open culture, and open knowledge. Click the link to <a href=\"https:\/\/www.both.org\/?page_id=3286\">Write for us<\/a> to get started.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>This article is adapted from <a href=\"https:\/\/opensource.net\/get-started-with-technical-writing\/\">Get started with technical writing<\/a> by Jim Hall, and is republished on Both.org by the author.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Celebrate the National Day on Writing by sharing your first article about open source software.<\/p>\n","protected":false},"author":33,"featured_media":2813,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_lmt_disableupdate":"","_lmt_disable":"","footnotes":""},"categories":[157,158],"tags":[179,303],"class_list":["post-7597","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-community","category-open-source","tag-technical-writing","tag-writing"],"modified_by":"David Both","_links":{"self":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/7597","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/users\/33"}],"replies":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=7597"}],"version-history":[{"count":1,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/7597\/revisions"}],"predecessor-version":[{"id":7598,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/7597\/revisions\/7598"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/media\/2813"}],"wp:attachment":[{"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=7597"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=7597"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=7597"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}