document a little the code