Difference between revisions of "WorldVistA KIDS Guidelines"
From VistApedia
DavidWhitten (talk | contribs) |
DavidWhitten (talk | contribs) |
||
| Line 6: | Line 6: | ||
# Changing the second line of the routine to include the words "WVEHR,LOCAL" | # Changing the second line of the routine to include the words "WVEHR,LOCAL" | ||
| − | # Commenting out the old code with the prefix " ;was;" in front of the line. | + | # 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. | ||
| + | # Before the ;was; line, there needs to be one or more comment lines marking the block of code that is changed. | ||
| + | ## This must include the phrase "BEGIN WorldVistA Change" | ||
| + | ## The date of the change should be included | ||
| + | ## The initials of the person involved should be included, with the organization | ||
| + | ##: For example: David J Whitten working for WorldVistA would include "DJW/WV" | ||
| + | ## It is best if the reason for the change is stated | ||
Revision as of 16:09, 22 November 2019
WorldVistA KIDS Guidelines
These Guidelines document the current practice of WorldVistA as of November 2019.
When changing Routines, the following actions must be done:
- Changing the second line of the routine to include the words "WVEHR,LOCAL"
- 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.
- Before the ;was; line, there needs to be one or more comment lines marking the block of code that is changed.
- This must include the phrase "BEGIN WorldVistA Change"
- The date of the change should be included
- The initials of the person involved should be included, with the organization
- For example: David J Whitten working for WorldVistA would include "DJW/WV"
- It is best if the reason for the change is stated
