Improve API documentation

[adammoody]

The ER README.md points users to er.h for usage info, but documentation in that file is currently lacking. We should say which ER functions are collective. For collective functions, we should say which group of processes must call the function, and we should say whether the return code is the same on all procs or not. More description should be provided for input parameters, including adding text showing example calls.