cleanup

Author: Anton-4

ci/expect_scripts/terminal-app-snake.exp

@@ -18,7 +18,7 @@ expect "Score: 0\r\n" {
         expect -re {Score:.*}
     }
 
-    # This press should collide with the bottom wall and lead to game over
+    # This press should make the snake collide with the bottom wall and lead to game over
     send "s"
 
     expect -re {.*Game Over.*} {

examples/terminal-app-snake.roc

@@ -20,7 +20,7 @@ GameState : {
 }
 
 # The snake list should never be empty, so we use a non-empty list.
-# Typically we'd use head and tail, but this would be confusing with the snake head and tail later on :)
+# Typically we'd use head and tail, but this would be confusing with the snake's head and tail later on :)
 NonEmptyList : { first : Position, rest : List Position }
 
 initial_state = {

platform/Tty.roc

@@ -1,5 +1,5 @@
-## Provides functionality to liberate the terminal from its default behaviour.
-## This is useful for making a terminal app like vim or a game.
+## Provides functionality to change the behaviour of the terminal.
+## This is useful for running an app like vim or a game in the terminal.
 ##
 ## Note: we plan on moving this file away from basic-cli in the future, see github.com/roc-lang/basic-cli/issues/73
 ##
@@ -12,11 +12,10 @@ import Host
 
 ## Enable terminal [raw mode](https://en.wikipedia.org/wiki/Terminal_mode) to disable some default terminal bevahiour.
 ##
-## The following modes are disabled:
-## - Input will not be echoed to the terminal screen
-## - Input will not be buffered until Enter key is pressed
-## - Input will not be line buffered (input sent byte-by-byte to input buffer)
-## - Special keys like Backspace and CTRL+C will not be processed by terminal driver
+## This leads to the following changes:
+## - Input will not be echoed to the terminal screen.
+## - Input will be sent straight to the program instead of being buffered (= collected) until the Enter key is pressed.
+## - Special keys like Backspace and CTRL+C will not be processed by the terminal driver but will be passed to the program.
 ##
 ## Note: we plan on moving this function away from basic-cli in the future, see github.com/roc-lang/basic-cli/issues/73
 ##