Re: [Pythonmac-SIG] MacPython documentation and webpages

2006-01-11 Thread Christopher Barker
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/ORR/HAZMAT (206) 526-6959   voice
7600 Sand Point Way NE   (206) 526-6329   fax
Seattle, WA  98115   (206) 526-6317   main reception

[EMAIL PROTECTED]
___
Pythonmac-SIG maillist  -  Pythonmac-SIG@python.org
http://mail.python.org/mailman/listinfo/pythonmac-sig


Re: [Pythonmac-SIG] MacPython documentation and webpages

2006-01-11 Thread Charles Hartman
Bless you guys -- this is a very helpful-looking project.

I'm ignorant, but I can write. If (for example) you want me to do any  
editing, or something like that, I'd be delighted to help.


Charles Hartman
Professor of English, Poet in Residence
Connecticut College
[EMAIL PROTECTED]
*the Scandroid* is at cherry.conncoll.edu/cohar/Programs.htm


On Jan 11, 2006, at 2:04 PM, Christopher Barker wrote:

 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/ORR/HAZMAT (206) 526-6959   voice
 7600 Sand Point Way NE   (206) 526-6329   fax
 Seattle, WA  98115   (206) 526-6317   main reception

 [EMAIL PROTECTED]
 ___
 Pythonmac-SIG maillist  -  Pythonmac-SIG@python.org
 http://mail.python.org/mailman/listinfo/pythonmac-sig

___
Pythonmac-SIG maillist  -  Pythonmac-SIG@python.org
http://mail.python.org/mailman/listinfo/pythonmac-sig


Re: [Pythonmac-SIG] MacPython documentation and webpages

2006-01-05 Thread Brian Ray

On Jan 4, 2006, at 2:51 PM, Bob Ippolito wrote:

 There's already two relevant wikis (python.org, pythonmac.org), what
 would a CMS do differently?

I agree these work well. I keep reminding myself to start adding  
stuff :)

BTW, what happened to the ReStructuredText as a formatting option on  
pythonmac.org wiki?

I tried to add some Carbon documentation a while back in ReST, but it  
gave me an error. Docutils? See the problem is I already have some of  
it in ReStructedText.

Regards,

Brian Ray
http://brianray.chipy.org aim:brianray34



___
Pythonmac-SIG maillist  -  Pythonmac-SIG@python.org
http://mail.python.org/mailman/listinfo/pythonmac-sig


Re: [Pythonmac-SIG] MacPython documentation and webpages

2006-01-04 Thread Jan Erik Moström
Mark Asbach [EMAIL PROTECTED] 2006-01-04 12:08:

 I would invest some time and effort in revising documentation, but  
 since I'm dependent or your knowledge and experience, this is a call  
 for discussion / participation. What is your opinion?

I'm in a similar situation, I would like to spend more time working with
Python but time constraints mostly forces me to do other things. Anyway, one
of the problem I have when I do get the time is finding Mac specific info ...
so I'm all for working for this and I'll help with what I can.

Perhaps one way would be to use a CMS system like Drupal (or perhaps
something that uses Python ;-) to let people work on this?

jem
-- 
Jan Erik Moström, www.mostrom.pp.se
___
Pythonmac-SIG maillist  -  Pythonmac-SIG@python.org
http://mail.python.org/mailman/listinfo/pythonmac-sig


Re: [Pythonmac-SIG] MacPython documentation and webpages

2006-01-04 Thread Bob Ippolito

On Jan 4, 2006, at 9:29 AM, Jan Erik Moström wrote:

 Mark Asbach [EMAIL PROTECTED] 2006-01-04 12:08:

 I would invest some time and effort in revising documentation, but
 since I'm dependent or your knowledge and experience, this is a call
 for discussion / participation. What is your opinion?

 I'm in a similar situation, I would like to spend more time working  
 with
 Python but time constraints mostly forces me to do other things.  
 Anyway, one
 of the problem I have when I do get the time is finding Mac  
 specific info ...
 so I'm all for working for this and I'll help with what I can.

 Perhaps one way would be to use a CMS system like Drupal (or perhaps
 something that uses Python ;-) to let people work on this?

There's already two relevant wikis (python.org, pythonmac.org), what  
would a CMS do differently?

-bob

___
Pythonmac-SIG maillist  -  Pythonmac-SIG@python.org
http://mail.python.org/mailman/listinfo/pythonmac-sig


Re: [Pythonmac-SIG] MacPython documentation and webpages

2006-01-04 Thread Jan Erik Moström
Bob Ippolito [EMAIL PROTECTED] 2006-01-04 21:51:

 There's already two relevant wikis (python.org, pythonmac.org), what  
 would a CMS do differently?

Nothing ... I just need to read the pages and realize that there already is a
wiki there ;-)

jem
-- 
Jan Erik Moström, www.mostrom.pp.se
___
Pythonmac-SIG maillist  -  Pythonmac-SIG@python.org
http://mail.python.org/mailman/listinfo/pythonmac-sig


Re: [Pythonmac-SIG] MacPython documentation and webpages

2006-01-04 Thread Christopher Barker
Bob Ippolito wrote:
 There's already two relevant wikis (python.org, pythonmac.org), what  
 would a CMS do differently?

What it might to differently is make it easier to maintain the main 
front-page web site, but I don't think we need it.

Bob,

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

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? I think that's the 
best place for it. python.org only has a very simple page for each 
platform, it's fine as it is, if pythonmac.org had a better page

If you'd like to see it improved, there seems to be some interest in 
this group in doing the work.

-Chris





-- 
Christopher Barker, Ph.D.
Oceanographer

NOAA/ORR/HAZMAT (206) 526-6959   voice
7600 Sand Point Way NE   (206) 526-6329   fax
Seattle, WA  98115   (206) 526-6317   main reception

[EMAIL PROTECTED]
___
Pythonmac-SIG maillist  -  Pythonmac-SIG@python.org
http://mail.python.org/mailman/listinfo/pythonmac-sig


Re: [Pythonmac-SIG] MacPython documentation and webpages

2006-01-04 Thread Bob Ippolito

On Jan 4, 2006, at 3:02 PM, Christopher Barker wrote:

 Bob Ippolito wrote:
 There's already two relevant wikis (python.org, pythonmac.org), what
 would a CMS do differently?

 What it might to differently is make it easier to maintain the main
 front-page web site, but I don't think we need it.

 Bob,

 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? I think that's the
 best place for it. python.org only has a very simple page for each
 platform, it's fine as it is, if pythonmac.org had a better page

 If you'd like to see it improved, there seems to be some interest in
 this group in doing the work.

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

-bob

___
Pythonmac-SIG maillist  -  Pythonmac-SIG@python.org
http://mail.python.org/mailman/listinfo/pythonmac-sig