documentation of  edge cases.