Differences between revisions 7 and 24 (spanning 17 versions)
Revision 7 as of 2009-09-04 01:08:53
Size: 3884
Editor: qed777
Comment:
Revision 24 as of 2009-09-09 00:28:36
Size: 7897
Editor: was
Comment:
Deletions are marked like this. Additions are marked like this.
Line 9: Line 9:
 * [[http://groups.google.com/group/sage-devel/browse_thread/thread/8fa0d854b6928f2b/dc4cfe0a941762aa#dc4cfe0a941762aa | reST back ticks versus $]] - Patch or extend Sphinx.  * [[http://groups.google.com/group/sage-devel/browse_thread/thread/8fa0d854b6928f2b/dc4cfe0a941762aa#dc4cfe0a941762aa | Use $ instead of back ticks for math in reST]] - [[http://trac.sagemath.org/sage_trac/ticket/6892 | #6892]].
Line 11: Line 11:
 * Fix sagenb.org so docstrings look right (Sphinx).  * Use Sphinx for sagenb.org docstrings
Line 13: Line 13:
 * ReST mode(s):
    1. replace tinymce by ReST editor?
    2. %rest in cells, and get rest output.
     Depending on how much stress this puts on a server, we could use a less expensive hash function or hash only part of the incoming docstring. Better yet, pass the object's fully qualified name to `set_introspect_html()` and hash just that for introspection of read-only code.

 * reST mode(s)
    1. replace tinymce by reST editor?
      * You might be able to make TinyMCE *be* a reST editor. See [[http://tinymce.moxiecode.com/examples/example_09.php#|this example]] of making TinyMCE into a BBCode editor.
      * reST's implicit closing tags may make this difficult.

    2. This is better: %rest in cells, and get reST output.

         Should this be HTML output from Sphinx? If so, perhaps we should put the Sphinx-ify code in its own module or a utility function. Note that it would be good to autohide and have doubleclick be show. Same with %html.
Line 18: Line 25:

 * Live introspection cells.

 * Introspection cross links.

 * Tear-out docstrings - [[http://trac.sagemath.org/sage_trac/ticket/6001 | #6001]].
Line 23: Line 36:
 * Fix the major bugs and issues with the current notebook that make it difficult to deploy (e.g., account management).  * Streamlined deployment - account management, fewer bugs, etc.
Line 25: Line 38:
 * Add a textcha question for notebook signup. How about [[http://recaptcha.net/ | reCAPTCHA]]?  * [[http://en.wikipedia.org/wiki/Captcha | Captcha]] for notebook sign-up - [[http://recaptcha.net/ | reCAPTCHA]].
Line 31: Line 44:
 * Reduce data loss possibilites. ([[http://sage.math.washington.edu/home/wstein/tmp/sageuse/dataloss.txt | dataloss.txt]])  * Reduce data loss possibilites. ([[http://sage.math.washington.edu/home/wstein/tmp/sageuse/dataloss.txt |dataloss.txt]])
Line 39: Line 52:
 * User groups.

 * Security -- see http://www.gingerlime.com/20090901_securing_sage_notebook.pdf

 * Functions to delete `worksheets/USER/*/BLAH` where `BLAH` is cells, code, data, or snapshots? Does this affect the size of .sws files?



 * Balancing server_pool:
{{{
I managed to do a little of this by exporting the directory that the
notebook is running in via NFS to the other machines and maintaining
the same permissions and file structure for everything else. However,
this raised another issue in that not all my machines are of
comparable power. How complicated would it be to add something that
allows you to balance how many processes go to each server? I'm
thinking something along the lines of distcc's host list.
}}}

 * Account approval:
{{{
> We have a small server and would like provide SAGE (in form of the
> notebook) for the students. However, it maybe a bit
> "risky" (especially, we have no experts to manage it) to open it up to
> everyone. So we would like to have some kind of "account approval"
> procedure. Can that be done, if so how?
}}}

Line 40: Line 82:

 * See http://routes.groovie.org/ to eliminate twist.py

 * Sage could (and should!) ship copies of the jsmath fonts, and explain clearly what to do to install them whenever they aren't already installed. The current system, which involves visiting the jsmath website in response to subtle hints is not very good.

 * Fix TinyMCE issues, as mentioned here: http://groups.google.com/group/sage-devel/browse_frm/thread/4cd1cc188470c723/c2477e1bdba68028?q=tinymce+bug+group:sage-devel#c2477e1bdba68028 and http://groups.google.com/group/sage-devel/msg/e2eb3f848a21faa3

 * Trivial to set implicit multiplication option for the notebook. On a per worksheet basis with a user default. Same for typeset option.
Line 49: Line 99:
 * Whoosh full-text search (search in codenode archives for discussion).  * [[http://whoosh.ca/ | Whoosh]] full-text search ([[http://groups.google.com/group/codenode-devel/browse_thread/thread/d3ffefa3b09937b6/98bdf00f65441934?#98bdf00f65441934 | codenode-devel]]).
Line 51: Line 101:
 * [[http://carsonified.com/blog/design/top-10-ux-myths/ | Keith Lang's Top 10 UX Myths]].  * [[http://carsonified.com/blog/design/top-10-ux-myths/ | Keith Lang's Top 10 UI Myths]].
Line 53: Line 103:
 * Chat system for students/users.  Is there a Google gadget for this?  * Chat system for students/users - [[http://www.google.com/ig/directory?synd=open&q=chat | Google gadget]]?
Line 59: Line 109:
 * Embed interacts in other web pages.  * Embed cells, including interacts, in other web pages.
Line 61: Line 111:
 * There are things that I now don't like on the Sage notebook, like that if I click on a cell, the frame gets focused (that's ok), but the text moves by one pixel. I hate that. My javascript version doesn't do that, at least on firefox. In fact, it's just a CSS styles issue, so it's easy to fix -- but I wasn't sure if it's just on my firefox, or oeverywhere. (ONDREJ)  * Prevent text movement by a pixel on cell frame focus. (Ondrej)
Line 65: Line 115:
 * Notebook input bug [[http://trac.sagemath.org/sage_trac/ticket/6729 | #6729]].  * Notebook input bug - [[http://trac.sagemath.org/sage_trac/ticket/6729 | #6729]].
Line 67: Line 117:
 * Debugger in the notebook.  Python.  * Python debugger in the notebook.
Line 73: Line 123:
 * In-browser zoom-pan-annotate of Sage plots.  * Interactively zoom, pan, and annotate plots.
Line 75: Line 125:
 * What I mean is that the chance to access at the same time an history powered command line, and a powerful editor (with code completion, tabs, colors, etc.., which looks pretty standard - to not say minimal - in these modern times) looks pretty comfortable to me, but I'll be happy to listen to other comments. I've already heard talking about !BeSpin ( https://bespin.mozilla.com/ ) in this list, right? Can't we have something similar? :)  * Powerful editor with command-line history, syntax highlighting, context-sensitive completions, etc. - [[https://bespin.mozilla.com/ | BeSpin]].

 * Syntax highlighting for published worksheets - [[http://trac.sagemath.org/sage_trac/ticket/5653#comment:2 | pygmentize]].
Line 79: Line 131:
 * Update some output cells ''after'' the new output arrives. For example, smoothly update Jmol via its JS interface.

 * Publishing notebook pages to selected users or groups.

 * [[http://groups.google.com/group/sage-devel/browse_thread/thread/da578e3918f08709/da54258f1783b874?#da54258f1783b874 | GUI plugins for math input]].

 * [[http://groups.google.com/group/sage-devel/browse_thread/thread/86429406fb3bba17/dd3163cb2a47fa38?#dd3163cb2a47fa38 | Vector graphics editing]] - [[http://code.google.com/p/svg-edit/ | SVG-edit]].

 * Account tokens:
{{{
A preliminary patch for this is available at
http://www.math.leidenuniv.nl/~wpalenst/sage/account_tokens.patch . It is a
patch against 4.1.1 with tickets 4552
('trac_4552-notebook_account_email.patch'), 6843, 6856 applied.

(TODO: add doctests, implement token-generation page to the interface added by
ticket 4135, allow enabling/disabling the token feature from that page too.)
}}}

 * The 'forgot password' feature (enabled by enabling the 'email' setting of the notebook) currently allows anyone to reset the password of anyone they know the email address of, since it currently directly resets the password and mails the new password to the email address associated with the account. It would probably be better to instead generate a second password for the account, that would only become permanent once it has been used once. Or, alternatively, to email a link with a secure token to a password-change-page.

Line 81: Line 155:
 * Implement a cross-browser web-application automated testing infrastructure based on webdriver http://code.google.com/p/webdriver/ for the notebook, focused on functionality, consistency, concurrency, and scalability. For example, execute 10 sessions of virtual calculus students in a loop.

 * http://testled.com/
 * Notebook testing infrastructure - automated, cross-browser and platform, focused on functionality, consistency, concurrency, and scalability - [[http://seleniumhq.org/ | Selenium]], [[http://testled.com/ | Testled]], [[http://code.google.com/p/webdriver/ | WebDriver]]. For example, execute 10 sessions of virtual calculus students in a loop.
Line 87: Line 159:
 * Windows server farm.  * Windows build farm.
Line 89: Line 161:
 * Sagelite - separate the current notebook from Sage and get it to run on Windows.  * Sagelite - separate the current notebook from Sage. Windows port.
Line 98: Line 170:

 * Upgrade Sage for 66-bit processors.

Sage Usability Improvements

This unofficial wish list is adapted from this repository. Please feel free to add or clarify ideas, link to trac tickets, make comments, reorganize items, point out useful links, etc.

Documentation

  • LaTeX doc mode.

  • Use $ instead of back ticks for math in reST - #6892.

  • Use Sphinx for sagenb.org docstrings
    • Depending on how much stress this puts on a server, we could use a less expensive hash function or hash only part of the incoming docstring. Better yet, pass the object's fully qualified name to set_introspect_html() and hash just that for introspection of read-only code.

  • reST mode(s)
    1. replace tinymce by reST editor?
      • You might be able to make TinyMCE *be* a reST editor. See this example of making TinyMCE into a BBCode editor.

      • reST's implicit closing tags may make this difficult.
    2. This is better: %rest in cells, and get reST output.
      • Should this be HTML output from Sphinx? If so, perhaps we should put the Sphinx-ify code in its own module or a utility function. Note that it would be good to autohide and have doubleclick be show. Same with %html.
  • Document pexpect interface for users.

  • Live introspection cells.
  • Introspection cross links.
  • Tear-out docstrings - #6001.

Notebook

Admin

  • Streamlined deployment - account management, fewer bugs, etc.
  • Captcha for notebook sign-up - reCAPTCHA.

  • LDAP authentication. (tdumont)
  • Guaranteed worksheet-server synchronization.
  • Reduce data loss possibilites. (dataloss.txt)

  • Recover passwords. (Byungchul Cha)
  • Email address as username.
  • Add users as admins. (fprimex)
  • User groups.
  • Security -- see http://www.gingerlime.com/20090901_securing_sage_notebook.pdf

  • Functions to delete worksheets/USER/*/BLAH where BLAH is cells, code, data, or snapshots? Does this affect the size of .sws files?

  • Balancing server_pool:

I managed to do a little of this by exporting the directory that the
notebook is running in via NFS to the other machines and maintaining
the same permissions and file structure for everything else.  However,
this raised another issue in that not all my machines are of
comparable power.  How complicated would it be to add something that
allows you to balance how many processes go to each server?  I'm
thinking something along the lines of distcc's host list.
  • Account approval:

> We have a small server and would like provide SAGE (in form of the
> notebook) for the students. However, it maybe a bit
> "risky" (especially, we have no experts to manage it) to open it up to
> everyone. So we would like to have some kind of "account approval"
> procedure. Can that be done, if so how?

Users

A preliminary patch for this is available at
http://www.math.leidenuniv.nl/~wpalenst/sage/account_tokens.patch . It is a
patch against 4.1.1 with tickets 4552
('trac_4552-notebook_account_email.patch'), 6843, 6856 applied.

(TODO: add doctests, implement token-generation page to the interface added by
ticket 4135, allow enabling/disabling the token feature from that page too.)
  • The 'forgot password' feature (enabled by enabling the 'email' setting of the notebook) currently allows anyone to reset the password of anyone they know the email address of, since it currently directly resets the password and mails the new password to the email address associated with the account. It would probably be better to instead generate a second password for the account, that would only become permanent once it has been used once. Or, alternatively, to email a link with a secure token to a password-change-page.

Build / Test

  • Notebook testing infrastructure - automated, cross-browser and platform, focused on functionality, consistency, concurrency, and scalability - Selenium, Testled, WebDriver. For example, execute 10 sessions of virtual calculus students in a loop.

  • Make it so Sage binaries don't use SSE3, etc. -- make them FAT!
  • Windows build farm.
  • Sagelite - separate the current notebook from Sage. Windows port.
  • Windows port.
  • VirtualBox Sage.

  • andLinux Sage.
  • Improve documentation/testing and refactor code.
  • Upgrade Sage for 66-bit processors.