docs: internal workings starting write up