Hello, Top posting:
I have a concern, and I don't know how to solve it. The PDL website currently has FOUR or FIVE different pages that are supposed to be a guide to all the documentation available: 1. http://pdl.sourceforge.net/documentation/ 2. http://sourceforge.net/apps/mediawiki/pdl/index.php?title=Main_Page 3. http://pdl.sourceforge.net/PDLdocs/Guide.html 4. http://pdl.sourceforge.net/PDLdocs/Intro.html 5. http://pdl.sourceforge.net/PDLdocs/ *THIS* is the big problem. I completely agree with making the cookbook easy to find. Useful documentation should be easy to find. But the task is pretty hopeless if there are 4-5 pages that are supposed to be the guide for finding documentation. We need to reduce this number before we can make any progress in making useful things easy to find. To start, I propose two changes: 1) Remove http://pdl.sourceforge.net/PDLdocs/Intro.html 2) Remove http://pdl.sourceforge.net/documentation/ and make the "Documentation" link point to one of the remaining pages. Now the number of pages is reduced to two (three if you include the PDL Index). So the issue comes down to how to deal with the PDL Guide vs the wiki. One possible approach is to move the PDL Guide to the wiki. Then update it to include the useful wiki pages such as: * Installing PDL. * PDL Cookbook. * PDL for Matlab users. * PDL for IDL users. To me this seems like the most promising approach. On the wiki it will be easier for other people (e.g. me) to contribute to David's excellent PDL Guide. What do you think? On Tue, 4 May 2010 07:20:28 -0500 P Kishor <[email protected]> wrote: > We had a little bit of conversation a short while ago re. PDL cookbook > [1]. I propose the following -- > > 1. Add a prominent link to the cookbook at the main PDL page [2] or at > the main PDL documentation page [3]. > > 2. More importantly, I propose that a chapter outline be implemented > following the example of the most excellent Perl Cookbook [4] (click > on the "full table of contents" link to see the entire TOC. I will be > happy to do the "implementing" if the PDL gurus here on the list > suggest the headings. > > [1] > http://sourceforge.net/apps/mediawiki/pdl/index.php?title=PDL_Cookbook > [2] http://pdl.sourceforge.net/ [3] > http://pdl.sourceforge.net/documentation/ [4] > http://oreilly.com/catalog/9780596003135 > _______________________________________________ Perldl mailing list [email protected] http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
