• FunkyDexter (9/17/2014)


    ...Jeff Atwood wrote a really good blog article [/url]about this a few years back...

    ...and the example fails either due to the lack of a comment OR proper naming. The code does not contain the essential information that it is a Newton-Raphson approximation. This is EXACTLY the sort of information that should be in a comment as it describes the square root approximation used but would allow a change in the type of approximation used without adversely affecting the caller.

    EDIT: Silly use of wrong word. Sorry.

    Gaz

    -- Stop your grinnin' and drop your linen...they're everywhere!!!