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 importattrs, but perhaps you could add your own reasoning.
• The linetcod.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 aConsole 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 totcod.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 awhile True: statement.

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

...withtcod.context.new(console=console,tileset=tileset)ascontext:whileTrue:# Main loopcontext.present(console)# Render the console to the window and show it...

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

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

...withtcod.context.new(console=console,tileset=tileset)ascontext:whileTrue:# Main loopcontext.present(console)# Render the console to the window and show itforeventintcod.event.wait():# Event loop, blocks until pending events existprint(event)ifisinstance(event,tcod.event.Quit):raiseSystemExit()...

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.