Simon King <simon.k...@uni-jena.de> writes:
> On 2013-06-20, kcrisman <kcris...@gmail.com> wrote:
>>> the matroids code (#7477) has plenty of examples. Until now I wasn't even 
>>> aware of the existence of live documentation... but it's incredibly useful! 
>>>
>>
>> It is SO useful!!! 
>
> I've never heard of it either. Can you briefly explain what it is?

It's a view of the Sage documentation (reference manual, etc.) which is
displayed like a worksheet, allowing you to manually execute code
examples (doctests) and play with them. You can find it by the rather
roundabout way of opening the Sage notebook, clicking "Help" at the top
of the screen, and then clicking one of the unassuming-looking
rectangular buttons near the top of the page (such as "Reference Manual"
or "Tutorial").

Honestly I never would have found that unless someone had pointed it out
to me at a Sage Days, since I would never think to click those buttons
under the Help page in the notebook -- I had just assumed they were the
same static documentation as elsewhere.

I guess it's more discoverable to a user whose first exposure to Sage
was via sagenb.org, but for me, before I ever used the notebook I had
installed Sage from source and read bits of the tutorial at
http://sagemath.org/doc while doing so, so that's where I would
instinctively go if I wanted to look up anything. That, or my local copy
of the built HTML docs.

-Keshav

-- 
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 http://groups.google.com/group/sage-devel.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to