<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<div class="moz-cite-prefix">Trampas, <br>
</div>
<div class="moz-cite-prefix"><br>
</div>
<div class="moz-cite-prefix">I agree simple is better than cute or
complicated. break up complicated code. let the compiler do
what it can with it to make it more efficient. Likely not a lot
different from the result of doing the 'cute' code.</div>
<div class="moz-cite-prefix"><br>
</div>
<div class="moz-cite-prefix">Scott, <br>
<br>
Documentation needs to cover the things that are not obvious. I
always write it to myself to explain it to myself in a few months
assuming I completely forgot why I did something the way i did. I
try and leave enough info for me and the next person out of
kindness :-)<br>
<br>
<br>
</div>
<div class="moz-cite-prefix"><br>
</div>
<div class="moz-cite-prefix">On 4/23/2022 12:09 PM, Scott Hall via
TriEmbed wrote:<br>
</div>
<blockquote type="cite"
cite="mid:CALOtY4P4BogXoFdfEdZEZQfd_Li+7nO77Tfo3jLrXYqHCZ7d_w@mail.gmail.com">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<div dir="ltr">
<div>Doxygen (<a href="https://www.doxygen.nl/index.html"
moz-do-not-send="true" class="moz-txt-link-freetext">https://www.doxygen.nl/index.html</a>)
was always my goto tool for code documentation, and help in
reverse engineering someone else's code (including my own
after a year or more) for altering or updating code. And it
has been around since the mid-1990's.</div>
<div><br>
</div>
<div>- sgh<br>
</div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Sat, Apr 23, 2022 at 11:33
AM Trampas Stern via TriEmbed <<a
href="mailto:triembed@triembed.org" moz-do-not-send="true"
class="moz-txt-link-freetext">triembed@triembed.org</a>>
wrote:<br>
</div>
<blockquote class="gmail_quote" style="margin:0px 0px 0px
0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<div dir="ltr">
<div>I have some rules which I follow with code, the number
1 rule is:</div>
<div><br>
</div>
<b>Code must be understandable by the next person.</b>
<div><br>
</div>
<div>If you need a tool to explain the code you have
failed. However if you are learning C and want to
understand the basics then it might be a good learning
tool. <br>
</div>
<div><br>
</div>
<div>Note I have the rule above and strive to meet it, but I
often fail. Seems the next guy is never as smart as I was,
especially when the next guy is me in a few days/months. </div>
<div><br>
</div>
<div>Trampas</div>
<div><br>
</div>
</div>
</blockquote>
</div>
</blockquote>
<br>
</body>
</html>