improved comments per #56