Update documentation to align with current practices.
Update doc to discourage the use of `automatic_soa'.
Don't convert a 'from' import into a normal import during a module move.