TODO(docs): document conundrum