more and better docs
default to dynamic list
more work