The API docs for file_selector are extremely thin right now; they are pretty much just the one-sentence summary, with no explanation of parameters or edge cases (e.g., what a null return means). We also don't show examples of most of the parameters in the example app.

(/cc @ditman)