WorldVistA KIDS Guidelines

WorldVistA KIDS Guidelines

These Guidelines document the current practice of WorldVistA as of November 2019.

When changing Routines, the following actions must be done:

1. Changing the second line of the routine to include the words "WVEHR,LOCAL"
2. Commenting out the old code with the prefix " ;was;" in front of the line.

   Note that this means the second semicolon is usually followed by a space (" ") unless it had a label, and in the case of a label on the line, the beginning of the text of the label starts immediately after the second semicolon.

   The new line will never have a label, so any change to a line with a label must re-introduce a line with the label.

   The single semicolon is used at the beginning of the line because these comments don't need to be copied over to the run-time representation of the code, which some people call the "object" code.

3. Before the ;was; line, there needs to be one or more comment lines marking the block of code that is changed.
   1. This must include the phrase "BEGIN WorldVistA Change"
   2. The date of the change should be included
   3. The initials of the person involved should be included, with the organization

      For example: David J Whitten working for WorldVistA would include "DJW/WV"

   4. It is best if the reason for the change is stated