added some docs, and renamed the source attribute