See: #7753

We should recommend the simpler "use a string instead of a reference object" in most cases.

We still call .dataset() 96 times in our samples at docs/snippets.py. I would feel better about adding the deprecation notice after we update the rest of our samples.