pygame-ce getting started and timing tutorial

[gillius]

Small update to configuration section to note that <py-config> applies only to py/mpy type scripts.

Major additions to pygame-ce.md on how to get started by explaining the changes needed from "stock" pygame-ce code to run in pyscript, and specifically ways to allow the same code to run cross-platform (locally and in pyscript online).

Example code listed in documentation is live at https://gillius.pyscriptapps.com/pyscript-pygame-ce-quickstart/latest/. If it's appropriate and desired, I can provide each variation for your upload https://docs.pyscript.net/2025.5.1/examples/.

I have written all documentation myself and contribute it under Apache 2.0 license as per https://docs.pyscript.net/2025.5.1/contributing/. The source code for the example is pulled from https://pyga.me/docs/tutorials/en/intro-to-pygame.html (source) with modifications to run under pyscript made by myself. The original code is documented as authored by Pete Shinners ([email protected]). The pygame-ce docs folder readme doesn't list a license but there is a file LGPL.txt which implies it may be covered by LGPL.

As an example of 18 straightforward lines of code I would assume usage would be fair use, but if you want me to build a novel example I can. I used this one due to its small size and to show directly how we can modify pygame getting started documentation to work on pyscript.

[gillius]

I followed the documentation to create a venv and tested local rendering of the documentation via mkdocs serve and viewing it on localhost.

[WebReflection]

This is lovely, thank you a lot!!! I think everything you wrote is sound and useful but I'd like to wait for @ntoll eyes because he's the native English speaker so he might spot some gotcha I didn't but, for the time being, you have my approval, I wish we had more contributions like this one 💖

[WebReflection]

waiting for @ntoll to double check but I think this should go in as it provides tons of tiny details we didn't formalize before.

[gillius]

Thanks for the approval and kind words. After a re-read today I did fix a grammar issue and removed a reference to "earlier code using dt" which existed while I was drafting the doc but removed in the end (but forgot to remove the later reference to it).