docs: correct outdated docs for ecosystem apis (#308)

Fix outdated content in user- and developer-facing docs for the new ecosystem APIs described in #266. Also expand the old dfn module docs, since it will stick around for flopy3's sake for some time.

Author: wpbonelli