tag:blogger.com,1999:blog-7849367040589270673.post5558863415021547422..comments2024-03-21T22:50:39.997-07:00Comments on Obsessed with Oracle PL/SQL: RTFM? KISS? Comment? Whatever, just get the code to work right!Steven Feuersteinhttp://www.blogger.com/profile/18405765731886460622noreply@blogger.comBlogger2125tag:blogger.com,1999:blog-7849367040589270673.post-2565647253715954682014-09-18T12:58:04.594-07:002014-09-18T12:58:04.594-07:00Thanks, Iudith. I do like to keep my comments to a...Thanks, Iudith. I do like to keep my comments to a minimum, but that is ONLY justified if the code without comments is self-explanatory. Otherwise, yes, comment away! The problem with that guideline - and it is a problem that comes deep from within our brains and how we think - is that once we sort out what the code needs to be, everything seems so obvious. Comments seem superfluous. Perhaps the best way to do this is to set up a short-term feedback loop: Each day, first thing, look at the code you wrote yesterday and see if it's still "obvious". If not, write some comments before you COMPLETELY forget what the heck it is you wrote.Steven Feuersteinhttps://www.blogger.com/profile/18405765731886460622noreply@blogger.comtag:blogger.com,1999:blog-7849367040589270673.post-45119656346510533822014-09-18T10:33:11.203-07:002014-09-18T10:33:11.203-07:00Hello Steven,
Reading this post made me feel happ...Hello Steven,<br /><br />Reading this post made me feel happy twice ( to just borrow your feeling from the previous post on this blog :):) )<br /><br />1. First of all, you are recommending to Read the Documentation .<br /><br /> This is my "ALL THE TIMES" credo when I am doing anything,<br /> since I started working with a computer :) :)<br /><br /> The downside is, however, that this is maybe the MAIN or even ONLY reason that<br /> up to this day I don't know APEX :( :(<br /><br /> The documentation is HUGE, and I should READ IT before typing the first<br /> letter or opening the first page ....<br /><br /> I would call myself "a person that knows APEX" when I will know about<br /> ALL those built-ins and their parameters :) :) :)<br /><br /> Don't laugh at me ... this is about what I always did with Oracle Forms<br /> along all my career ... and it always worked wonders :):)<br /><br /> By the way, I guess that the addition of that argument was probably<br /> related to some product version upgrade issue ... <br /> otherwise it would probably not have worked prior to this date also.<br /><br />2. Second, you recommend, AGAIN, using comments to document obscure code ...<br /> ... though, recently enough, in one of our Roundtable discussion threads I got the<br /> impression that you do favor self-documenting code ... <br /><br /> Not adding comments can also be deliberate ... sometimes you want<br /> to trick others, for "good reasons" .... but, otherwise, for yourself and for the <br /> "good guys" around, it is better to have them included ...<br /><br />Cheers,<br />Iudith Mentzel<br /> <br /> iudithhttps://www.blogger.com/profile/04905902445036068357noreply@blogger.com