add docs on concept of operations