The link to the in-progress tutorial above seems to be broken - https://python-tcod.readthedocs.io/en/latest/tutorial/index.html seems to take you there, though.

Here's my feedback after following the current version of the tutorial up to Part 1:

When the tutorial project is finished, I think that it'd be nice to be able to get a preview of it on Part 0.

An example game state

• You could add an explanation or a link about game states in general, as the meaning might be unclear.
• I believe I understand why you chose to import attrs, but perhaps you could add your own reasoning.
• The line tcod.tileset.procedural_block_elements(tileset=tileset) isn't mentioned in the explanation.
• I really like that you added links about Structural Pattern Matching.

I don't have anything specific to say about other sections, but in general I felt like it took me a while to understand what was being done until I saw the code. Perhaps you could break the code down as you explain it, like so:

Configuring an event loop

The next step is to keep the window open until the user closes it.

Since nothing is displayed yet a Console should be created with "Hello World" printed to it. The size of the console can be used as a reference to create the context by adding the console to tcod.context.new.

...
tileset = tcod.tileset.load_tilesheet(
  "data/Alloy_curses_12x12.png", columns=16, rows=16, charmap=tcod.tileset.CHARMAP_CP437
)
console = tcod.console.Console(80, 50)
console.print(0, 0, "Hello World")  # Test text by printing "Hello World" to the console
...

Begin the main game loop with a while True: statement.

To actually display the console to the window the Context.present method must be called with the console as a parameter. Do this first in the game loop before handing events.

...
with tcod.context.new(console=console, tileset=tileset) as context:
        while True:  # Main loop
            context.present(console)  # Render the console to the window and show it
...

Events are checked by iterating over all pending events with tcod.event.wait. Use the code for event in tcod.event.wait(): to begin handing events.

In the event loop start with the line print(event) so that all events can be viewed from the program output. Then test if an event is for closing the window with if isinstance(event, tcod.event.Quit):. If this is True then you should exit the function with raise SystemExit().

...
with tcod.context.new(console=console, tileset=tileset) as context:
        while True:  # Main loop
            context.present(console)  # Render the console to the window and show it
            for event in tcod.event.wait():  # Event loop, blocks until pending events exist
                print(event)
                if isinstance(event, tcod.event.Quit):
                    raise SystemExit()
...

If you run this then you get a window saying "Hello World". The window can be resized and the console will be stretched to fit the new resolution. When you do anything such as press a key or interact with the window the event for that action will be printed to the program output.

I'm excited to see the finished tutorial. Thank you for all of your work.