add some commentary on the interface