Added a comment about shims
A first pass at documentation.