doc updates to clarify #178