Comment Your Code for point releases
Posted: Sat Mar 26, 2011 4:44 pm
Less a feature request and more a best practice.
With each new point release you make it would be great if you added a comment for new and changed code.
Something like
<!-- Oxygen 12.1 NEW -->
<!-- Oxygen 12.1 CHANGED -->
You comment patches and bug fixes, but not regular work. This is particularly an issue with the webhelp plugin, where I am currently running a Compare on the xsl files in the plugin folder to see what we need to do so that we can still use our customized webhelp and it will behave as expected, now that we have upgraded from 12 to 12.1.
Thanks
With each new point release you make it would be great if you added a comment for new and changed code.
Something like
<!-- Oxygen 12.1 NEW -->
<!-- Oxygen 12.1 CHANGED -->
You comment patches and bug fixes, but not regular work. This is particularly an issue with the webhelp plugin, where I am currently running a Compare on the xsl files in the plugin folder to see what we need to do so that we can still use our customized webhelp and it will behave as expected, now that we have upgraded from 12 to 12.1.
Thanks
