[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]

Re: Re: [pygame] gsoc pygame more ideas




-----Original Message-----
From: Marcus von Appen <mva@xxxxxxxxxxxx>
To: pygame-users@xxxxxxxx
Date: Thu, 19 Mar 2009 19:50:07 +0100
Subject: Re: [pygame] gsoc  pygame more ideas

On, Thu Mar 19, 2009, John Robinson wrote:

> I have been browsing the ideas page for pygame projects. In the
> previous email,I had raised an interest in working on the math library
> for pygame.I am also interested in helping to develop the
> documentation and examples for pgreloaded.

Nice. As the math needs have been clarified in another mail, I'm not
sure, if you are still all in for the math project, so the documentation
task might be better.

> At school, I have good grades in English, and have been taking
> scientific writing.I'm decent at using XML, and feel confident that I
> can learn to use reStructured text, having experience with other
> markup languages(HTML).
> 
> I feel I would be stronger working on the documentation than
> the math library,but I feel confident that I could complete either one
> of the projects.
>
> I would like to hear from the group and the mentor on my idea, and any
> suggestions that may be helpful.

It sounds like you have some good prerequisites for that
one. reStructured Text is quite easy to learn and can be done
'on-the-job', so there is no need to dig too deep into the whole
documentation of it at the moment.

I recommend you to check out the pgreloaded branch using 

   svn co svn://seul.org/svn/pygame/branches/pgreloaded

build it, take a look at the generated documentation and how it is
generated (the python scripts and templates) and what it looks like at
the moment. Then (if you are still interested ;-) start writing your
application about it.

Except for the written documentation, the technical side would require
certain things such as 

 * writing short example snippets (mostly one or two lines) or
   documented API parts
 * enhancing the XML and the parsers for a better recognition and
   filtering of reStructured Text (so the python code documentation is
   no garbled with RST markup)
 * improve the documentation layout (CSS)
 * integrate mechanisms to have examples and other things for both the
   Python and C API easily integrated (referenced) throughout the
   document

Regards
Marcus

Thanks for responding
I'll look through the documentation tonight, and come up with some ideas.I'll come back tonight or tomorow with my assessment of things and come up with some ideas.
John