From za at python.or.id  Wed Jun 18 01:10:46 2014
From: za at python.or.id (Zaki Akhmad)
Date: Wed, 18 Jun 2014 06:10:46 +0700
Subject: [Python-authors] Greetings
Message-ID: <CAGrappbHc9KEV074fiQWVtEMbVCC1a42Xg2x3ypcNJGwo6=Knw@mail.gmail.com>

Hi,

My name is Zaki. I am not yet a Python book author but hopefuly someday.

One of my objectives joining this mailing list so that I could find out how
to start writing a good Python book.

Regards,


-- 
Zaki Akhmad
PlanPin | Planet Python Indonesia
http://planet.python.or.id
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-authors/attachments/20140618/3f0cc588/attachment.html>

From carl.input at gmail.com  Wed Jun 18 13:28:19 2014
From: carl.input at gmail.com (Carl Smith)
Date: Wed, 18 Jun 2014 12:28:19 +0100
Subject: [Python-authors] Python-authors Digest, Vol 28, Issue 1
In-Reply-To: <mailman.38.1403085602.9634.python-authors@python.org>
References: <mailman.38.1403085602.9634.python-authors@python.org>
Message-ID: <CAP-uhDeiv+xvPNzUG17NE8QV7tUVXm_rLLs_Mjavkj4qJaUXUA@mail.gmail.com>

The only generic advice I can offer is to focus on something a little more
niche. Yet another learning Python book... It'd better be really good.

Find something to really focus on. It'd be cool to see more work on
*teaching* with Python, but you want something that you're personally into
obviously.

One thing I'd enjoy is more development histories, where you can follow how
a big, open source project began and evolved, what design decisions were
made, why, how they played out. Throw in a few fun tales, develop the
characters, it could be very interesting. IPython have a good story.

Just a coulpe of pennies, but all the best with it Zaki -- Carl
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-authors/attachments/20140618/d38d2d7a/attachment.html>

From za at python.or.id  Wed Jun 18 17:02:56 2014
From: za at python.or.id (Zaki Akhmad)
Date: Wed, 18 Jun 2014 22:02:56 +0700
Subject: [Python-authors] Python-authors Digest, Vol 28, Issue 1
In-Reply-To: <CAP-uhDeiv+xvPNzUG17NE8QV7tUVXm_rLLs_Mjavkj4qJaUXUA@mail.gmail.com>
References: <mailman.38.1403085602.9634.python-authors@python.org>
 <CAP-uhDeiv+xvPNzUG17NE8QV7tUVXm_rLLs_Mjavkj4qJaUXUA@mail.gmail.com>
Message-ID: <CAGrappa_+cST_uqbKS2Mj4z6zEkSR00s6O01sAsDfxcTgpPN5g@mail.gmail.com>

Hi Carl,

Thank you for your advice! It's really good. Do you have any fav Python
book? ;)

BTW, I'd like to know, this list opinion on how to write a Python book if
the readers native language isn't english?

With all those language and culture barriers.


-- 
Zaki Akhmad
PlanPin | Planet Python Indonesia
http://planet.python.or.id
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-authors/attachments/20140618/1dce0bd5/attachment.html>

From steve at holdenweb.com  Wed Jun 18 17:24:43 2014
From: steve at holdenweb.com (Steve Holden)
Date: Wed, 18 Jun 2014 16:24:43 +0100
Subject: [Python-authors] Python-authors Digest, Vol 28, Issue 1
In-Reply-To: <CAGrappa_+cST_uqbKS2Mj4z6zEkSR00s6O01sAsDfxcTgpPN5g@mail.gmail.com>
References: <mailman.38.1403085602.9634.python-authors@python.org>
 <CAP-uhDeiv+xvPNzUG17NE8QV7tUVXm_rLLs_Mjavkj4qJaUXUA@mail.gmail.com>
 <CAGrappa_+cST_uqbKS2Mj4z6zEkSR00s6O01sAsDfxcTgpPN5g@mail.gmail.com>
