[thelist] [semi OT] Slashdot article on IE

[brian cummiskey]

http://slashdot.org/article.pl?sid=04/07/02/1441242&mode=thread&tid=103&tid=113&tid=126&tid=172&tid=95&tid=99

I guess according to yahoo, people are making a jump to mozilla.

alexa concurs:
http://www.alexa.com/data/details/traffic_details?&range=1y&size=large&compare_sites=&url=http://www.mozilla.org#graph

hits to their site have skyrocketed over the past day or so....

Found this pretty interested from a developer stand point, in that more 
and more people will be making the move to a standards-based browser.

and, to keep the O-T legit- a tip :)

<tip title="Documenting your documents well" author="Brian Cummiskey">
Just a quick little blerb today-

Often in the real world, one will stumble onto others code.  Sometimes, 
that person will no longer be with the company, or may not have a clue 
what he or she did when they develped it a year and a half ago over a 36 
hour stretch at the last minuet.

Although tedious at times, documenting your code will make long-term 
effects of re-development and updating it worth while.

Now, In addition to just documenting it, doing so in a standardized way 
will help even more so.

When I am doing a block of code, I like to keep it easy to find my 
stages or steps.  For this reason, regardless of how "indented" I am 
within a function or set of code, I always keep my comments as 
left-aligned.  Not only does it seperate your steps, but it makes 
finding the steps easy to find.

for example:

<?php
//---------------------------------------
//This is the start of the page
//---------------------------------------


//---------------------------------------
//    First Function
//   does: XXXXXXX
//   returns: YYYYYYYYY
//---------------------------------------

    function somefunction1()
    {
        echo "blah";
        echo "blah";

//---------------------------------------
//    Function 2
//   does: XXXXXXX
//   returns: YYYYYYYYY
//---------------------------------------
        function dosomethingelse
        {
            echo "blah";
//---------------------------------------
//    Function 3
//   does: XXXXXXX
//   returns: YYYYYYYYY
//---------------------------------------
              function doathirdthing
              {
               echo "blah";
               }
        }
    }
//---------------------------------------
//end of page
//---------------------------------------
?>
</tip>