Re: [pygame] Update PyGame website?

[Paul Vincent Craven <paul@xxxxxxxxxxxxxxxx>]

As for the current site, some of it is inaccurate or incomplete. For example, sprite.RenderPlain has no documentation, but appears in several examples. In the same group, the documentation for what the sprite groups do, verses the source code, seem to be at odds.

Take a look at the Sprite documentation, why is the summary information in each class repeated twice?

http://www.pygame.org/docs/ref/sprite.html

Also, the documentation isn't always clear for person new to the library. Particularly if they are new to programming. My beginning programmers would have no idea what  to do with:

The base class for visible game objects. Derived classes will want to override the Sprite.update - method to control sprite behavior and assign a Sprite.image and Sprite.rectattributes. The initializer can accept any number of Group instances to be added to.

When subclassing the Sprite, be sure to call the base initializer before adding the Sprite to Groups.

But a pointer to example code would really help them out.

 

I think there are several areas that 

Paul Vincent Craven

On Mon, Nov 5, 2012 at 10:45 AM, Ryan Hope <rmh3093@xxxxxxxxx> wrote:

I've been programming PyGame for a few years now and have never once
expanded the comment buttons. I think the documentation is perfectly
fine the way it is. Just remove the comment feature and call it a day.

On Mon, Nov 5, 2012 at 11:34 AM, Paul Vincent Craven

<paul@xxxxxxxxxxxxxxxx> wrote:
> I saw creating a new website had been talked about, but not that someone had
> gone through the effort of working on one. I'll search  through the archives
> again here in a bit to look.
>
> I'm not volunteering to program a CMS out of python, or even to learn a new
> CMS out of the ones I already know. But I like PyGame and think that there
> needs to be a better reference site out there for it. Hopefully no one will
> be insulted by my working on this one.
>
> I'd also like to see some updated releases. I know that the code repository
> has recent check-ins, but the pygame.org site shows the last release over
> three years ago. Even through there were Summer of Code projects, still no
> new releases.
>
> Paul Vincent Craven
>
>
>
>
> On Mon, Nov 5, 2012 at 8:04 AM, Chris Noffsinger <cnoffsin@xxxxxxxxx> wrote:
>>
>> If you look in the mailing list archives this just game up and was talked
>> about at length.
>>
>> Someone had already created a site to replace this one and it was very
>> good but it was not adopted.  Everyone agreed that we thought it could use a
>> change.
>>
>>
>> On Mon, Nov 5, 2012 at 1:26 AM, Owen Rexian <outrexian@xxxxxxxxx> wrote:
>>>
>>> If we do build a new Pygame site, I vote for it to be written in python.
>>>
>>>
>>> On 4 November 2012 23:11, Paul Vincent Craven <paul@xxxxxxxxxxxxxxxx>
>>> wrote:
>>>>
>>>> Hi, the PyGame website looks like it could use a little TLC. The
>>>> platform it runs on seems susceptible to spam, but it would be really great
>>>> if we could still collaborate and keep the website up to date.
>>>>
>>>> I'm not sure who controls the pygame.org website or how they feel about
>>>> an update. I played around creating an updated website using WordPress:
>>>>
>>>> http://pygame.info/
>>>>
>>>> Of course, it needs a lot of styling and more content needs to be put
>>>> into it. But before I did that I thought I'd ask how people would feel about
>>>> an updated web site. 1.) Am I a bad person for trying, and I should leave it
>>>> alone, 2.) Don't care, 3.) You'd like a log-in and help?
>>>>
>>>>
>>>> Paul Vincent Craven
>>>>
>>>>
>>>
>>
>>
>>
>> --
>> Chris Noffsinger
>>
>

--
Ryan Hope, M.S.
CogWorks Lab
Cognitive Science Department
Rensselaer Polytechnic Institute