some work on documenting code