[sage-devel] Re: Documentation Quality Initiative

2008-11-06 Thread Jan Groenewald
Hi On Tue, Nov 04, 2008 at 05:42:02PM -0800, William Stein wrote: I skimmed the crypto tutorial and liked it. I really wish we had a bunch of domain-specific tutorials gathered together and included in a single book or directory with Sage, and on the website. I wrote one recently for

[sage-devel] Re: Documentation Quality Initiative

2008-11-06 Thread Jason Merrill
On Nov 6, 4:11 am, Jan Groenewald [EMAIL PROTECTED] wrote: What about being able to click on tutorial somewhere near new worksheet in the sage notebook? Which could present you cell by cell with explanatory text, and then you execute the command to continue, and get a chance to try

[sage-devel] Re: Documentation Quality Initiative

2008-11-06 Thread David Joyner
On Thu, Nov 6, 2008 at 1:11 AM, Rob Beezer [EMAIL PROTECTED] wrote: In the spirit of release early I've added my (incomplete) notes on graph theory commands to the Documentation Project wiki. These are You meant group theory not graph theory. I looked at it briefly. On page 3, the quotes

[sage-devel] Re: Documentation Quality Initiative

2008-11-06 Thread Rob Beezer
David, Thanks for the peek and the corrections. And thanks for permission to use material from your group theory write-up, which I found very helpful as I got started. Yes, GROUP theory. Graph theory will be next. ;-) Available off the wiki, but I also meant to include a link:

[sage-devel] Re: Documentation Quality Initiative

2008-11-05 Thread John Cremona
2008/11/5 Minh Nguyen [EMAIL PROTECTED]: Hi Martin, Martin Albrecht wrote: http://nguyenminh2.googlepages.com/sage_numtheory-crypto.pdf This is a short tutorial on using Sage to study elementary number theory and the RSA public key cryptosystem. By short, I mean at most 10 pages. If

[sage-devel] Re: Documentation Quality Initiative

2008-11-05 Thread Martin Albrecht
Hi, sorry for taking this off-list earlier. 1) Modern cryptography uses many fundamental concepts from number theory I think the precise statement would be that public key cryptography uses many fundamental concepts from number theory. Most of symmetric cryptography is not based on

[sage-devel] Re: Documentation Quality Initiative

2008-11-05 Thread Ronan Paixão
Em Ter, 2008-11-04 às 18:03 -0800, William Stein escreveu: On Tue, Nov 4, 2008 at 5:55 PM, Ronan Paixão [EMAIL PROTECTED] wrote: Em Qua, 2008-11-05 às 12:07 +1100, Minh Nguyen escreveu: On Wed, Aug 27, 2008 at 10:17 AM, Minh Nguyen [EMAIL PROTECTED] wrote: Hi Harald, On Tue,

[sage-devel] Re: Documentation Quality Initiative

2008-11-05 Thread Minh Nguyen
Hi folks, Here it is, the latest version of a Sage tutorial in number theory and crypto: http://nguyenminh2.googlepages.com/sage_numtheory-crypto-v3.pdf This version incorporates suggestions from John, Martin and William, and they are duly acknowledged in the document itself. Please remind me

[sage-devel] Re: Documentation Quality Initiative

2008-11-05 Thread Jason Grout
Minh Nguyen wrote: Hi folks, Here it is, the latest version of a Sage tutorial in number theory and crypto: http://nguyenminh2.googlepages.com/sage_numtheory-crypto-v3.pdf This version incorporates suggestions from John, Martin and William, and they are duly acknowledged in the

[sage-devel] Re: Documentation Quality Initiative

2008-11-05 Thread Harald Schilly
On Nov 5, 3:45 pm, Minh Nguyen [EMAIL PROTECTED] wrote: Here it is, the latest version of a Sage tutorial in number theory and crypto: http://nguyenminh2.googlepages.com/sage_numtheory-crypto-v3.pdf wow, looks really good and is nearly exactly what i originally expected. It's now linked from

[sage-devel] Re: Documentation Quality Initiative

2008-11-05 Thread Rob Beezer
In the spirit of release early I've added my (incomplete) notes on graph theory commands to the Documentation Project wiki. These are designed for a first-time student of the subject and are being developed as I teach such a course this semester. So they should see frequent updates for the next

[sage-devel] Re: Documentation Quality Initiative

