Project setup one-pager

[bcorfman]

Amazon Warriors probably has the best pyproject.toml yet for showing how a user would set up a new game project that used ArcadeActions, although it still needs help around the edges.

The good:

• It uses a version of python-statemachine that I forked to develop probabilistic state transitions for enemies/NPCs. For that reason, I'm installing my own version from source. This all works fine.
• It uses dependabot.yml to update library dependencies weekly and keep everything up-to-date.
• It installs arcade-actions straight off of PyPI. I have it using version 0.8 or higher since I haven't specifically needed newer functionality from 0.9 or 0.10 yet.

Needs work:

• I don't have anything to show the setup of all of these items. Right now, it would just be "pull down one of these demos and play around with it until it works." Ultraviolet would work for automation, but it isn't customized for ArcadeActions specifically.
• The Makefile shows some basic setup but doesn't really show why I chose the commands I have in there.

What I'd like to have:

• A one-page on how to use uv to set up and maintain an ArcadeActions project properly, plus run the examples in the example folder.
  1. uv add examples for both the official PyPI version, plus the main branch or a development branch right off of GitHub.
  2. what the uv.lock file is for and when/why it should be checked in to the project vs. .gitignored
  3. how to use uv to install dependencies, dev dependencies and extras, plus how to distinguish what goes where
  4. how to check/upgrade your uv.lock file by individual library vs. all of the libraries
  5. If I'm not really doing things right in my existing projects, just hurt my feelings please.
• I get lost in uv's docs a lot, plus I don't find them easy to grok the utility of the various options. For new users, I would just like something simple and cookbook-like.

[bcorfman]

Laser Gates is also a "decent" example too.

[bcorfman]

@swilcox any progress?