I'll take on this ticket (I didn't realize the plot3d/examples file when I reviewed this documentation) What do you expect of those opening words? a hyperlinked list of objects included in the file would be the entry level I guess. Or maybe, are you looking for a major 3d documentation rebuild?
El domingo, 19 de marzo de 2017, 19:41:48 (UTC+1), Andrey Novoseltsev escribió: > > 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 > 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! > > Since I know very well what I am looking for, I now click on "Three.js > JavaScript WebGL Renderer" (and realize that I want a newer version from > develop ;-), but how can a new user find out about different output options > and their parameters??? > > Very much hope that someone will care enough to improve the situation... > -- 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.