Update documentation to reflect how threads really work these days.