2008-11-04 Thread Minh Nguyen
On Wed, Aug 27, 2008 at 10:17 AM, Minh Nguyen [EMAIL PROTECTED] wrote: Hi Harald, On Tue, Aug 26, 2008 at 6:07 PM, Harald Schilly [EMAIL PROTECTED] wrote: Hi, I want to propose a process to increase the quality of the Sage documentation. This is the by far most annoying thing about Sage

[sage-devel] Re: Documentation Quality Initiative

2008-11-04 Thread William Stein
Hi, I skimmed the crypto tutorial and liked it. I really wish we had a bunch of domain-specific tutorials gathered together and included in a single book or directory with Sage, and on the website. I wrote one recently for algebraic number fields. These tutorials would mostly -- like yours

[sage-devel] Re: Documentation Quality Initiative

2008-11-04 Thread Minh Nguyen
William Stein wrote: Hi, I skimmed the crypto tutorial and liked it. I really wish we had a bunch of domain-specific tutorials gathered together and included in a single book or directory with Sage, and on the website. Is that a challenge? :-) On a serious note, I'm planning to do

[sage-devel] Re: Documentation Quality Initiative

2008-11-04 Thread William Stein
On Tue, Nov 4, 2008 at 5:47 PM, Minh Nguyen [EMAIL PROTECTED] wrote: William Stein wrote: Hi, I skimmed the crypto tutorial and liked it. I really wish we had a bunch of domain-specific tutorials gathered together and included in a single book or directory with Sage, and on the website.

[sage-devel] Re: Documentation Quality Initiative

2008-11-04 Thread Ronan Paixão
Em Qua, 2008-11-05 às 12:07 +1100, Minh Nguyen escreveu: On Wed, Aug 27, 2008 at 10:17 AM, Minh Nguyen [EMAIL PROTECTED] wrote: Hi Harald, On Tue, Aug 26, 2008 at 6:07 PM, Harald Schilly [EMAIL PROTECTED] wrote: Hi, I want to propose a process to increase the quality of the Sage

[sage-devel] Re: Documentation Quality Initiative

2008-11-04 Thread William Stein
On Tue, Nov 4, 2008 at 5:55 PM, Ronan Paixão [EMAIL PROTECTED] wrote: Em Qua, 2008-11-05 às 12:07 +1100, Minh Nguyen escreveu: On Wed, Aug 27, 2008 at 10:17 AM, Minh Nguyen [EMAIL PROTECTED] wrote: Hi Harald, On Tue, Aug 26, 2008 at 6:07 PM, Harald Schilly [EMAIL PROTECTED] wrote:

[sage-devel] Re: Documentation Quality Initiative

2008-11-04 Thread David Joyner
Agreed! I am still hoping to replace the document const.tex by cookbook.tex. I'm happy to assemble the chapters but even happier if someone else does:-) I'm not sure what the correct procedure is, so I put a chapter up on trac http://trac.sagemath.org/sage_trac/ticket/3624 Maybe a wiki page is

[sage-devel] Re: Documentation Quality Initiative

2008-11-04 Thread Rob Beezer
As I have been teaching abstract algebra this semester, I have been keeping notes on how to use Sage for this, and distributing them to my students. So they follow the outline of a typical undergraduate course on group theory, trying to use only the ideas they have been taught previously in the

[sage-devel] Re: Documentation Quality Initiative

2008-11-04 Thread Minh Nguyen
Hi Rob, Rob Beezer wrote: As I have been teaching abstract algebra this semester, I have been keeping notes on how to use Sage for this, and distributing them to my students. So they follow the outline of a typical undergraduate course on group theory, trying to use only the ideas they have

[sage-devel] Re: Documentation Quality Initiative

2008-11-04 Thread Rob Beezer
Thanks, Minh, for the offer to take in my group theory notes. I'll be back in touch once I have something to dump your way. ;-) Rob On Nov 4, 7:11 pm, Minh Nguyen [EMAIL PROTECTED] wrote: A good way to do it is to dump your abstract algebra notes on a novice like me :-)  I'd be more than

[sage-devel] Re: Documentation Quality Initiative

2008-11-04 Thread William Stein
On Tue, Nov 4, 2008 at 10:39 PM, Minh Nguyen [EMAIL PROTECTED] wrote: 4) Generating public and private keys Choosing p and q of such different sizes is really a bad idea and IMHO shouldn't be encouraged. The hardness of factorisation depends on the size (and form) of the smaller factor.

[sage-devel] Re: Documentation Quality Initiative

