improve clarity of docs on templates