[Python-Dev] LaTeX and Python doc contributions

[Fred L. Drake, Jr.]

On Thursday 22 December 2005 13:39, Facundo Batista wrote:
 > Very interesting. What I don't know here is how to submit patches...

"Patches" certainly isn't the right word for changes not described as source 
diffs.  I cleaned up some text about that on python.org earlier.

 > I mean, if they were in LaTeX, a diff file would be enough. But in
 > plain text (or ReST), how should people specify the corrections, the
 > position of new paragraphs, etc?

In English is fine.  I'd expect something like: in the section on imaplib, 
before the paragraph starting with "...".  I often get descriptions like this 
when people point out typos to the docs at python.org address; it works well, 
and has almost no barriers to entry at all.

 > I'm really interested in this, we've been discussing about docs in
 > Python Argentina and some people were willing to help (and scared
 > about LaTeX).

Hopefully we can make sure it's easy for everyone to contribute.  I'm 
certainly interested in suggestions, though I make all of them happen.


  -Fred

-- 
Fred L. Drake, Jr.   <fdrake at acm.org>