<h3>Contribution description</h3>
<p>This fixes several issues with the documentation of the <code>feather-nrf52840</code> documentation:</p>
<ul>
<li>malformed formatting of the shell commands</li>
<li>typo in requirements and missing info where to find them</li>
<li>missing commands in shell commands to let them run out of the box</li>
<li>out-dated doc on terminal</li>
</ul>

<h3>Testing procedure</h3>
<p>Compile documentation with <code>make doc</code>. The output should now look much nicer and contain much more information compared to the current doc.riot-os.org. Also try out the instructions. The <code>feather-nrf52840</code> should mount as a disk drive afterwards (for Arch and Fedora I needed to patch <code>dist/tools/uf2/uf2conv.py</code> to be able to flash:</p>
<div class="highlight highlight-source-diff position-relative" data-snippet-clipboard-copy-content="--- build/pkg/UF2/utils/uf2conv.py        2021-08-24 16:37:10.613961049 +0200
+++ dist/tools/uf2/uf2conv.py   2021-08-24 17:57:43.061182395 +0200
@@ -200,9 +200,13 @@
         if sys.platform == "darwin":
             rootpath = "/Volumes"
         elif sys.platform == "linux":
-            tmp = rootpath + "/" + os.environ["USER"]
+            tmp = os.path.join(rootpath, os.environ["USER"])
             if os.path.isdir(tmp):
                 rootpath = tmp
+            else:
+                tmp = os.path.join("/run/media", os.environ["USER"])
+                if os.path.isdir(tmp):
+                    rootpath = tmp
         for d in os.listdir(rootpath):
             drives.append(os.path.join(rootpath, d))
 
"><pre><span class="pl-md">--- build/pkg/UF2/utils/uf2conv.py     2021-08-24 16:37:10.613961049 +0200</span>
<span class="pl-mi1">+++ dist/tools/uf2/uf2conv.py      2021-08-24 17:57:43.061182395 +0200</span>
<span class="pl-mdr">@@ -200,9 +200,13 @@</span>
         if sys.platform == "darwin":
             rootpath = "/Volumes"
         elif sys.platform == "linux":
<span class="pl-md"><span class="pl-md">-</span>            tmp = rootpath + "/" + os.environ["USER"]</span>
<span class="pl-mi1"><span class="pl-mi1">+</span>            tmp = os.path.join(rootpath, os.environ["USER"])</span>
             if os.path.isdir(tmp):
                 rootpath = tmp
<span class="pl-mi1"><span class="pl-mi1">+</span>            else:</span>
<span class="pl-mi1"><span class="pl-mi1">+</span>                tmp = os.path.join("/run/media", os.environ["USER"])</span>
<span class="pl-mi1"><span class="pl-mi1">+</span>                if os.path.isdir(tmp):</span>
<span class="pl-mi1"><span class="pl-mi1">+</span>                    rootpath = tmp</span>
         for d in os.listdir(rootpath):
             drives.append(os.path.join(rootpath, d))
 </pre></div>
<p>((question is: does it make sense to push this patch upstream... the tool does not look like it was written by someone with a whole lot of knowledge about Linux...)</p>

<h3>Issues/PRs references</h3>
<p>Follow-up on <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="849743779" data-permission-text="Title is private" data-url="https://github.com/RIOT-OS/RIOT/issues/16276" data-hovercard-type="pull_request" data-hovercard-url="/RIOT-OS/RIOT/pull/16276/hovercard" href="https://github.com/RIOT-OS/RIOT/pull/16276">#16276</a></p>


<hr>

<h4>You can view, comment on, or merge this pull request online at:</h4>
<p>  <a href='https://github.com/RIOT-OS/RIOT/pull/16777'>https://github.com/RIOT-OS/RIOT/pull/16777</a></p>

<h4>Commit Summary</h4>
<ul>
  <li>boards/feather-nrf52840: fix typo and link where to get `nrfjprog` tool</li>
  <li>boards/feather-nrf52840: fix shell command formatting in doc</li>
  <li>boards/feather-nrf52840: add missing commands for uf2 instructions</li>
  <li>boards/feather-nrf52840: update terminal doc for current status quo</li>
</ul>

<h4>File Changes</h4>
<ul>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/16777/files#diff-e78fb07faac207dfbbf064f7b53cc25b8e8512e298c4c98f4baae8e2e87fa0d5">boards/feather-nrf52840/doc.txt</a>
    (31)
  </li>
</ul>

<h4>Patch Links:</h4>
<ul>
  <li><a href='https://github.com/RIOT-OS/RIOT/pull/16777.patch'>https://github.com/RIOT-OS/RIOT/pull/16777.patch</a></li>
  <li><a href='https://github.com/RIOT-OS/RIOT/pull/16777.diff'>https://github.com/RIOT-OS/RIOT/pull/16777.diff</a></li>
</ul>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/RIOT-OS/RIOT/pull/16777">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/ABE7WYDOGPHLXEI6XGTH4I3T6PALDANCNFSM5CXFXNHA">unsubscribe</a>.<br />Triage notifications on the go with GitHub Mobile for <a href="https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675">iOS</a> or <a href="https://play.google.com/store/apps/details?id=com.github.android&utm_campaign=notification-email">Android</a>.<img src="https://github.com/notifications/beacon/ABE7WYHSFF4D6MA3OIM5C23T6PALDA5CNFSM5CXFXNHKYY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4OSPE5GA.gif" height="1" width="1" alt="" /></p>
<script type="application/ld+json">[
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ViewAction",
"target": "https://github.com/RIOT-OS/RIOT/pull/16777",
"url": "https://github.com/RIOT-OS/RIOT/pull/16777",
"name": "View Pull Request"
},
"description": "View this Pull Request on GitHub",
"publisher": {
"@type": "Organization",
"name": "GitHub",
"url": "https://github.com"
}
}
]</script>