update docs
local structure effects in choosing way to go