[Python-Dev] LaTeX and Python doc contributions (original) (raw)

Fred L. Drake, Jr. fdrake at acm.org
Thu Dec 22 23:37:42 CET 2005

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.

More information about the Python-Dev mailing list