Well I feel like it should be discussed before putting it in the documentation... could we have the discussion in an issue before deciding what to write about blocking?