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<http://www.pygame.org/docs/ref/sprite.html#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 <[email protected]> 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 > <[email protected]> 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 <[email protected]> > 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 <[email protected]> > 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 <[email protected]> > >>> 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 >
