move implementation details to /ops doc