doc: layer API
doc: layer characterization