[Pythonmac-SIG] MacPython documentation and webpages

Christopher Barker Chris.Barker at noaa.gov
Wed Jan 11 20:04:37 CET 2006


Mark,

You got the ball rolling on this:

Mark Asbach wrote:
>  From my point of view, it would be very helpful to concentrate  
> MacPython knowledge and information in a central place like  
> www.python.org / http://wiki.python.org and replace all outdated  
> information on the other web pages by a link to that central place.  

> I would invest some time and effort in revising documentation.

Bob Ippolito wrote:
>>Are you the webmaster of pythonmac.org? If so, how is that page
>>produced? is it static html?

> Yes and yes.

>>If so, are you open to replacing it with a page that is better  
>>suited as the primary Front-End to the Python-on-OS-X world?

> Patches accepted ;)  If anyone wants to deal with it, I'm definitely  
> willing to dish out accounts.

I think we have an answer: python.org does not, in general, have a lot 
of platform specific documentation, and we'd have to get the primary 
python folks to approve anything we want to put there. I think that 
makes pythonmac.org the best place for our new, improved, "Intro Page 
for Python on OS-X".

Mark, are you willing to coordinate the writing of a new page[s]?

I suggest we have a basic intro, and then perhaps a decision tree under 
the heading:

What version of Python should I use?

That decision tree would include things like: which version of OS-X are 
you running? Do you need python 2.4 features? Do you want to bundle apps 
for others to use? etc.

And, of course, we need a pointer to a FAQ in the Wiki.

I'd also suggest that we break the pythonmac.org/packages pages down 
into separate pages, one for each python version. I think that will make 
it much clearer to folks coming to it which set of packages they should 
look at.

Anyone else?

-Chris















-- 
Christopher Barker, Ph.D.
Oceanographer
                                     		
NOAA/OR&R/HAZMAT         (206) 526-6959   voice
7600 Sand Point Way NE   (206) 526-6329   fax
Seattle, WA  98115       (206) 526-6317   main reception

Chris.Barker at noaa.gov


More information about the Pythonmac-SIG mailing list