Message-ID: <847BF55F-9C32-42F4-BAAE-BCD92DC3CB8F@holdenweb.com>

Hi Zaki,

On Jun 18, 2014, at 4:02 PM, Zaki Akhmad <za at python.or.id> wrote:

> BTW, I'd like to know, this list opinion on how to write a Python book if the readers native language isn't english? 
> 
> With all those language and culture barriers.
> 

Keep it simple is the best rule. Shorter sentences, with no unusual words that second-language readers will be unlikely to know.

S

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-authors/attachments/20140618/7297c6b2/attachment.html>

From carl.input at gmail.com  Thu Jun 19 01:40:23 2014
From: carl.input at gmail.com (Carl Smith)
Date: Thu, 19 Jun 2014 00:40:23 +0100
Subject: [Python-authors] Python-authors Digest, Vol 28, Issue 1
In-Reply-To: <847BF55F-9C32-42F4-BAAE-BCD92DC3CB8F@holdenweb.com>
References: <mailman.38.1403085602.9634.python-authors@python.org>
 <CAP-uhDeiv+xvPNzUG17NE8QV7tUVXm_rLLs_Mjavkj4qJaUXUA@mail.gmail.com>
 <CAGrappa_+cST_uqbKS2Mj4z6zEkSR00s6O01sAsDfxcTgpPN5g@mail.gmail.com>
 <847BF55F-9C32-42F4-BAAE-BCD92DC3CB8F@holdenweb.com>
Message-ID: <CAP-uhDeM3yKvoGyivOLGDYMQnV5tsZn=Rib9gv1zc61c4bBziQ@mail.gmail.com>

+1 Steve -- Keeping the English simple is always the best advice.
Simplicity's appreciated by native English speakers too. Avoid turns of
phrase and metaphors; be clear and plain.

P.S. My favourite book on Python is probably Learning Python by Mark Lutz,
but that was my first Python book, and the one that taught me to code. It's
a great book, but not a good example here. Write something small and
valuable, then iterate. A 1500 page treatise on the language is not a good
project for an aspiring author.

All the best -- Carl
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-authors/attachments/20140619/2946cdfa/attachment.html>

From steve at holdenweb.com  Thu Jun 19 06:57:36 2014
From: steve at holdenweb.com (Steve Holden)
Date: Thu, 19 Jun 2014 05:57:36 +0100
Subject: [Python-authors] Python-authors Digest, Vol 28, Issue 1
In-Reply-To: <CAP-uhDeM3yKvoGyivOLGDYMQnV5tsZn=Rib9gv1zc61c4bBziQ@mail.gmail.com>
References: <mailman.38.1403085602.9634.python-authors@python.org>
 <CAP-uhDeiv+xvPNzUG17NE8QV7tUVXm_rLLs_Mjavkj4qJaUXUA@mail.gmail.com>
 <CAGrappa_+cST_uqbKS2Mj4z6zEkSR00s6O01sAsDfxcTgpPN5g@mail.gmail.com>
 <847BF55F-9C32-42F4-BAAE-BCD92DC3CB8F@holdenweb.com>
 <CAP-uhDeM3yKvoGyivOLGDYMQnV5tsZn=Rib9gv1zc61c4bBziQ@mail.gmail.com>
Message-ID: <0862B99F-4F92-4209-98EF-917AEFDCF251@holdenweb.com>


On Jun 19, 2014, at 12:40 AM, Carl Smith <carl.input at gmail.com> wrote:

> +1 Steve -- Keeping the English simple is always the best advice. Simplicity's appreciated by native English speakers too. Avoid turns of phrase and metaphors; be clear and plain.
> 
> P.S. My favourite book on Python is probably Learning Python by Mark Lutz, but that was my first Python book, and the one that taught me to code. It's a great book, but not a good example here. Write something small and valuable, then iterate. A 1500 page treatise on the language is not a good

first

> project for an aspiring author.
> 
> All the best -- Carl

S
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-authors/attachments/20140619/ae29d536/attachment.html>