2008-09-19 Thread CristianCantoro
On 14 Set, 21:05, John Cremona [EMAIL PROTECTED] wrote: Cristian, Thanks for the offer to produce some Sagedocumentation.  Did you meandocumentationin Italian?  It's not so clear from what you wrote (I think you did not mean unless?) ... that should have been an although... :P. The point

[sage-devel] Re: Documentation Quality Initiative

2008-09-19 Thread John Cremona
2008/9/19 CristianCantoro [EMAIL PROTECTED]: On 14 Set, 21:05, John Cremona [EMAIL PROTECTED] wrote: Cristian, Thanks for the offer to produce some Sagedocumentation. Did you meandocumentationin Italian? It's not so clear from what you wrote (I think you did not mean unless?) ...

[sage-devel] Re: Documentation Quality Initiative

2008-09-19 Thread Jason Grout
John Cremona wrote: 2008/9/19 CristianCantoro [EMAIL PROTECTED]: On 14 Set, 21:05, John Cremona [EMAIL PROTECTED] wrote: Cristian, Thanks for the offer to produce some Sagedocumentation. Did you meandocumentationin Italian? It's not so clear from what you wrote (I think you did not

[sage-devel] Re: Documentation Quality Initiative

2008-09-14 Thread John Cremona
Cristian, Thanks for the offer to produce some Sage documentation. Did you mean documentation in Italian? It's not so clear from what you wrote (I think you did not mean unless?) Ciao, John Cremona (ma non sono Italiano, scusi) 2008/9/13 CristianCantoro [EMAIL PROTECTED]: Hi, I'm

[sage-devel] Re: Documentation Quality Initiative

2008-09-13 Thread CristianCantoro
Hi, I'm Cristian Consonni. I wish to contribute to Sage documentations unless I'm a new user. (I've produced a very brief Maxima presentation (in italian), you can find it in Maxima's documentation page) I hope to hear some news from you soon. Ciao ciao Cristian

[sage-devel] Re: Documentation Quality Initiative

2008-08-28 Thread Minh Nguyen
Hi Harald, On Wed, Aug 27, 2008 at 9:33 AM, Harald Schilly [EMAIL PROTECTED] wrote: [...] I'll keep you updated on this tutorial in the next few weeks. great! also linking to pari, R and other tutorials from the sage documentation page is a good idea if someone wants to understand those

[sage-devel] Re: Documentation Quality Initiative

2008-08-27 Thread Harald Schilly
On Aug 27, 1:17 am, Minh Nguyen [EMAIL PROTECTED] wrote: I'll keep you updated on this tutorial in the next few weeks. great! also linking to pari, R and other tutorials from the sage documentation page is a good idea if someone wants to understand those modules better. h

[sage-devel] Re: Documentation Quality Initiative

2008-08-26 Thread Philippe Saade
Hi On Tue, Aug 26, 2008 at 8:07 PM, Harald Schilly [EMAIL PROTECTED] wrote: Hi, I want to propose a process to increase the quality of the Sage documentation. This is the by far most annoying thing about Sage according to the last survey. I think the userbase is already big and willing

[sage-devel] Re: Documentation Quality Initiative

2008-08-26 Thread William Stein
On Tue, Aug 26, 2008 at 11:07 AM, Harald Schilly [EMAIL PROTECTED] wrote: Hi, I want to propose a process to increase the quality of the Sage documentation. This is the by far most annoying thing about Sage according to the last survey. I think the userbase is already big and willing enough

[sage-devel] Re: Documentation Quality Initiative

2008-08-26 Thread Fernando Perez
Howdy, On Tue, Aug 26, 2008 at 11:07 AM, Harald Schilly [EMAIL PROTECTED] wrote: Hi, I want to propose a process to increase the quality of the Sage documentation. This is the by far most annoying thing about Sage according to the last survey. I think the userbase is already big and willing

[sage-devel] Re: Documentation Quality Initiative

2008-08-26 Thread Harald Schilly
On Aug 26, 8:56 pm, William Stein [EMAIL PROTECTED] wrote: Are you saying: I, Harald, am willing to organize this,... Ok, then I will start this on a wiki page and yes, organizing is something i'm better than writing text. H --~--~-~--~~~---~--~~ To post to this

[sage-devel] Re: Documentation Quality Initiative

2008-08-26 Thread Minh Nguyen
Hi Harald, On Tue, Aug 26, 2008 at 6:07 PM, Harald Schilly [EMAIL PROTECTED] wrote: Hi, I want to propose a process to increase the quality of the Sage documentation. This is the by far most annoying thing about Sage according to the last survey. I think the userbase is already big and