add Porting Notes to readme.md for each game

coding-horror · Mar 19, 2022 · f40a1fc · f40a1fc
1 parent ef60738
commit f40a1fc
Show file tree

Hide file tree

Showing 97 changed files with 408 additions and 44 deletions.
diff --git a/01_Acey_Ducey/README.md b/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
diff --git a/02_Amazing/README.md b/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.
diff --git a/03_Animal/README.md b/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)
diff --git a/04_Awari/README.md b/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)
+
diff --git a/05_Bagels/README.md b/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)
diff --git a/06_Banner/README.md b/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)
+
diff --git a/07_Basketball/README.md b/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)
+
diff --git a/08_Batnum/README.md b/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)
+
diff --git a/09_Battle/README.md b/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)
diff --git a/10_Blackjack/README.md b/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)
diff --git a/11_Bombardment/README.md b/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)
diff --git a/12_Bombs_Away/README.md b/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)
diff --git a/13_Bounce/README.md b/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)
diff --git a/14_Bowling/README.md b/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)
diff --git a/15_Boxing/README.md b/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)
diff --git a/16_Bug/README.md b/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)
diff --git a/17_Bullfight/README.md b/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)
diff --git a/18_Bullseye/README.md b/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)
+
diff --git a/19_Bunny/README.md b/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)
diff --git a/20_Buzzword/README.md b/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)
diff --git a/21_Calendar/README.md b/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)
diff --git a/22_Change/README.md b/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)
diff --git a/23_Checkers/README.md b/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)

diff --git a/24_Chemist/README.md b/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
diff --git a/25_Chief/README.md b/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)
diff --git a/26_Chomp/README.md b/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)
diff --git a/27_Civil_War/README.md b/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)
diff --git a/28_Combat/README.md b/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)
diff --git a/29_Craps/README.md b/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.

diff --git a/30_Cube/README.md b/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)
diff --git a/31_Depth_Charge/README.md b/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)
diff --git a/32_Diamond/README.md b/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)
diff --git a/33_Dice/README.md b/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)
diff --git a/34_Digits/README.md b/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)
diff --git a/35_Even_Wins/README.md b/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)
diff --git a/36_Flip_Flop/README.md b/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)
diff --git a/37_Football/README.md b/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)
diff --git a/38_Fur_Trader/README.md b/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)
diff --git a/39_Golf/README.md b/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)
diff --git a/40_Gomoko/README.md b/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)
diff --git a/41_Guess/README.md b/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)
diff --git a/42_Gunner/README.md b/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)
diff --git a/43_Hammurabi/README.md b/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
diff --git a/44_Hangman/README.md b/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)
diff --git a/45_Hello/README.md b/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)