doc: More updates, note atomic status, flesh out tradeoffs