On Monday, 20 March 2017 08:09:31 UTC-6, kcrisman wrote:
>
>
>
> 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.
>

The ticket is https://trac.sagemath.org/ticket/22685 waiting for authors! 

-- 
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.

Reply via email to