add comments that reflect my current understanding of Teiid objects