English version for Mémento Python 3 (draft, readers needed)

[Laurent Pointal]

Hello,

I started a first translation of my document originally in french. Could
some fluent english people read it and indicate errors or bad english
expressions.

http://perso.limsi.fr/pointal/python:memento

Thanks.
A+
Laurent.

 

[Paul Rubin]

I started a first translation of my document originally in french. Could
some fluent english people read it and indicate errors or bad english
expressions.

http://perso.limsi.fr/pointal/python:memento

It looks nice. It took me a minute to find the English version:

http://perso.limsi.fr/pointal/_media/python:cours:mementopython3-english.pdf

A few minor things:

1) We would usually call this a "reference card" rather than "memento"

2) In the dictionary example,
{"clé":"valeur"} => {"key":"value"}
{1:"un",3:"trois",2:"deux",3.14:""} => {1:"one", etc. }

3) "bloc" in a few places should be "block"

4) On side 2, the part about writing files is still mostly in French

There are a few other things like that, and I'll try to look more
carefully tonight, I can't spend more time on it right now.

Thanks for writing it and sharing it.

--Paul

 

[Laurent Pointal]

It looks nice. It took me a minute to find the English version:

http://perso.limsi.fr/pointal/_media/python:cours:mementopython3- english.pdf

A few minor things:

1) We would usually call this a "reference card" rather than "memento"

2) In the dictionary example,
{"clé":"valeur"} => {"key":"value"}
{1:"un",3:"trois",2:"deux",3.14:""} => {1:"one", etc. }

3) "bloc" in a few places should be "block"

4) On side 2, the part about writing files is still mostly in French

There are a few other things like that, and I'll try to look more
carefully tonight, I can't spend more time on it right now.

Thanks for writing it and sharing it.

--Paul

Thanks,

I updated the document into 1.0.5a (and fix some other errors).

A+
Laurent.

 

[Paul Rubin]

I updated the document into 1.0.5a (and fix some other errors).

A few more things:

In "Base types" section:
unmodifiable => immutable
(both are correct but immutable is a clearer technical term)

In "Container types":
unmodifiable => immutable as above
dictionnary => dictionary

In "Identifiers":
min/MAJ case discrimination => lower/UPPER case sensitive

In "Conversions":
see verso => see other side
("verso" is not wrong, but it's an unusual word in US English)
logial => logical

In "Sequences indexing":
negative index -4 => [the formatting is broken]

In "Boolean Logic"
twice simultaneously => both simultaneously

In "Maths"
remain => modulo

[page 2]

In "Conditional loop statement"
care to inifinite loops! => be careful of infinite loops!

In "Display / Input"
recto => other side (like "verso" further up)
littéral => literal

In "Files"
don't miss to close file => don't forget to close the file
[but you might mention the "with" statement]

In "Function definition"
bloc => block
(« black box ») => ("black box")
[English speakers may not recognize « » symbols]

In "Generator of int sequences"
You might mention that range makes a generator only in Python 3.
In Python 2 it makes an actual list and xrange makes a generator.

 

[Ulrich Eckhardt]

Am 05.06.2012 19:32, schrieb Laurent Pointal:

I started a first translation of my document originally in french. Could
some fluent english people read it and indicate errors or bad english
expressions.

Just one note up front: Languages or nationalities are written with
uppercase letters, like English and French. Other common faults of that
category are days of the week (Monday..) and month names (January..),
although that's irrelevant for your doc.

Another thing I noticed that was missing was that the "in" keyword can
not only be used to iterate over a sequence (for i in seq:...) but also
to test if something is contained in a sequence (if i in seq:...).

"don't miss to close file after use": Use a "with" statement.

"see verso for string formatting..." - what is "verso"?

"dont" -> "don't"

"char strings" -> "strings" (in the context of indexing, byte strings
have the same syntax)

"with several else if, else if..." - there is no "else if" but "elif".

"block else for other cases" - this sounds as if it was blocking the
else. Maybe "else-block for other cases", but English hyphenation is
complicated and I'm not sure.


Thanks for your work!

Uli

 

[Laurent Pointal]

A few more things:

In "Files"
don't miss to close file => don't forget to close the file
[but you might mention the "with" statement]

I put it as a note (I want students to have file closing in mind, they may
practice other languages without such constructions).

In "Function definition"
bloc => block
(« black box ») => ("black box")
[English speakers may not recognize « » symbols]

I switched them to "".
Its here to remember students that they can't access to functions internal
variables from outside (and should try to limit access to outside world from
inside functions) - a common error during practice. In lecture class, I try
to show them only two access points to functions: parameters and return
value, and a "black box" blocking all other informations.

In "Generator of int sequences"
You might mention that range makes a generator only in Python 3.
In Python 2 it makes an actual list and xrange makes a generator.

We teach with Python3 as several modifications in the language are better
for leaning programming basics (like 1/2 => 0.5).

Thanks for all your corrections, I'll continue with other posters.

A+
L.Pointal.

 

[Laurent Pointal]

Am 05.06.2012 19:32, schrieb Laurent Pointal:

Just one note up front: Languages or nationalities are written with
uppercase letters, like English and French. Other common faults of that
category are days of the week (Monday..) and month names (January..),
although that's irrelevant for your doc.

I modified slightly the page, to have first links in the page for document
downloading (and other links deeper in the page).

Another thing I noticed that was missing was that the "in" keyword can
not only be used to iterate over a sequence (for i in seq:...) but also
to test if something is contained in a sequence (if i in seq:...).

I reworked the second page to have less informations about string formating
(nice, but less important than operations on containers), and add sections
on containers, lists, dictionaries and set.

"don't miss to close file after use": Use a "with" statement.

Added as a note.

"see verso for string formatting..." - what is "verso"?

Modified with Paul indications (its the "other side" in french - from
latin).

"dont" -> "don't"
Done.

"char strings" -> "strings" (in the context of indexing, byte strings
have the same syntax)

Modified (even if I dont teach byte strings with my students).

"with several else if, else if..." - there is no "else if" but "elif".

Modified (it was originally a translation from french, but the
correcpondance between english version and keywords can be confusing).

"block else for other cases" - this sounds as if it was blocking the
else. Maybe "else-block for other cases", but English hyphenation is
complicated and I'm not sure.

Modified to "else block..."

Thanks for your reading and comments.

A+
Laurent.

 

[Alec Ross]

....


Modified with Paul indications (its the "other side" in french - from
latin).

FWIW, English idiomatic usage includes "see overleaf", and "see over",
for the obverse side of a page/sheet, i.e, the following page; and "see
facing page", w/ the obvious meaning.

Alec