About MEDITECH Reports

 

View John Sharpe's profile on LinkedInI'm your host, John Sharpe, a MEDITECH Consultant living in Spokane, WA. Read more ...

Connect ...

Expand your network by connecting on these social media sites:

Sign up for the MEDITECH Reports Blog; details to attend MEDITECH workshops are sent out 1 week in advance to all MEDITECH Report blog subscribers.

These MEDITECH Workshops are sponsored by Donna Carroll at the MEDITECH Community Bulletin

MEDITECH NPR & RW RESOURCES:

Ascii Table: For NPR Report Writer
Loop Builder: For NPR Macros
Key Codes: For CDS Attributes
List Builder: For NPR Macros
MT Report Names: For NPR Reports
MT Structure Viewer: For Physicals
Strings: Format & Sort

HIT Topics

MEDITECH Reports

Current Articles | RSS Feed RSS Feed

Commented Out NPR Code

 

Until reading Neal Ford's 10 Ways to Improve Your Code (www.nealford.com); I hadn't consciously thought about how often NPR Report Writers encounter commented out code in NPR & $T macros.

At times programmers can feel that commenting out code and then leaving it in place is good backup. But ... it makes the MEDITECH NPR code harder to maintain:

- A find and replace in the macro will update the commented code unless you step thru each replacement. That's not fun.
- Commented out code is easy to confuse with production code.
- Backups of the macro OR/AND NPR program preserve the code in its original state.

Neal says it succinctly: "Lots of commented out code is a smell -- get rid of it." Of course he's using the term 'smell' coined by Kent Beck: http://martinfowler.com/bliki/CodeSmell.html.

Want an alert when the next post is published? Click the phone and Subscribe to the MEDITECH Reports Blog!

Subscribe to the Meditech Blog     

                                                                                                                                                                                                          

Comments

Currently, there are no comments. Be the first to post one!
Post Comment
Name
 *
Email
 *
Website (optional)
Comment
 *

Allowed tags: <a> link, <b> bold, <i> italics