docs: internal workings