https://wiki.softwareheritage.org/index.php?action=history&feed=atom&title=Google_Season_of_Docs_2021 2026-04-22T05:08:06Z Revision history for this page on the wiki MediaWiki 1.39.10 https://wiki.softwareheritage.org/index.php?title=Google_Season_of_Docs_2021&diff=1576&oldid=prev 2021-06-15T07:30:50Z

<p><span dir="auto"><span class="autocomment">Contact: </span> freenode -&gt; libera</span></p> <table style="background-color: #fff; color: #202122;" data-mw="interface"> <col class="diff-marker" /> <col class="diff-content" /> <col class="diff-marker" /> <col class="diff-content" /> <tr class="diff-title" lang="en"> <td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td> <td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 07:30, 15 June 2021</td> </tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l56">Line 56:</td> <td colspan="2" class="diff-lineno">Line 56:</td></tr> <tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>GSoD applicants are encouraged to get in touch with the Software Heritage community using the standard development communication channels, i.e.:</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>GSoD applicants are encouraged to get in touch with the Software Heritage community using the standard development communication channels, i.e.:</div></td></tr> <tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr> <tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>* the #swh-devel IRC channel on [https://<del style="font-weight: bold; text-decoration: none;">freenode</del>.<del style="font-weight: bold; text-decoration: none;">net Freenode</del>]</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>* the #swh-devel IRC channel on [https://<ins style="font-weight: bold; text-decoration: none;">libera</ins>.<ins style="font-weight: bold; text-decoration: none;">chat/ Libera Chat</ins>]</div></td></tr> <tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* the [https://sympa.inria.fr/sympa/info/swh-devel swh-devel mailing list]</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* the [https://sympa.inria.fr/sympa/info/swh-devel swh-devel mailing list]</div></td></tr> <tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr> </table>

StefanoZacchiroli https://wiki.softwareheritage.org/index.php?title=Google_Season_of_Docs_2021&diff=1531&oldid=prev 2021-03-15T14:34:39Z

<p>Create 2021 GSoD page</p> <p><b>New page</b></p><div>[[File:GSoDLogo.png|800px]]<br /> <br /> == General information ==<br /> <br /> This page is the central point of information for [[Software Heritage]] participation into the [https://developers.google.com/season-of-docs/ Google Season of Docs] program.<br /> <br /> Google Season of Docs is a program where Google pays technical writers stipends to work on free software projects such as Software Heritage. Each writer works with mentors from the community to complete a documentation project.<br /> <br /> == I want to participate as a technical writer ==<br /> <br /> Great!, we are very glad for your interest in contributing to Software Heritage and we are looking forward to work together.<br /> <br /> === Prerequisites ===<br /> <br /> The following prerequisites apply to Software Heritage GSoD projects:<br /> <br /> * [http://www.sphinx-doc.org/ Sphinx] is our documentation system of choice, you should be familiar with it to apply. In particular, we generally use reStructuredText markup and (for API references) Python docstrings with the [https://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html Napoleon style]<br /> * [https://git-scm.com Git] is our version control system of choice, you should be familiar with it to apply<br /> * additional prerequisites depend on the project you will work on; check project descriptions for details<br /> <br /> === Before you apply ===<br /> <br /> Here are the steps you should follow before applying, to make sure you have a general idea of the current state of Software Heritage technical documentation:<br /> <br /> * Learn about our project via our [https://www.softwareheritage.org/ main website] and the actual [https://archive.softwareheritage.org/ source code archive]<br /> * Check out the index of our [https://www.softwareheritage.org/community/developers/ resources for developers]<br /> * In particular make sure to have a look at:<br /> ** our [https://wiki.softwareheritage.org/ public wiki]<br /> ** our [https://docs.softwareheritage.org/devel/ documentation index]<br /> * Technical setup:<br /> ** Create an account on our [https://forge.softwareheritage.org development forge]<br /> ** Familiarize yourself with our [[Code review in Phabricator|code review workflow]]<br /> ** Make a simple change to the documentation of any one of our [https://docs.softwareheritage.org/devel/ software components] and submit it as a [https://forge.softwareheritage.org/differential/ diff] for code review, following the above workflow. Feel free to submit any patch you think it might be useful.<br /> <br /> === What to include in your application ===<br /> <br /> Make sure that your application includes the following information:<br /> <br /> * Describe the '''specific project''' you want to work on. What do you want to achieve? Why is it important? Why is it useful for Software Heritage? The project might be one of the project ideas that we have prepared below, or something else entirely that you want to contribute to Software Heritage. Your pet peeve, surprise us!<br /> * Detail your '''work plan''': a brief description of how you plan to go about your project, including a list of ''deliverables'' and a ''timeline'' of when do you expect them to be available.<br /> * Include a reference to '''the diff''' you submitted before applying (see the &quot;Before you apply&quot; section above).<br /> <br /> == Ideas list ==<br /> <br /> Below you can find a list of project ideas that are good options for a<br /> reasonably sized GSoD project. They are just suggestion though, don't feel<br /> obliged to pick one of them if there is nothing that fits your taste and<br /> abilities. Feel free to propose something else that you are excited about and<br /> that contributes to improve the Software Heritage documentation: we will be<br /> happy to consider it!<br /> <br /> TBD<br /> <br /> == Contact ==<br /> <br /> GSoD applicants are encouraged to get in touch with the Software Heritage community using the standard development communication channels, i.e.:<br /> <br /> * the #swh-devel IRC channel on [https://freenode.net Freenode]<br /> * the [https://sympa.inria.fr/sympa/info/swh-devel swh-devel mailing list]<br /> <br /> See our [https://www.softwareheritage.org/community/developers/ development information page] for more details.<br /> <br /> == Timeline ==<br /> <br /> See the official [https://developers.google.com/season-of-docs/docs/timeline Google Season of Docs timeline].<br /> <br /> [[Category:Google Season of Docs]]</div>

Morane