and yet there’s questions on the semi-official forum on how to read from files properly.

no, the docs really don’t cut it.

it is strongly opinionated about the correct way to do things but it leaves you to your own devices to piece together an understanding from source code, ziggit, and discord.