Re: [pygame] pygame.org website update

["RR4CLB" <chester_lab@xxxxxxxxxxxx>]

Hi James!


    Yes, I agree, but that is why I mentioned it. I was saying that the tutorial was just like the reference... But I found in the original Python 25 download from Active Python and the Python.org site is several beginner tutorials which I am reading now. 

    I was just mentioning to Phil and document writers to have a nice clear way of learning when using docs. 
    Phil could have on his first page the reference to the beginners books and maybe the download. The Learning Programming I am reading now I downloaded it so I have a book I can reference using links, which is perfect for me being sightless.

    So I will read through this slowly to get a better understanding of the words used all the time in docs.

    Take care, Bruce

On Sun, Oct 21, 2007 at 06:18:33PM -0400, RR4CLB wrote:
>        In other words they write the documentation as if you already know the
>    language, which is not a good way to do it, unless a reference only, a
>    quick reference. But not for the tutorials and such.

I would like to comment that I find the pygame documentation to be a 
great reference. Sure, it is not a good tutorial for users who don't 
know the language, but it is a great reference.

Tutorial and documentation reference are two different things-- they 
should be well crosslinked of course, but they don't need to be the same 
thing.

---
James Paige