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.
