Hello,

Does anyone mind if I edit the wiki?

After logging in to SF using my Google ID I went to the wiki page and I
got an infinite redirect loop. Does anyone know what's going on?


Anyway, I think I can improve the wiki.

Here is the problem: PDL has lots of good documentation, but in the
wiki it's all buried and impossible to find. Instead, the user is
presented with a bunch of links that are more likely to frustrate than
to help. The mail culprit is the "Getting Started" page.

If I had wiki access I would rewrite the "Documentation Contents"
section like this:


* "Philosophy of PDL"
  -- Copy: http://pdl.sourceforge.net/PDLdocs/Philosophy.html

* "Installation"
  -- Link: Installing_PDL_the_quick_and_easy_way
     NOTE: This page should link to "Manual Installation".

* "Quick overview of PDL"
  -- Copy: http://pdl.sourceforge.net/PDLdocs/Impatient.html

* "PDL for Matlab users"
  -- Link: PDL_for_Matlab_users
     NOTE: Add a migration guide, like the one for IDL.

* "PDL for IDL users"
  -- Link: PDL_for_IDL_users

* "Frequently Asked Questions"
  -- Copy: http://pdl.sourceforge.net/PDLdocs/FAQ.html

* "Indexing"
  -- Copy: http://pdl.sourceforge.net/PDLdocs/Indexing.html

* "Support for 'Bad Values'"
  -- Copy: http://pdl.sourceforge.net/PDLdocs/BadValues.html

* "Object Orientation"
  -- Copy: http://pdl.sourceforge.net/PDLdocs/Objects.html

* "Dataflow"
  -- Copy: http://pdl.sourceforge.net/PDLdocs/Dataflow.html

* "PDL Pre-Processor"
  -- Copy: http://pdl.sourceforge.net/PDLdocs/PP.html

* "PDL API"
  -- Copy: http://pdl.sourceforge.net/PDLdocs/


As you can see, I am just re-organizing existing documentation. This
makes the important information easier to find, and makes the docs feel
more organized and coherent. The topics are reasonably sequential, from
introductory to advanced, and a new user will easily find the pages he
needs.

The list of links could be expanded with CPAN modules related to PDL.
So it can talk about plotting, statistics, file format support, curve
fitting, debugging, and so on. These are all important topics for PDL
and should be on the main documentation page.

What do you think?

Daniel.

_______________________________________________
Perldl mailing list
[email protected]
http://mailman.jach.hawaii.edu/mailman/listinfo/perldl

Reply via email to