<div>Yep.</div>
<div> </div>
<div>I have come to the conclussion, esp being aware that others will often be maintaining my code in the future, that I should look to committing myself to having a help file writer open while I code, and both better comment my code, and add references pointing to the help file, where useful info may be found.
</div>
<div>Then include the developer's CHM helpfile as a resource in the exe and provide a menuitem in help for getting it onto hard drive (if not present already) and opened up. </div>
<div> </div>
<div>A small ask on me really compared to the headaches that someone else may end up with.</div>
<div> </div>
<div>paul<br> </div>
<div><span class="gmail_quote">On 05/05/06, <b class="gmail_sendername">Kyley Harris</b> <<a href="mailto:kyley@harrissoftware.com">kyley@harrissoftware.com</a>> wrote:</span>
<blockquote class="gmail_quote" style="PADDING-LEFT: 1ex; MARGIN: 0px 0px 0px 0.8ex; BORDER-LEFT: #ccc 1px solid">You beat me to it. I agree with most of John's statements about headers<br>etc. and why you cant trust source control unless you will stick with it
<br>for life on the same system.<br><br>But Superb Programmer? Perhaps you meant Intelligent Person? There are<br>plenty of Geniuses, engineers, mathematicians etc, who all code because<br>it helps their other jobs. Programming is a role itself, that does not
<br>require skills in all these other areas. A Suberb programmer should in<br>the least:<br><br>Write clean consistent code.<br>Write self documenting code.<br>Also write supplementary comments regarding complex self-documenting
<br>code.<br>Understand the goal, before starting the task.<br><br>A Suberb programmer, does not need to know maths etc. This is all<br>available in books and specs. A Suberb programmer knows how to take all<br>the bits and pieces and turn it into maintainable, clean, bug free
<br>software. I am guessing that most Delphi group people are a mixture of<br>Programmer, Self-manager, etc. Not everyone works corporate. But its<br>important to distinguish the skill of programming, aside from the skills
<br>of other mixed roles.<br><br>-----Original Message-----<br>From: <a href="mailto:delphi-bounces@ns3.123.co.nz">delphi-bounces@ns3.123.co.nz</a> [mailto:<a href="mailto:delphi-bounces@ns3.123.co.nz">delphi-bounces@ns3.123.co.nz
</a>]<br>On Behalf Of Todd Martin<br>Sent: Friday, 5 May 2006 3:49 p.m.<br>To: <a href="mailto:johnkbird@paradise.net.nz">johnkbird@paradise.net.nz</a>; NZ Borland Developers Group - Delphi List<br>Subject: Re: [DUG] Naming your code
<br><br>I assume you're joking. That's not my idea of 'superb programming'.<br><br>> The extreme example was one package where the variables had different<br>names<br>> and declarations from one program to another, the programmer concerned
<br>wrote<br>> not one single comment in his code, and liked naming variables with<br>names<br>> like B320 B330 B340 etc. He was a superb programmer who believed code<br>> should be read to find what it does, and also liked reading object
<br>files<br>> directly.....if you are lucky you wouldn't be maintaining his code, it<br>was<br>> hard to improve in all senses.<br>><br>> John<br>><br>><br>> -----Original Message-----<br>> From:
<a href="mailto:delphi-bounces@ns3.123.co.nz">delphi-bounces@ns3.123.co.nz</a><br>[mailto:<a href="mailto:delphi-bounces@ns3.123.co.nz">delphi-bounces@ns3.123.co.nz</a>]<br>On<br>> Behalf Of Richard Vowles<br>> Sent: Friday, 5 May 2006 12:53
p.m.<br>> To: NZ Borland Developers Group - Delphi List<br>> Subject: RE: [DUG] Naming your code<br>><br>><br>> It should be in the version control check-in anyway so you know who to<br>> blame. The only reason it isn't in my code is I can't be bothered
<br>putting<br>it<br>> there. It is there on templated code.<br>><br>> (a dedicated subversion user).<br>><br>> How about people change subject lines to match what we are talking<br>about.<br>> ---<br>> Richard Vowles, Solutions Architect, Borland New Zealand
<br>> email: <a href="mailto:richard.vowles@borland.com">richard.vowles@borland.com</a><br>> phone: +64-9-9184573<br>> cell: +64-21-467747<br>> other: MSN <a href="mailto:richard.vowles@borland.com">richard.vowles@borland.com
</a>, skype: rvowles<br>> blog: <a href="http://www.usergroup.org.nz/blogs/selectBlog.html?id=39769">http://www.usergroup.org.nz/blogs/selectBlog.html?id=39769</a><br>><br>> -----Original Message-----<br>> From:
<a href="mailto:delphi-bounces@ns3.123.co.nz">delphi-bounces@ns3.123.co.nz</a><br>[mailto:<a href="mailto:delphi-bounces@ns3.123.co.nz">delphi-bounces@ns3.123.co.nz</a>]<br>> On Behalf Of Kyley Harris<br>> Sent: Thursday, 4 May 2006 11:42
p.m.<br>> To: NZ Borland Developers Group - Delphi List<br>> Subject: RE: [DUG] In case you're interested (or buy stuff)<br>><br>> Correct. Many companies that rely on contractors to fulfill work do<br>not<br>
want<br>> temp employess, etc to see a name, and go tell the competition who<br>they<br>> should contact for good design work. So in that case it is valid to<br>request<br>> unsigned work. If you really want to assert that you wrote something.
<br>Get<br>a<br>> reference in writing on letterhead that cannot be disputed by future<br>> managers, employees etc. Get the letter to state unequivocally what<br>input<br>> you had such as design, implementation, delployment. NEVER rely on an
<br>> interviewer calling someone. I make a point of providing no verbal<br>> references unless that person giving the ref would die for me, or<br>close :D<br>><br>> _______________________________________________
<br>> Delphi mailing list<br>> <a href="mailto:Delphi@ns3.123.co.nz">Delphi@ns3.123.co.nz</a> <a href="http://ns3.123.co.nz/mailman/listinfo/delphi">http://ns3.123.co.nz/mailman/listinfo/delphi</a><br>><br>><br>
> __________ NOD32 1.1461 (20060329) Information __________<br>><br>> This message was checked by NOD32 antivirus system.<br><a href="http://www.eset.com">http://www.eset.com</a><br>><br>><br>><br>> _______________________________________________
<br>> Delphi mailing list<br>> <a href="mailto:Delphi@ns3.123.co.nz">Delphi@ns3.123.co.nz</a><br>> <a href="http://ns3.123.co.nz/mailman/listinfo/delphi">http://ns3.123.co.nz/mailman/listinfo/delphi</a><br>><br>
><br>><br>> --<br>> No virus found in this incoming message.<br>> Checked by AVG Free Edition.<br>> Version: 7.1.385 / Virus Database: 268.5.1/327 - Release Date:<br>28/04/2006<br>><br><br><br><br>--<br>
No virus found in this outgoing message.<br>Checked by AVG Free Edition.<br>Version: 7.1.385 / Virus Database: 268.5.1/327 - Release Date:<br>28/04/2006<br><br>_______________________________________________<br>Delphi mailing list
<br><a href="mailto:Delphi@ns3.123.co.nz">Delphi@ns3.123.co.nz</a><br><a href="http://ns3.123.co.nz/mailman/listinfo/delphi">http://ns3.123.co.nz/mailman/listinfo/delphi</a><br><br><br><br>_______________________________________________
<br>Delphi mailing list<br><a href="mailto:Delphi@ns3.123.co.nz">Delphi@ns3.123.co.nz</a><br><a href="http://ns3.123.co.nz/mailman/listinfo/delphi">http://ns3.123.co.nz/mailman/listinfo/delphi</a><br></blockquote></div><br>