added notes on internals