FWIW, I find the documentation for Pulumi to be very good. Just surprised there is no best-practices section or section that describes how to use it in a real-world project

I think you should use best practices for the language you are using. Knowing from Python there is nothing Pulumi adding on top of Python’s BP.