Improvements to shim config documentation

Fixes #795 for API documentation