API docs can survive one bad example, but not a missing error case. People copy the failure path first when integration breaks.