On Sunday, March 19, 2017 at 2:41:48 PM UTC-4, Andrey Novoseltsev wrote: > > I wanted to check how to make new threejs plotting code to use CDN. show? > and plot? don't mention viewer options and their parameters. So, I go to > the reference manual > http://doc.sagemath.org/html/en/reference/ > and close to the top I see 3D Graphics > http://doc.sagemath.org/html/en/reference/plot3d/index.html > <http://www.google.com/url?q=http%3A%2F%2Fdoc.sagemath.org%2Fhtml%2Fen%2Freference%2Fplot3d%2Findex.html&sa=D&sntz=1&usg=AFQjCNFhas5EMXd8qNRBQt0IiWkNxUM-3g> > which starts with introduction > > http://doc.sagemath.org/html/en/reference/plot3d/sage/plot/plot3d/examples.html > consisting of a single contrived example without any explanations!!! (Or > output for that matter.) > > Next there are "Plotting functions" > > http://doc.sagemath.org/html/en/reference/plot3d/sage/plot/plot3d/plot3d.html > which look pretty at first glance because of colorful plots, but then I > notice that there are also no opening words! > > A big job, to be sure; I didn't even know examples.py existed in that directory. Open a ticket and put "beginner" on it. The problem is that for much of our documentation, we are in the habit of making the tab-completion where interesting documentation happens - e.g. http://doc.sagemath.org/html/en/reference/plot3d/sage/plot/plot3d/plot3d.html#sage.plot.plot3d.plot3d.plot3d for "plot3d". But that isn't necessarily how someone "reads" the doc.
-- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.com. To post to this group, send email to sage-devel@googlegroups.com. Visit this group at https://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.
