{"id":73001,"date":"2023-04-28T09:00:39","date_gmt":"2023-04-28T09:00:39","guid":{"rendered":"https:\/\/www.cryptocabaret.com\/?p=73001"},"modified":"2023-04-28T09:00:39","modified_gmt":"2023-04-28T09:00:39","slug":"3-reasons-to-host-a-docathon-for-your-open-source-project","status":"publish","type":"post","link":"https:\/\/www.cryptocabaret.com\/?p=73001","title":{"rendered":"3 reasons to host a docathon for your open source project"},"content":{"rendered":"<p><span class=\"field field--name-title field--type-string field--label-hidden\">3 reasons to host a docathon for your open source project<\/span><br \/>\n<span class=\"field field--name-uid field--type-entity-reference field--label-hidden\"><a title=\"View user profile.\" href=\"https:\/\/opensource.com\/users\/lmalivert\" class=\"username\">lmalivert<\/a><\/span><br \/>\n<span class=\"field field--name-created field--type-created field--label-hidden\">Fri, 04\/28\/2023 &#8211; 03:00<\/span><\/p>\n<div class=\"clearfix text-formatted field field--name-body field--type-text-with-summary field--label-hidden field__item\">\n<p>Your open source project&#8217;s documentation is essential to your customers. Your target audience must understand the purpose of your project and how to use it, and documentation is what bridges that gap. A project is rarely ever truly done, so it&#8217;s equally important for resources to be maintained and updated with your project&#8217;s continuous improvement.<\/p>\n<p>But what happens when you have lots of documentation to maintain but lack the resources to keep it current? The answer is pretty simple: Host a docathon!<\/p>\n<h2>What is a docathon?<\/h2>\n<p>A docathon is like a hackathon. A hackathon is an event where engineers and community leaders gather to improve or add new features to an existing application. In a docathon, the same kind of collaboration focuses on improving documentation.<\/p>\n<p><strong>[ Learn about writing\u00a0<a href=\"https:\/\/opensource.com\/article\/22\/10\/docs-as-code\" target=\"_blank\" rel=\"noopener\">Docs as Code<\/a>. ]<\/strong><\/p>\n<p>A docathon can fill gaps within content, restructure large documentation sets, fix broken links, or just correct typos. The intent behind hosting a docathon is to improve a large amount of documentation in a relatively brief timeframe.<\/p>\n<p>Some examples of product documentation include:<\/p>\n<ul>\n<li>Training manuals<\/li>\n<li>User manuals<\/li>\n<li>Installation guides<\/li>\n<li>Troubleshooting guides<\/li>\n<li>Quickstart guides<\/li>\n<li><a href=\"https:\/\/www.redhat.com\/en\/topics\/api\/what-are-application-programming-interfaces?intcmp=7013a000002qLH8AAM\" target=\"_blank\" rel=\"noopener\">API<\/a> documentation<\/li>\n<li>Tutorials<\/li>\n<\/ul>\n<p>At my organization, our documentation team hosted a docathon and successfully revamped a 102-page installation guide. The docathon enabled us to focus on the project&#8217;s scope, which was reorganizing for simplicity, removing duplicate content, and following the customer journey. Hosting a docathon left a lasting impression on my team and improved customer success.<\/p>\n<p><strong>[ Read\u00a0<a href=\"https:\/\/opensource.com\/article\/23\/3\/community-documentation\" target=\"_blank\" rel=\"noopener\">Write documentation that actually works for your community<\/a> ]<\/strong><\/p>\n<h2>3 things you can achieve with a docathon<\/h2>\n<p>Here are my top three reasons to host a docathon:<\/p>\n<h3>1. No more backlog<\/h3>\n<p>Most documentation must evolve along with the product it supports. As the product changes or updates, so must the documentation. In some cases, documentation teams release new versions of their documentation alongside the engineering team&#8217;s release cycle. As priorities within a team change and <a href=\"https:\/\/opensource.com\/article\/19\/7\/what-golden-image\" target=\"_blank\" rel=\"noopener\">GA releases<\/a> continue, documentation teams face the challenge of keeping up with new features, bug fixes, and tasks to complete. The changes that get left behind become part of a backlog\u2014an accumulation of work that needs to be completed at a later time.<\/p>\n<blockquote>\n<p><strong>Docathon tip:\u00a0<\/strong>During a docathon, participants can triage backlog items and complete them as they progress through the list. Non-technical participants can work on fixes related to typos, broken links, and other text-related issues.<\/p>\n<\/blockquote>\n<div class=\"callout-float-right embedded-resource-list\" data-analytics-region=\"sidebar\">\n<div class=\"field field--name-title field--type-string field--label-hidden field__item\">Our favorite resources about open source<\/div>\n<div class=\"field field--name-links field--type-link field--label-hidden field__items\">\n<div class=\"field__item\"><a href=\"https:\/\/opensource.com\/downloads\/cheat-sheet-git?intcmp=7016000000127cYAAQ\" data-analytics-category=\"resource list\" data-analytics-text=\"Git cheat sheet\">Git cheat sheet<\/a><\/div>\n<div class=\"field__item\"><a href=\"https:\/\/developers.redhat.com\/cheat-sheets\/advanced-linux-commands\/?intcmp=7016000000127cYAAQ\" data-analytics-category=\"resource list\" data-analytics-text=\"Advanced Linux commands cheat sheet\">Advanced Linux commands cheat sheet<\/a><\/div>\n<div class=\"field__item\"><a href=\"https:\/\/opensource.com\/tags\/alternatives?intcmp=7016000000127cYAAQ\" data-analytics-category=\"resource list\" data-analytics-text=\"Open source alternatives\">Open source alternatives<\/a><\/div>\n<div class=\"field__item\"><a href=\"https:\/\/www.redhat.com\/en\/services\/training\/rh024-red-hat-linux-technical-overview?intcmp=7016000000127cYAAQ\" data-analytics-category=\"resource list\" data-analytics-text=\"Free online course: RHEL technical overview\">Free online course: RHEL technical overview<\/a><\/div>\n<div class=\"field__item\"><a href=\"https:\/\/console.redhat.com\/?intcmp=7016000000127cYAAQ\" data-analytics-category=\"resource list\" data-analytics-text=\"Register for your free Red Hat account\">Register for your free Red Hat account<\/a><\/div>\n<div class=\"field__item\"><a href=\"https:\/\/opensource.com\/downloads\/cheat-sheets?intcmp=7016000000127cYAAQ\" data-analytics-category=\"resource list\" data-analytics-text=\"Check out more cheat sheets\">Check out more cheat sheets<\/a><\/div>\n<\/p><\/div>\n<\/p><\/div>\n<h3>2. Revamp large-scale guides<\/h3>\n<p>By the time your documentation team realizes it&#8217;s time to revamp a guide, it&#8217;s probably several chapters in and hundreds of pages deep. Once the content plan has been developed, the complexity of restructuring begins. Restructuring a large amount of documentation is not for the faint of heart.<\/p>\n<blockquote>\n<p><strong>Docathon tip:<\/strong>\u00a0Assemble a team to lead the docathon and provide incentives for organization-wide participation from different teams or departments. Depending on the scope of work and time constraints, your team can successfully restructure an entire guide in less time than you probably expect.<\/p>\n<\/blockquote>\n<h3>3. Collaboration between cross-functional teams<\/h3>\n<p>It is common for different groups within an organization to work in isolation. Engineering, product, customer support, marketing, and documentation teams may not collaborate on projects as often as they should.<\/p>\n<p>Imagine hosting an event where each team member can use their expertise to improve product documentation. Docathons foster subject matter expert (SME) diversity, real-time collaboration, and communication. They also allow for an inclusive environment where individuals residing in different geographical locations can participate in person or remotely. Your documentation receives the undivided attention of experts with different viewpoints and specializations, minimizing isolated siloes, unconscious bias, and burnout.<\/p>\n<blockquote>\n<p><strong>Docathon tip:<\/strong>\u00a0Enable cross-functional teams to come together for a common cause.<\/p>\n<\/blockquote>\n<p><strong>[ Learn what it takes to <a href=\"https:\/\/www.redhat.com\/en\/resources\/build-a-resilient-it-culture-ebook?intcmp=7013a000002qLH8AAM\" target=\"_blank\" rel=\"noopener\">build a resilient IT culture<\/a> ]<\/strong><\/p>\n<h2>Documentation marathon<\/h2>\n<p>The next time your team has a seemingly insurmountable backlog or is tasked with restructuring a huge documentation project, consider hosting a docathon. It&#8217;s easy, and its productivity may surprise you. For more information on hosting an event like this, read Tiffany Long&#8217;s excellent <a href=\"https:\/\/opensource.com\/downloads\/hackathon-guide?intcmp=7013a000002qLH8AAM\" target=\"_blank\" rel=\"noopener\">10-step guide to hosting a hackathon<\/a>.<\/p>\n<\/div>\n<div class=\"clearfix text-formatted field field--name-field-article-subhead field--type-text-long field--label-hidden field__item\">\n<p>A marathon for documentation is a great way to produce or improve the docs for your open source project.<\/p>\n<\/div>\n<div class=\"field field--name-field-lead-image field--type-entity-reference field--label-hidden field__item\">\n<article class=\"media media--type-image media--view-mode-caption\">\n<div class=\"field field--name-field-media-image field--type-image field--label-hidden field__item\">  <img decoding=\"async\" loading=\"lazy\" src=\"https:\/\/www.cryptocabaret.com\/wp-content\/uploads\/2023\/04\/files_documents_paper_folder-1.png\" width=\"1041\" height=\"584\" alt=\"Files in a folder\" title=\"Files in a folder\"><\/div>\n<\/article>\n<\/div>\n<div class=\"field field--name-field-tags field--type-entity-reference field--label-hidden field__items\">\n<div class=\"field__item\"><a href=\"https:\/\/opensource.com\/tags\/documentation\" hreflang=\"en\">Documentation<\/a><\/div>\n<div class=\"field__item\"><a href=\"https:\/\/opensource.com\/tags\/conferences-and-events\" hreflang=\"en\">Conferences and events<\/a><\/div>\n<\/p><\/div>\n<div class=\"field field--name-field-listicle-title field--type-string field--label-hidden field__item\">What to read next<\/div>\n<div class=\"field field--name-field-listicles field--type-entity-reference field--label-hidden field__items\">\n<div class=\"field__item\"><a href=\"https:\/\/opensource.com\/article\/22\/8\/writing-project-documentation-html\" hreflang=\"en\">Writing project documentation in HTML<\/a><\/div>\n<div class=\"field__item\"><a href=\"https:\/\/opensource.com\/article\/22\/12\/dynamic-documentation-javascript\" hreflang=\"en\">Improve your documentation with JavaScript<\/a><\/div>\n<div class=\"field__item\"><a href=\"https:\/\/opensource.com\/article\/22\/12\/markup-languages-documentation\" hreflang=\"en\">Our favorite markup languages for documentation<\/a><\/div>\n<\/p><\/div>\n<div class=\"field field--name-field-default-license field--type-list-string field--label-hidden field__item\"><a rel=\"license\" href=\"http:\/\/creativecommons.org\/licenses\/by-sa\/4.0\/\"><br \/>\n        <img decoding=\"async\" alt=\"Creative Commons License\" src=\"https:\/\/www.cryptocabaret.com\/wp-content\/uploads\/2023\/04\/cc-by-sa--42.png\" title=\"This work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License.\"><\/a>This work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License.<\/div>\n<section class=\"field field--name-field-comments field--type-comment field--label-hidden comment-wrapper\">\n<div class=\"comments__count\">\n<div class=\"login\"><a href=\"https:\/\/opensource.com\/user\/register?absolute=1\">Register<\/a> or <a href=\"https:\/\/opensource.com\/user\/login?current=\/feed&amp;absolute=1\">Login<\/a> to post a comment.<\/div>\n<\/p><\/div>\n<\/section>\n<p class=\"wpematico_credit\"><small>Powered by <a href=\"http:\/\/www.wpematico.com\" target=\"_blank\" rel=\"noopener\">WPeMatico<\/a><\/small><\/p>\n","protected":false},"excerpt":{"rendered":"<p>3 reasons to host a docathon for your open source project lmalivert Fri, 04\/28\/2023 &#8211; 03:00 Your open source project&#8217;s documentation is essential to your customers. Your target audience must understand the purpose of your project and how to use it, and documentation is what bridges that gap. A project is rarely ever truly done, [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":73002,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[307],"tags":[],"class_list":["post-73001","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-open-source"],"_links":{"self":[{"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/posts\/73001","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=73001"}],"version-history":[{"count":0,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/posts\/73001\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/media\/73002"}],"wp:attachment":[{"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=73001"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=73001"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=73001"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}