Add SageNB modules to the reference manual

[qed777]

Currently, the reference manual's Notebook section documents the old Sage notebook.

We should update this section with docstrings from the recently separated SageNB.

See also: #7384.

CC: @TimDumol

Component: doctest coverage

Author: Mitesh Patel

Reviewer: William Stein

Merged: sage-4.2.1.rc0

Issue created by migration from https://trac.sagemath.org/ticket/7367

[qed777]

Attachment: trac_7367-sagenb_manual.patch.gz

Add SageNB modules to reference manual. Apply to sage repo.

[qed777]

comment:1

I've commented out the "Interfaces" section, for now.

I think sagenb.misc.sphinxify's docstrings need just a bit of tweaking.

[qed777]

comment:2

Replying to @qed777:

I think sagenb.misc.sphinxify's docstrings need just a bit of tweaking.

Of course, we can comment it out, too, temporarily. I didn't mean to pile on more work.

[TimDumol]

comment:4

Replying to @qed777:

Replying to @qed777:

I think sagenb.misc.sphinxify's docstrings need just a bit of tweaking.

Of course, we can comment it out, too, temporarily. I didn't mean to pile on more work.

Docstring fixes are up at #7384

[TimDumol]

comment:5

Everything looks good, but why is the miscellaneous section named "Documentation"? Shouldn't it be named "Miscellaneous functions", or "Introspection", or the like? The name "Documentation" is confusing, at least for me.

[qed777]

comment:6

"Documentation" is indeed confusing. I think my motive was to identify and group the [mostly] help-related modules. Since support falls under "Online Help" and "Miscellaneous," the forthcoming patch simply puts them all under the latter.

[qed777]

Attachment: trac_7367-sagenb_manual_v2.patch.gz

Less confusing subheading. Really skip interface modules. Apply only this patch to sage repo.

[qed777]

comment:7

Feel free to bump the milestone to 4.3.

[williamstein]

comment:8

Looks good to me too.

[mwhansen]

Merged: sage-4.2.1.rc0

[mwhansen]

Reviewer: William Stein