refactor Source class a little: rename couple of methods and write a better yardoc