documenting use of the files attribute
additional examples in the docs for how to use files