improve the 'literate' source docs for the resource tracker