I might be misunderstanding (its late!) but I'm not sure what the difference is. Sphinx will extract the doctoring and put the example inline with the documentation. I always quite like to see that.  I'm not quite clear what you have in mind.