The Beauty of a Complicated Function Comment Header (Classic ASP)

Without boring you with details, I wrote an application back in 2003 for a medical billing company. Their team was extremely small, so when I left the project, I made sure they had some very clear documentation. The function headers were my favorites. Here's an example.

Well written comments that are clear and easy to read is very important to code maintenance and reducing technical debt incurred as old applications lose their orriginal developers.

' =============================================================================
' *** AddCertifications()
' -----------------------------------------------------------------------------    
'    PURPOSE:    Adds Certification information for a patient into the
'                CN_CERTIFICATIONS table
'    INPUTS:        
'        pCnn        (Conn)    ADODB.Connection object
'        pPlanID     (int)    Insurance Plan ID from CN_INSURANCE_PLANS
'        pStartDTM   (date)
'        pEndDTM     (date)
'        pAuthNum    (str(50))
'        pDaysAlert  (int)    same as "ALERT_DAYS_PRIOR_TO_END"
'        pSessAlert  (int)   same as "ALERT_SESSIONS_LEFT"
'    OUTPUTS:    
'        Any errors regarding datatype or missing values in required fields
'        - OR -
' -----------------------------------------------------------------------------    

Function AddCertifications(pCnn, pPlanID, pStartDTM, pEndDTM, pAuthNum _
            , pDaysAlert, pSessAlert)

End Function

' -----------------------------------------------------------------------------    


Joe is a User Experience Engineer, Front End Specialist and Application Developer for Bridgeway Software, Inc and part-time consultant for NGO and non-profit organizations in the Houston area. Joe is also a part-time Portrait Photographer at and organizer of the photography club. He and his wife Marty run the Support and Playdate group.













Fatal error: Class CToolsCssCache contains 1 abstract method and must therefore be declared abstract or implement the remaining methods (DrupalCacheInterface::__construct) in /home/content/e/x/t/ext237/html/modules/ctools/includes/ on line 52