add documentation of my implementation detail