a few notes on implementation