Wow, that's ambitious. Thanks for all the work on that front.
I have a comment that is a little off-topic but perhaps relevant.
After talking to some people at the joint meetings in San Diego, and
especially after using Sage a lot in the classroom this semester, I've
been struck by the following fact: people who use Sage who are new to
programming have a lot of trouble figuring out what are pre-defined
words and what aren't. Maybe this is common knowledge among teachers
of CS, but it surprised me how big an issue this is. I think it might
be exacerbated in Sage because of all the functionality. For example,
here's an actual example from my bioinformatics class, initializing a
dictionary:
protein_letters = 'ACEDGFIHKMLNQPSRTWVXY'
amino_dict = {}
for letter in protein_letters:
amino_dict[letter] = 0
Many students, when looking at this, cannot tell that "letter" is an
arbitrary name. You might respond that this is my fault for not
systematically introducing for loops, and you would be right, but I
don't have the time to be thorough - I am mainly teaching
bioinformatics, not programming. Also, I have seen the same confusion
in other contexts. So my suggestion is that it might be worthwhile to
mark up Sage examples for newbies so that pre-defined words such as
"for" and "in" are highlighted somehow.
Cheers,
Marshall Hampton
On Feb 17, 1:08 am, "Ted Kosan" <[EMAIL PROTECTED]> wrote:
> In a recent thread called "Extreme Newbie Development Questions" Jason
>
> Grout wrote:
> >We really ought to set up a library of wonderfully documented examples
> >of how to use Sage, something like the Maple application center or the
> >Mathematica Demonstrations project. The current list of notebooks
> >doesn't fill this need all the way because it is not organized or
> >searchable (I don't think), and there are a lot of the published sagenb
> >notebooks that contain one-off calculations that are not very helpful to
> >someone trying to explore or learn how to use Sage. Stuff like the
> >above worksheet should be easy to find and sort out from the other things.
>
> >A wiki may be a perfect way to do this. People can add pointers from
> >the wiki in certain categories to their published notebook page.
>
> This is something I am especially interested in because I am currently
> working through these issues in the Newbies book (which is mostly
> meant for high school students).
>
> Two questions I have are 1) What should the categorization system look
> like? and 2) What documentation guidelines should the notebook
> examples use?
>
> I spent quite a bit of time over Christmas coming up with the high
> school-oriented categorization scheme included below. For high school
> students it is looking like notebook examples should mostly show how
> problems in these categories are solved, both semi-manually and as
> automatically as possible. I am currently trying to determine good
> documentation guidelines for this purpose.
>
> I would very much like to see what a comprehensive categorization
> scheme for notebook examples would look like along with ideas for high
> school-oriented, and non high school- oriented, documentation
> guidelines :-)
>
> Ted
>
> 7 High School Math Problems (most of the problems are still in development)
> 7.1 Pre-Algebra
> 7.1.1 Equations
> 7.1.2 Expressions
> 7.1.3 Geometry
> 7.1.4 Inequalities
> 7.1.5 Linear Functions
> 7.1.6 Measurement
> 7.1.7 Nonlinear Functions
> 7.1.8 Number Sense And Operations
> 7.1.8.1 Express an integer fraction in lowest terms
> 7.1.9 Polynomial Functions
> 7.2 Algebra
> 7.2.1 Absolute Value Functions
> 7.2.2 Complex Numbers
> 7.2.3 Composite Functions
> 7.2.4 Conics
> 7.2.5 Data Analysis
> 7.2.6 Discrete Mathematics
> 7.2.7 Equations
> 7.2.7.1 Express a symbolic fraction in lowest terms
> 7.2.7.2 Determine the product of two symbolic fractions
> 7.2.7.3 Solve a linear equation for x
> 7.2.7.4 Solve a linear equation which has fractions
> 7.2.8 Exponential Functions
> 7.2.9 Exponents
> 7.2.10 Expressions
> 7.3 Inequalities
> 7.3.1 Inverse Functions
> 7.3.1.1 Linear Equations And Functions
> 7.3.2 Linear Programming
> 7.3.3 Logarithmic Functions
> 7.3.4 Logistic Functions
> 7.3.5 Matrices
> 7.3.6 Parametric Equations
> 7.3.7 Piecewise Functions
> 7.3.8 Polynomial Functions
> 7.3.9 Power Functions
> 7.3.10 Quadratic Functions
> 7.3.11 Radical Functions
> 7.3.12 Rational Functions
> 7.3.13 Sequences
> 7.3.14 Series
> 7.3.15 Systems of Equations
> 7.3.16 Transformations
> 7.3.17 Trigonometric Functions
> 7.4 Precalculus And Trigonometry
> 7.4.1 Binomial Theorem
> 7.4.2 Complex Numbers
> 7.4.3 Composite Functions
> 7.4.4 Conics
> 7.4.5 Data Analysis
> 7.4.6 Discrete Mathematics
> 7.4.7 Equations
> 7.4.8 Exponential Functions
> 7.4.9 Inverse Functions
> 7.4.10 Logarithmic Functions
> 7.4.11 Logistic Functions
> 7.4.12 Matrices And Matrix Algebra
> 7.4.13 Mathematical Analysis
> 7.4.14 Parametric Equations
> 7.4.15 Piecewise Functions
> 7.4.16 Polar Equations
> 7.4.17 Polynomial Functions
> 7.4.18 Power Functions
> 7.4.19 Quadratic Functions
> 7.4.20 Radical Functions
> 7.4.21 Rational Functions
> 7.4.22 Real Numbers
> 7.4.23 Sequences
> 7.4.24 Series
> 7.4.25 Sets
> 7.4.26 Systems of Equations
> 7.4.27 Transformations
> 7.4.28 Trigonometric Functions
> 7.4.29 Vectors
> 7.5 Calculus
> 7.5.1 Derivatives
> 7.5.2 Integrals
> 7.5.3 Limits
> 7.5.4 Polynomial Approximations And Series
> 7.6 Statistics
> 7.6.1 Data Analysis
> 7.6.2 Inferential Statistics
> 7.6.3 Normal Distributions
> 7.6.4 One Variable Analysis
> 7.6.5 Probability And Simulation
> 7.6.6 Two Variable Analysis
> 8 High School Science Problems
> 8.1 Physics
> 8.1.1 Atomic Physics
> 8.1.2 Circular Motion
> 8.1.3 Dynamics
> 8.1.4 Electricity And Magnetism
> 8.1.5 Fluids
> 8.1.6 Kinematics
> 8.1.7 Light
> 8.1.8 Optics
> 8.1.9 Relativity
> 8.1.10 Rotational Motion
> 8.1.11 Sound
> 8.1.12 Waves
> 8.1.13 Thermodynamics
> 8.1.14 Work
> 8.1.15 Energy
> 8.1.16 Momentum
> 8.1.17 Boiling
> 8.1.18 Buoyancy
> 8.1.19 Convection
> 8.1.20 Density
> 8.1.21 Diffusion
> 8.1.22 Freezing
> 8.1.23 Friction
> 8.1.24 Heat Transfer
> 8.1.25 Insulation
> 8.1.26 Newton's Laws
> 8.1.27 Pressure
> 8.1.28 Pulleys
--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-devel@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---
