[rllib] annotate public vs developer vs private APIs

[ericl]

What do these changes do?

First cut at annotating public and dev APIs. Also, do some renaming before things are marked as public: move AsyncVectorEnv => BaseEnv; move batch builder classes to their own file.

Related issue number

Closes #3757

[AmplabJenkins]

Test PASSed.
Refer to this link for build results (access rights to CI server needed):
https://amplab.cs.berkeley.edu/jenkins//job/Ray-PRB/10957/
Test PASSed.

[AmplabJenkins]

Test PASSed.
Refer to this link for build results (access rights to CI server needed):
https://amplab.cs.berkeley.edu/jenkins//job/Ray-PRB/10961/
Test PASSed.

[AmplabJenkins]

Test PASSed.
Refer to this link for build results (access rights to CI server needed):
https://amplab.cs.berkeley.edu/jenkins//job/Ray-PRB/11095/
Test PASSed.