On Wed, Aug 22, 2018 at 2:55 AM, Jonathan Fine <jfine2...@gmail.com> wrote: > Nick Loadholtes wrote (elsewhere, quoted in this thread - by me). > >> Make your docs work as hard as your code does. Clear examples will >> make your code stand out in a good way. > > With a bit more searching I found: > <quote> > https://www.reddit.com/r/Python/comments/70myto/whats_new_in_python_37_python_370a0_documentation/dn4v667/ > > I'll disagree. Nothing is better than Mathworks documentation. I like > documentation by example. > > Python gives you the dry, technically correct verbiage behind how > something works. > > Matlab says: "Here, copy paste this and it'll work". > > To the point that the workspace is designed to automatically strip >>> > from any copy and pasted commands. > > Even with most Python examples you can't just copy and paste a chunk > of an example from the web or documentation because you need to clean > off >>> first. > </quote>
Where in the linked-to What's New page is there an example of that? There are several code blocks that ARE copy/pasteable, even into the vanilla interpreter. ChrisA _______________________________________________ Python-ideas mailing list Python-ideas@python.org https://mail.python.org/mailman/listinfo/python-ideas Code of Conduct: http://python.org/psf/codeofconduct/
