Updates and clarifications to broctl docs