Write docs about uploading files

[nacmartin]

From the discussion in #2 it is clear that we should provide more docs about this. Apart from just the example in the sandbox. Also work more on documenting transformers.