Understanding file refs?

There you go. Still uncooked. Feedback welcome.
It might be better if I tried to help with the official manual… Let me hear what you think / feel.