[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]
Re: [pygame] pygame.org website update
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