|
Size: 4394
Comment: Update tutorial on RSA and crypto
|
Size: 5985
Comment: links to resources on technical writing
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 5: | Line 5: |
| Line 6: | Line 7: |
| Line 8: | Line 10: |
== Writing Great Documentation == Jacob Kaplan-Moss has written a series of three articles on how to write great documentation for any open source project. Here is a list of his articles: 1. [[http://jacobian.org/writing/great-documentation/what-to-write/|What to write]] --- Various types of documents that a project should have, including reference manual, tutorials, brief feature tours, development guidelines, etc. 1. [[http://jacobian.org/writing/great-documentation/technical-style/|Technical style]] --- good technical styles to follow. 1. [[http://jacobian.org/writing/great-documentation/editors/|You need an editor]] -- on the importance of having an editor to look after the project's documentation. Darrell Anderson has some tips on technical writing that are well worth a read: 1. [[http://humanreadable.nfshost.com/howtos/bigshot_words.htm|Bigshot Words]] --- some words to avoid. [[http://www.dilbert.com/strips/comic/1992-12-21|Dilbert]] also has some tips. 1. [[http://humanreadable.nfshost.com/howtos/proofreader.htm|A Proofreader’s Checklist]] --- common grammatical and spelling mistakes to look out for. 1. [[http://humanreadable.nfshost.com/howtos/technical_writing_tips.htm|Technical Writing Tips]] --- numerous points to keep in mind in technical writing. It also helps to use to a spell checker. |
|
| Line 9: | Line 33: |
| Line 12: | Line 37: |
| || [[WubiGuide]] || en || Newbie Wubi Linux Sage install under Windows || merlinson2@yahoo.com || 2009-05-17 || | |
| Line 15: | Line 41: |
| Line 18: | Line 45: |
| || Number Theory and the RSA Public Key Cryptosystem [[http://nguyenminh2.googlepages.com/sage_numtheory-rsa.pdf|pdf]] || en || This tutorial uses Sage to study elementary number theory and the RSA public key cryptosystem. A number of Sage commands will be introduced that help us to perform basic number theoretic operations such as greatest common divisor and Euler’s phi function. We then introduce the RSA cryptosystem and use Sage’s built-in commands to encrypt and decrypt data via the RSA algorithm. || Minh Van Nguyen || 2008-11-04/2009-04-22 || | || Number Theory and the RSA Public Key Cryptosystem [[http://nguyenminh2.googlepages.com/sage_numtheory-rsa.pdf|pdf]] || en || This tutorial uses Sage to study elementary number theory and the RSA public key cryptosystem. A number of Sage commands will be introduced that help us to perform basic number theoretic operations such as greatest common divisor and Euler’s phi function. We then introduce the RSA cryptosystem and use Sage’s built-in commands to encrypt and decrypt data via the RSA algorithm. || Minh Van Nguyen || 2008-11-04/2009-07-25 || |
| Line 24: | Line 51: |
| Line 25: | Line 53: |
| || pageUrl || es || mail || 0% || | || [[http://en.wikibooks.org/wiki/Sage_(Mathematical_Software)|Sage Wikibook Project]] || en || - || open for anyone || |
| Line 28: | Line 57: |
| Line 36: | Line 66: |
| Line 43: | Line 74: |
| Line 44: | Line 77: |
Sage Documentation Project
This is the main community website of the Sage Documentation Project. This page is used as a central point to organize the efforts to create new help pages, tutorials, examples and similar documentation efforts. To add a documentation page to this category, add a link to this page on the last line of the page. Click on "subscribe" above to be posted about changes.
Writing Great Documentation
Jacob Kaplan-Moss has written a series of three articles on how to write great documentation for any open source project. Here is a list of his articles:
What to write --- Various types of documents that a project should have, including reference manual, tutorials, brief feature tours, development guidelines, etc.
Technical style --- good technical styles to follow.
You need an editor -- on the importance of having an editor to look after the project's documentation.
Darrell Anderson has some tips on technical writing that are well worth a read:
Bigshot Words --- some words to avoid. Dilbert also has some tips.
A Proofreader’s Checklist --- common grammatical and spelling mistakes to look out for.
Technical Writing Tips --- numerous points to keep in mind in technical writing.
It also helps to use to a spell checker.
Published Documents
Pages in this wiki (should belong to the category "DocumentationProject").
Title/URL |
lang |
Abstract |
Author |
Released/Updated |
en |
help for coding Python/Sage with Netbeans GUI |
2009-01-18/- |
||
en |
Newbie Wubi Linux Sage install under Windows |
2009-05-17 |
External Documents
Not in this wiki (i.e. PDF or website).
Title/URL |
lang |
Abstract |
Author |
Released/Updated |
Sage and Cython: A Brief Introduction html |
en |
This is a quick introduction to Sage,[...] One thing I will highlight is using Cython in Sage to make very fast code in an easy way. |
Marshall Hampton |
-/2008-05-09 |
Number Theory and the RSA Public Key Cryptosystem pdf |
en |
This tutorial uses Sage to study elementary number theory and the RSA public key cryptosystem. A number of Sage commands will be introduced that help us to perform basic number theoretic operations such as greatest common divisor and Euler’s phi function. We then introduce the RSA cryptosystem and use Sage’s built-in commands to encrypt and decrypt data via the RSA algorithm. |
Minh Van Nguyen |
2008-11-04/2009-07-25 |
Linear error-correcting codes pdf |
en |
This tutorial introduces some of Sage's functionality in the theory of error-correcting codes. |
David Joyner and Robert Miller |
2008-05 |
en |
This is a compilation of Sage commands useful for a student studying group theory for the first time. The SAGE worksheet version has executable cells. |
Rob Beezer |
2008-11-05/2009-01-30 |
Documents in the Work
Title/Url |
lang |
Author |
Progress/Status/Need Help |
en |
- |
open for anyone |
Wish List
This is a list of requested documentations.
Type |
Priority |
lang |
Purpose and Direction |
HowTo |
high |
en |
Setup Sage in a classroom situation as a central server. |
Examples |
medium |
en |
Plotting of functions, examples how various kinds of functions can be plotted, explain parameters |
Numbertypes and Conversation |
high |
en |
Write a guide explaining the different types of numbers in Sage. What are they for (examples), how to convert, which modules are available (e.g. how works Sage->Python->Mpmath ?) and so on. Should target new Sage users, especially if they are used to simpler environments without different number types. Should be part of "Tutorial" |
Types
Some definitions on what is what in the list above. (If someone has better definitions, please edit!)
Howto: Basic step-by-step guide with screenshots, easy to use, straightforward, probably often updated.
Tutorial: Explain a topic, how to do something, similar to howto...
Guide: More general than howto and tutorial. For example, explain background knowledge and connect the dots.
Examples: List examples on a particular topic. The levels "beginner", "advanced" and "pro" can be used to indicate the level of prior knowledge, where "pro" involves knowledge about programming with Sage, i.e. also Python, while "advanced" only requires an understanding of Sage's basic functionalities and an implicit knowledge about Python programming.
Teaching: Material used in teaching.
Documents by Category
DocumentationProject