Improve `overcooked_simulator` comments and readability

The changes made are focused on improving the readability of code comments and clarifying the purpose of sections within the 'overcooked_simulator'. Formatting changes were made to separate headers for better readability and the meaning of certain terms, like 'extra_repr' in 'game_items.py', was clarified further.

overcooked_simulator/__init__.py

@@ -32,7 +32,8 @@ cd overcooked_simulator
 pip install -e .
 ```
 
-# Usage / Examples Our overcooked simulator is designed for real time interaction but also with reinforcement
+# Usage / Examples
+ Our overcooked simulator is designed for real time interaction but also with reinforcement
 learning in mind (gymnasium environment). It focuses on configurability, extensibility and appealing visualization
 options.
 
@@ -110,22 +111,20 @@ p1_websocket.send(json.dumps({"type": "get_state", "player_hash": env_info["play
 state = json.loads(websocket.recv())
 
 # send an action for player "0"
-# movement
+# --- movement ---
 action = Action(
     player="0",
     action_type=ActionType.MOVEMENT,
     action_data=[0.0, 1.0],  # direction (here straight up)
     duration=0.5  # seconds
 )
-
-# pickup/drop off
+# --- pickup/drop off ---
 action = Action(
     player="0",
     action_type=ActionType.PUT,
     action_data="pickup",
 )
-
-# interact
+# --- interact ---
 action = Action(
     player="0",
     action_type=ActionType.INTERACT,
@@ -155,7 +154,7 @@ requests.post(
 )
 ```
 
-## Direct integration into your code.
+## Direct integration into your code
 You can use the `overcooked_simulator.overcooked_environment.Environment` class
 and call the `step`, `get_json_state`, and `perform_action` methods directly.
 

overcooked_simulator/game_items.py

@@ -139,7 +139,7 @@ class Item:
 
     @property
     def extra_repr(self):
-        """Stuff to add to the representation of the item in subclasses."""
+        """Additional string to add to the representation of the item (in __repr__)."""
         return ""
 
     def can_combine(self, other) -> bool: