Document the new sources API

This is not yet live, but here's the first draft of the documentation.