improved documentation and refactored model supplier interface