first commit
 document related changes