add some more docs about the boxes