Update documentation to align with current practices.
Update doc to discourage the use of `automatic_soa'.