isolate LCD writing

+ docs

+ semantic changes
+ better type punting