WorldVistA KIDS Guidelines - Revision history

DavidWhitten at 21:39, 18 December 2019

2019-12-18T21:39:36Z

← Older revision		Revision as of 21:39, 18 December 2019
Line 27:		Line 27:
	# Finally there should be a line which has the phrase "END WorldVistA Change". Including the date, initials, and reason for the change are useful in this comment block, but not required.		# Finally there should be a line which has the phrase "END WorldVistA Change". Including the date, initials, and reason for the change are useful in this comment block, but not required.

	Please use care in placing the above block of comments and code. If the line being changed includes dotted (".") lines, the proper number of dots should be placed BEFORE each of the lines being inserted. Failure to do this can cause working code to malfunction.		Please use care in placing the above block of comments and code. If the line being changed includes dotted (".") lines, the proper number of dots should be placed BEFORE the text mentioned above on each of the lines being inserted. Failure to do this can cause working code to malfunction.

DavidWhitten at 21:38, 18 December 2019

2019-12-18T21:38:34Z

← Older revision		Revision as of 21:38, 18 December 2019
Line 5:		Line 5:
	When updating Routines for a KIDS Build, the following actions must be done:		When updating Routines for a KIDS Build, the following actions must be done:

	# Changing the second line of the routine to include the words "WVEHR,LOCAL"		Changing the second line (Fifth (5) semicolon piece inside stars) of the routine to include the words "WVEHR" and "LOCAL".
			This Unix command will display those lines:

			cd <directory with .m files> ; for f in *.m; do head f \| fgrep -Hin 'WVEHR' ; done



	There may be more than one place where the code must be changed to implement the KIDS change. The following actions must be done for each place the changes are done. Also notice the issue with dotted lines below.		There may be more than one place where the code must be changed to implement the KIDS change. The following actions must be done for each place the changes are done. Also notice the issue with dotted lines below.

DavidWhitten at 16:27, 22 November 2019

2019-11-22T16:27:53Z

← Older revision		Revision as of 16:27, 22 November 2019
Line 7:		Line 7:
	# 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"

	There may be more than one place where the code must be changed to implement the KIDS change.		There may be more than one place where the code must be changed to implement the KIDS change. The following actions must be done for each place the changes are done. Also notice the issue with dotted lines below.

	# Before the change (and before the ;was; line mentioned next), there should be one or more comment lines marking the block of code that is changed. It is suggested they only be single semicolon comments.		# Before the change (and before the ;was; line mentioned next), there should be one or more comment lines marking the block of code that is changed. It is suggested they only be single semicolon comments.
	## This must include the phrase "BEGIN WorldVistA Change"		## This must include the phrase "BEGIN WorldVistA Change"
Line 20:		Line 21:
	# Next should be the lines of changed code		# Next should be the lines of changed code
	# Finally there should be a line which has the phrase "END WorldVistA Change". Including the date, initials, and reason for the change are useful in this comment block, but not required.		# Finally there should be a line which has the phrase "END WorldVistA Change". Including the date, initials, and reason for the change are useful in this comment block, but not required.


	Please use care in placing the above block of comments and code. If the line being changed includes dotted (".") lines, the proper number of dots should be placed BEFORE each of the lines being inserted. Failure to do this can cause working code to malfunction.		Please use care in placing the above block of comments and code. If the line being changed includes dotted (".") lines, the proper number of dots should be placed BEFORE each of the lines being inserted. Failure to do this can cause working code to malfunction.

DavidWhitten: /* WorldVistA KIDS Guidelines */

2019-11-22T16:26:50Z

WorldVistA KIDS Guidelines

← Older revision		Revision as of 16:26, 22 November 2019
Line 3:		Line 3:
	These Guidelines document the current practice of WorldVistA as of November 2019.		These Guidelines document the current practice of WorldVistA as of November 2019.

	When ~~changing~~ Routines, the following actions must be done:		When updating Routines for a KIDS Build, the following actions must be done:

	# 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"

			There may be more than one place where the code must be changed to implement the KIDS change.
	# Before the change (and before the ;was; line mentioned next), there should be one or more comment lines marking the block of code that is changed. It is suggested they only be single semicolon comments.		# Before the change (and before the ;was; line mentioned next), there should be one or more comment lines marking the block of code that is changed. It is suggested they only be single semicolon comments.
	## This must include the phrase "BEGIN WorldVistA Change"		## This must include the phrase "BEGIN WorldVistA Change"

DavidWhitten at 16:24, 22 November 2019

2019-11-22T16:24:53Z

← Older revision		Revision as of 16:24, 22 November 2019
Line 20:		Line 20:


	Please use care in placing the above block of comments and code. If the line being changed includes dotted (".") lines, the proper number of dots should be placed BEFORE each of the lines being inserted. Failure to do this can cause working code to malfunction.		Please use care in placing the above block of comments and code. If the line being changed includes dotted (".") lines, the proper number of dots should be placed BEFORE each of the lines being inserted. Failure to do this can cause working code to malfunction.

DavidWhitten at 16:16, 22 November 2019

2019-11-22T16:16:44Z

← Older revision		Revision as of 16:16, 22 November 2019
Line 17:		Line 17:
	#: 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.		#: 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.
	# Next should be the lines of changed code		# Next should be the lines of changed code
	# Finally there should be a line which has the phrase "END WorldVistA Change"		# Finally there should be a line which has the phrase "END WorldVistA Change". Including the date, initials, and reason for the change are useful in this comment block, but not required.


	Please use care in placing the above block of comments and code. If the line being changed includes dotted (".") lines, the proper number of dots should be placed BEFORE each of the lines being inserted. Failure to do this can cause working code to malfunction.		Please use care in placing the above block of comments and code. If the line being changed includes dotted (".") lines, the proper number of dots should be placed BEFORE each of the lines being inserted. Failure to do this can cause working code to malfunction.

DavidWhitten at 16:15, 22 November 2019

2019-11-22T16:15:06Z

@@ Line 6: / Line 6: @@
 #  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.
+#  Before the change (and before the ;was; line mentioned next), there should be one or more comment lines marking the block of code that is changed. It is suggested they only be single semicolon comments.
 ## This must include the phrase "BEGIN WorldVistA Change"
 ## The date of the change should be included
@@ Line 16: / Line 12: @@
 ##:  For example: David J Whitten working for WorldVistA would include "DJW/WV"
 ## It is best if the reason for the change is stated

DavidWhitten at 16:09, 22 November 2019

2019-11-22T16:09:39Z

← Older revision		Revision as of 16:09, 22 November 2019
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. 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.		# 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

DavidWhitten at 15:11, 22 November 2019

2019-11-22T15:11:41Z

← Older revision		Revision as of 15:11, 22 November 2019
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. 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.
			#

DavidWhitten: Created page with "== WorldVistA KIDS Guidelines == These Guidelines document the current practice of WorldVistA as of November 2019. When changing Routines, the following actions must be done..."

2019-11-22T15:06:23Z

Created page with "== WorldVistA KIDS Guidelines == These Guidelines document the current practice of WorldVistA as of November 2019. When changing Routines, the following actions must be done..."

New page

== 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"