Issue #254 updated documentation changes based on feedback