reverted shadows test
doc comments