DOC: layer level spec