add a note about how the code is written