move up the documentation of params which are more relevant to end users