starting adding API parameters; various tweaks for the docs