This would advertise how one can write the documentation so that one can do "sage_sample?".
And it's a step toward really having all the documentation in the sources for better localitty, with just boilerplate in docs/