On 7/15/2010 4:42 AM, Daniel Carrera wrote: > On Thu, Jul 15, 2010 at 2:47 AM, Chris Marshall<[email protected]> wrote: >> It was pretty ironic that with the now, much improved, >> web site, the quick start for new users slipped off >> top billing and the user had to post on the mailing >> list to get started. 3-5 responses later that he was >> able to follow and he was good to go. > > Ah, but you see, you are wrong here. The quick start for new users was > *never* prominent. You just remember where it was. Please remember > that my inability to find documentation is what led to me getting > involved in PDL in the first place. It took me a while to find > PDL::Impatient, and *DAYS* to learn about PDL::Guide.
I did not mean to suggest this was good before. > Starting with the old sidebar: > > == Support == > > * Wiki > * Mailing Lists > * Documentation > * FAQ > ... You have to remember my perspective, a top level link to the wiki with install directions that worked for many folks was a big improvement in accessibility for new users. > The sidebar starts by directing the user to the Wiki, even though > that's actually a very poor resource for PDL. Then, after you've > wasted a lot of your time looking around the Wiki, you might come back > to the front page and notice the less prominent Documentation link. On > that page, you'll see things like this: > > -----------%<--------------- > If you want to read the docs now you can use the [online version]. The > HTML documentation is extensive, but rather poorly organised at > present. We are doing our best! Help is always welcome. > -----------%<--------------- > > And that link takes you to PDL::Index, ugh... Anyway, yes there is one > useful link in this page. It goes to PDL::Impatient. But it is by no > means prominent. But ok, after some frustration you find and read > PDL::Impatient. Then at that point you are stuck because you cannot > find any further guidance (like PDL::Guide) anywhere. Did not mean to imply any sort of error in these improvements. It is not possible to fix everything at once. For example, it is not an error to realize that the sidebar is too long and that a better organization is still needed... just an iteration in a new improved "face" for PDL. Thanks for all the hard work, Chris _______________________________________________ Perldl mailing list [email protected] http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
