add Porting Notes to readme.md for each game

01_Acey_Ducey/README.md

@@ -15,6 +15,11 @@ As published in Basic Computer Games (1978):
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
 
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)
+
 #### External Links
  - Common Lisp: https://github.com/koalahedron/lisp-computer-games/blob/master/01%20Acey%20Ducey/common-lisp/acey-deucy.lisp
  - PowerShell: https://github.com/eweilnau/basic-computer-games-powershell/blob/main/AceyDucey.ps1

02_Amazing/README.md

@@ -13,6 +13,6 @@ As published in Basic Computer Games (1978):
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
 
----
+#### Porting Notes
 
 **2022-01-04:** patched original source in [#400](https://github.com/coding-horror/basic-computer-games/pull/400) to fix a minor bug where a generated maze may be missing an exit, particularly at small maze sizes.

03_Animal/README.md

@@ -20,3 +20,7 @@ As published in Basic Computer Games (1978)
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

04_Awari/README.md

@@ -36,3 +36,8 @@ As published in Basic Computer Games (1978)
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)
+

05_Bagels/README.md

@@ -18,3 +18,7 @@ As published in Basic Computer Games (1978)
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

06_Banner/README.md

@@ -12,3 +12,8 @@ As published in Basic Computer Games (1978)
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)
+

07_Basketball/README.md

@@ -28,3 +28,8 @@ As published in Basic Computer Games (1978)
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)
+

08_Batnum/README.md

@@ -18,3 +18,8 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)
+

09_Battle/README.md

@@ -25,3 +25,7 @@ As published in Basic Computer Games (1978)
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

10_Blackjack/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

11_Bombardment/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

12_Bombs_Away/README.md

@@ -12,3 +12,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

13_Bounce/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

14_Bowling/README.md

@@ -16,3 +16,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

15_Boxing/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

16_Bug/README.md

@@ -16,3 +16,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

17_Bullfight/README.md

@@ -23,3 +23,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

18_Bullseye/README.md

@@ -34,3 +34,8 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)
+

19_Bunny/README.md

@@ -6,3 +6,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

20_Buzzword/README.md

@@ -12,3 +12,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

21_Calendar/README.md

@@ -21,3 +21,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

22_Change/README.md

@@ -10,3 +10,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

23_Checkers/README.md

@@ -19,7 +19,8 @@ The file `checkers.annotated.bas` contains an indented and annotated
 version of the source code.  This is no longer valid BASIC code but
 should be more readable.
 
-## Known Issues In the Original BASIC Code
+#### Porting Notes
+
  - If the computer moves a checker to the bottom row, it promotes, but
    leaves the original checker in place. (See line 1240)
  - Human players may move non-kings as if they were kings. (See lines 1590 to 1810)

24_Chemist/README.md

@@ -13,5 +13,9 @@ As published in Basic Computer Games (1978):
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
 
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)
+
 #### External Links
  - C: https://github.com/ericfischer/basic-computer-games/blob/main/24%20Chemist/c/chemist.c

25_Chief/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

26_Chomp/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

27_Civil_War/README.md

@@ -16,3 +16,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

28_Combat/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

29_Craps/README.md

@@ -18,9 +18,10 @@ As published in Basic Computer Games (1978):
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
 
-### Comments on the BASIC code for re-implementers.
+#### Porting Notes
 
     15 LET R=0
+
 `R` is a variable that tracks winnings and losings.  Unlike other games that
 start out with a lump sum of cash to spend this game assumes the user has as
 much money as they want and we only track how much they lost or won.
@@ -31,6 +32,7 @@ much money as they want and we only track how much they lost or won.
       24 LET X=(RND(0))
       25 LET T =T+1
       26 IF T<=Z THEN 24
+
 This block of code does nothing other than try to scramble the random number
 generator. Random number generation is not random, they are generated from the
 previous generated number. Because of the slow speed of these systems back then,
@@ -89,7 +91,6 @@ the user input.
       60 IF X=1 THEN 40
       65 IF X=0 THEN 40
 
-
 `F` is a variable that represents the users wager for this betting round.
 `E` and `S` represent the two individual and random dice being rolled.
 This code is actually wrong because it returns a value between 0 and 6.

30_Cube/README.md

@@ -12,3 +12,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

31_Depth_Charge/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

32_Diamond/README.md

@@ -12,3 +12,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

33_Dice/README.md

@@ -19,3 +19,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

34_Digits/README.md

@@ -15,3 +15,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

35_Even_Wins/README.md

@@ -16,3 +16,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

36_Flip_Flop/README.md

@@ -26,3 +26,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

37_Football/README.md

@@ -16,3 +16,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

38_Fur_Trader/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

39_Golf/README.md

@@ -13,3 +13,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

40_Gomoko/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

41_Guess/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

42_Gunner/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

43_Hammurabi/README.md

@@ -21,6 +21,11 @@ As published in Basic Computer Games (1978):
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
 
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)
+
+
 #### External Links
  - C: https://github.com/beyonddream/hamurabi
  - Rust: https://github.com/beyonddream/hamurabi.rs

