Embed Notice

HTML Code

<blockquote style="position: relative; padding-left: 55px;"><section><a href="https://mastodon.scot/users/petealexharris/statuses/116022854855553688">Pete Alex Harris🦡🕸️🌲/∞🪐∫ (petealexharris@mastodon.scot)'s status on Friday, 06-Feb-2026 20:00:27 JST</a><a href="https://mastodon.scot/@petealexharris" title="petealexharris@mastodon.scot"><img src="https://gnusocial.jp/avatar/140912-48-20240409193615.webp" width="48" height="48" alt="Pete Alex Harris🦡🕸️🌲/∞🪐∫" style="position: absolute; left: 0; top: 0;">Pete Alex Harris🦡🕸️🌲/∞🪐∫</a><div><a href="https://techhub.social/@technicaladept/116022837415071385" rel="in-reply-to">in reply to</a><ul><li><li><a href="https://gnusocial.jp/user/101928" title="drahardja@sfba.social">Dave Rahardja</a></li><li><a href="https://gnusocial.jp/user/143118" title="blogdiva@mastodon.social">your auntifa liza 🇵🇷  🦛 🦦</a></li><li><a href="https://gnusocial.jp/user/224552" title="skyfire747@aus.social">Anthony 🇦🇺🦘🐨🪃🌟✨️🕯🏏🧩🎭🪁</a></li><li><a href="https://gnusocial.jp/user/327290" title="technicaladept@techhub.social">Matt Hardy 3.11 for Workgroups</a></li></ul></div></section><article><p><a href="https://techhub.social/@technicaladept">@technicaladept</a> <a href="https://frontrange.co/@raineer">@raineer</a> <a href="https://sfba.social/@drahardja">@drahardja</a> <a href="https://aus.social/@skyfire747">@skyfire747</a> <a href="https://nomenloony.com/@nomenloony">@nomenloony</a> <a href="https://mastodon.social/@blogdiva">@blogdiva</a> </p><p>No, a duplicate explanation of what the code is doing is not what comments are for.</p><p>Comments are more for "why" one method or choice than another, sometimes "why not",  than "what".</p><p>Except doc comments, which are closer to spec i.e. "what". The code itself is "how", and it doesn't necessarily come via a verbal description in natural language.</p></article><footer><a rel="bookmark" href="https://gnusocial.jp/conversation/6128689#notice-12070129">In conversation</a><time datetime="2026-02-06T20:00:27+09:00" title="Friday, 06-Feb-2026 20:00:27 JST">about a month ago</time> <span>from <span><a href="https://mastodon.scot/@petealexharris/116022854855553688" rel="external" title="Sent from mastodon.scot via ActivityPub">mastodon.scot</a></span></span><a href="https://mastodon.scot/@petealexharris/116022854855553688">permalink</a></footer></blockquote>

Corresponding Notice

Embed this notice
Pete Alex Harris🦡🕸️🌲/∞🪐∫ (petealexharris@mastodon.scot)'s status on Friday, 06-Feb-2026 20:00:27 JSTPete Alex Harris🦡🕸️🌲/∞🪐∫
in reply to
@technicaladept @raineer @drahardja @skyfire747 @nomenloony @blogdiva
No, a duplicate explanation of what the code is doing is not what comments are for.
Comments are more for "why" one method or choice than another, sometimes "why not", than "what".
Except doc comments, which are closer to spec i.e. "what". The code itself is "how", and it doesn't necessarily come via a verbal description in natural language.
In conversationabout a month ago from mastodon.scotpermalink

Public

Embed Notice

HTML Code

Corresponding Notice