add missing file headers and method documentation