44_Hangman/README.md

@@ -24,3 +24,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

45_Hello/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

46_Hexapawn/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

47_Hi-Lo/README.md

@@ -19,3 +19,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

48_High_IQ/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

49_Hockey/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

50_Horserace/README.md

@@ -12,3 +12,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

51_Hurkle/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

52_Kinema/README.md

@@ -17,3 +17,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

53_King/README.md

@@ -10,7 +10,16 @@ The author of this program is James A. Storer who wrote it while a student at Le
 
 ⚠️ This game includes references to suicide or self-harm.
 
-### Bugs
+---
+
+As published in Basic Computer Games (1978):
+- [Atari Archives](https://www.atariarchives.org/basicgames/showpage.php?page=96)
+- [Annarchive](https://annarchive.com/files/Basic_Computer_Games_Microcomputer_Edition.pdf#page=111)
+
+Downloaded from Vintage Basic at
+http://www.vintage-basic.net/games.html
+
+#### Porting Notes
 
 Implementers should be aware that this game contains at least one bug.
 
@@ -32,11 +41,4 @@ A quick fix for this bug in the original code would be
 
     1410 PRINT " YOU MADE";ABS(INT(V1-V2));"RALLODS FROM TOURIST TRADE."
 
----
 
-As published in Basic Computer Games (1978):
-- [Atari Archives](https://www.atariarchives.org/basicgames/showpage.php?page=96)
-- [Annarchive](https://annarchive.com/files/Basic_Computer_Games_Microcomputer_Edition.pdf#page=111)
-
-Downloaded from Vintage Basic at
-http://www.vintage-basic.net/games.html

54_Letter/README.md

@@ -12,3 +12,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

55_Life/README.md

@@ -33,3 +33,8 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

56_Life_for_Two/README.md

@@ -42,3 +42,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

57_Literature_Quiz/README.md

@@ -12,3 +12,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

58_Love/README.md

@@ -12,3 +12,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

59_Lunar_LEM_Rocket/README.md

@@ -22,3 +22,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

60_Mastermind/README.md

@@ -19,19 +19,6 @@ Note that in this particular implementation, we never actually create a list of
 
 At the beginning of this game, you input the number of colors and number of positions you wish to use (which will directly affect the number of combinations) and the number of rounds you wish to play. While you are playing as the code-breaker, you may type BOARD at any time to get a list of your previous guesses and clues, and QUIT to end the game. Note that this version uses string arrays, but this is merely for convenience and can easily be converted for a BASIC that has no string arrays as long as it has a MID$ function. This is because the string arrays are one-dimensional, never exceed a length greater than the number of positions and the elements never contain more than one character.
 
----
-### Implementation notes
-in [#613](https://github.com/coding-horror/basic-computer-games/pull/613)
-`1060 IF B1<>B OR W1<>W THEN I(X)=0`
-was changed to:
-`1060 IF B1>B OR W1>W THEN I(X)=0`
-This was done because of a bug:
-Originally, after guessing and getting feedback, the computer would look through every possible combination, and for all that haven't previously been marked as impossible it would check whether or not the black and white pins that that combination should get are not-equal to what its previous guess got and, if they are equal, the combination would be marked as possible, and if they aren't equal then the combination would be marked as impossible. This results in a bug where the computer eliminates the correct answer as a possible solution after the first guess, unless the first guess just happens to be correct.
-
-this was discussed in more detail in [issue #611](https://github.com/coding-horror/basic-computer-games/issues/611)
-
-additionally, it's recommended that you have the computer elimate it's previous guess as possible unless that guess was correct. (the rust port does this)
-
 ---
 
 As published in Basic Computer Games (1978):
@@ -40,3 +27,21 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+in [#613](https://github.com/coding-horror/basic-computer-games/pull/613)
+
+`1060 IF B1<>B OR W1<>W THEN I(X)=0`
+
+was changed to:
+
+`1060 IF B1>B OR W1>W THEN I(X)=0`
+
+This was done because of a bug:
+
+Originally, after guessing and getting feedback, the computer would look through every possible combination, and for all that haven't previously been marked as impossible it would check whether or not the black and white pins that that combination should get are not-equal to what its previous guess got and, if they are equal, the combination would be marked as possible, and if they aren't equal then the combination would be marked as impossible. This results in a bug where the computer eliminates the correct answer as a possible solution after the first guess, unless the first guess just happens to be correct.
+
+this was discussed in more detail in [issue #611](https://github.com/coding-horror/basic-computer-games/issues/611)
+
+additionally, it's recommended that you have the computer elimate it's previous guess as possible unless that guess was correct. (the rust port does this)

61_Math_Dice/README.md

@@ -12,3 +12,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

62_Mugwump/README.md

@@ -16,3 +16,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

63_Name/README.md

@@ -12,3 +12,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

64_Nicomachus/README.md

@@ -16,3 +16,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

65_Nim/README.md

@@ -16,16 +16,15 @@ The winning strategy can be mathematically defined, however, rather than present
 
 This game of NIM is from Dartmouth College and allows you to specify any starting size for the four piles and also a win option. To play traditional NIM, you would simply specify 7,5,3 and 1, and win option 1.
 
-### Porting Notes
-
-This can be a real challenge to port because of all the `GOTO`s going out of loops down to code. You may need breaks and continues, or other techniques.
-
 ---
 
 As published in Basic Computer Games (1978):
 - [Atari Archives](https://www.atariarchives.org/basicgames/showpage.php?page=118)
 - [Annarchive](https://annarchive.com/files/Basic_Computer_Games_Microcomputer_Edition.pdf#page=133)
 
-
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+This can be a real challenge to port because of all the `GOTO`s going out of loops down to code. You may need breaks and continues, or other techniques.

66_Number/README.md

@@ -12,3 +12,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

67_One_Check/README.md

@@ -27,3 +27,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

68_Orbit/README.md

@@ -55,3 +55,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

69_Pizza/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

70_Poetry/README.md

@@ -27,3 +27,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

71_Poker/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

72_Queen/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

73_Reverse/README.md

@@ -29,3 +29,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

74_Rock_Scissors_Paper/README.md

@@ -19,3 +19,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

75_Roulette/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

76_Russian_Roulette/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

77_Salvo/README.md

@@ -23,3 +23,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

78_Sine_Wave/README.md

@@ -10,3 +10,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

79_Slalom/README.md

@@ -15,9 +15,8 @@ As published in Basic Computer Games (1978):
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
 
-### Bugs
+#### Porting Notes
 
-- In the original version, the data pointer doesn't reset after a race is completed. This causes subsequent races to
-error at some future point at line 540,
+In the original version, the data pointer doesn't reset after a race is completed. This causes subsequent races to error at some future point at line 540,
 
-      540    READ Q
+    540    READ Q

80_Slots/README.md

@@ -16,3 +16,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

81_Splat/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

82_Stars/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

83_Stock_Market/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

84_Super_Star_Trek/README.md

@@ -88,17 +88,6 @@ The relation between the Historical and Standard nomenclatures is shown in the s
 
 15. This version of Star Trek was created for a Data General Nova 800 system with 32K or core. So that it would fit, the instructions are separated from the main program via a CHAIN. For conversion to DEC BASIC-PLUS, Statement 160 (Randomize) should be moved after the return from the chained instructions, say to Statement 245. For Altair BASIC, Randomize and the chain instructions should be eliminated.
 
----
-#### Bugs
-
-Many of the programs in this book and this collection have bugs in the original code.
-
-@jkboyce has done a great job of discovering and fixing a number of bugs in the [original code](superstartrek.bas), as part of his [python implementation](python/superstartrek.py), which should be noted by other implementers:
-
-- line `4410` : `D(7)` should be `D(6)`
-- lines `8310`,`8330`,`8430`,`8450` : Division by zero is possible
-- line `440` : `B9` should be initialised to 0, not 2
-
 ---
 
 As published in Basic Computer Games (1978):
@@ -111,5 +100,16 @@ http://www.vintage-basic.net/games.html
 Instructions in this directory at
 instructions.txt
 
+#### Porting Notes
+
+Many of the programs in this book and this collection have bugs in the original code.
+
+@jkboyce has done a great job of discovering and fixing a number of bugs in the [original code](superstartrek.bas), as part of his [python implementation](python/superstartrek.py), which should be noted by other implementers:
+
+- line `4410` : `D(7)` should be `D(6)`
+- lines `8310`,`8330`,`8430`,`8450` : Division by zero is possible
+- line `440` : `B9` should be initialised to 0, not 2
+
+
 #### External Links
  - C++: https://www.codeproject.com/Articles/28399/The-Object-Oriented-Text-Star-Trek-Game-in-C

85_Synonym/README.md

@@ -19,8 +19,7 @@ As published in Basic Computer Games (1978):
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
 
-
-## Known Issues
+#### Porting Notes
 
  - Each time the player asks for HELP, one of the synonyms is shown
    and discarded. There is no protection against the player using up

86_Target/README.md

@@ -14,3 +14,8 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

87_3-D_Plot/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

88_3-D_Tic-Tac-Toe/README.md

@@ -24,3 +24,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

89_Tic-Tac-Toe/README.md

@@ -23,3 +23,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

90_Tower/README.md

@@ -18,3 +18,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

91_Train/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

92_Trap/README.md

@@ -17,3 +17,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

93_23_Matches/README.md

@@ -16,3 +16,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

94_War/README.md

@@ -12,3 +12,8 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

95_Weekday/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)

96_Word/README.md

@@ -14,3 +14,7 @@ As published in Basic Computer Games (1978):
 
 Downloaded from Vintage Basic at
 http://www.vintage-basic.net/games.html
+
+#### Porting Notes
+
+(please note any difficulties or challenges in porting here)