Suggestions for preface

stefanv commented 9 years ago

[x] "delightfully concise code, something few readers will have real experience with." Definitely reword this!
[x] Include a link to scipy-lectures
[x] List the PyData events too?
[x] Ensure sourced code is BSD
[x] hung numbers -> huge numbers
[x] In the GitHub discussion, perhaps mention PRs since this is the game-changer
[x] "or you think you can do something for efficiently,"
[x] "buy engaging"
[x] Looking forward to writing about contributing back to the community!
[x] Python references: what about the cheese shop?
[x] Google "mailing list"?
[x] Also mention Stack Overflow as a place to get help?
[x] End with an enthusiastic sentence? "Now, let's go and write some code!"
[x] Refer to "Introducing GitHub" book when talking about GitHub.

Moving these items from below, so they are tracked properly (edit 6 Jan 2015 by @hdashnow):

[x] Link to scipy-lectures.github.io
[ ] ~~Mention python package index (known as the cheese shop)~~
[x] Also mention "Effective Computation in Physics" book by Katie Huff et al.

jni commented 9 years ago

Oops! I wrote <package name> mailing list but it got parsed out as HTML!!!

jni commented 9 years ago

Also, point very much taken about the conclusion. Clearly not my strong point!!! =\

hdashnow commented 9 years ago

Refer to "Introducing GitHub" book when talking about GitHub.

@stefanv, Meg mentioned this too. Which book, specifically?

hdashnow commented 9 years ago

Notes/clarifications from @stefanv

[x] Mention pydata conference - http://pydata.org/
[x] Link to "Introducing GitHub" http://shop.oreilly.com/product/0636920033059.do
[x] Mention Github pull requests in passing, will come back to this in more detail later.

jni commented 9 years ago

@hdashnow Effective Computation in Physics is by Anthony Scopatz and Katie Huff.

hdashnow commented 9 years ago

Yep, but is it the correct book? On 22 Jul 2015 11:51 am, "Juan Nunez-Iglesias" notifications@github.com wrote:

@hdashnow https://github.com/hdashnow Effective Computation in Physics is by Anthony Scopatz and Katie Huff.

— Reply to this email directly or view it on GitHub https://github.com/hdashnow/elegant-scipy/issues/22#issuecomment-123528813 .

jni commented 9 years ago

@hdashnow yes, it is. =)

hdashnow commented 9 years ago

So, I'm not quite sure where you want me to reference this book: http://shop.oreilly.com/product/0636920033424.do

Maybe someone who's read it can put in the sentence recommending it?

Similarly, scipy-lectures.github.io

hdashnow commented 9 years ago

Okay, I think I've done all I can with these preface suggestions.

These three remaining points need someone who knows what they want to say about them and where they fit in (presumably @stefanv). So maybe just make your own PR for:

Link to scipy-lectures.github.io
Mention python package index (known as the cheese shop)
Also mention "Effective Computation in Physics" book by Katie Huff et al.

hdashnow commented 9 years ago

Some additional feedback from my Dad:

[x] p4 The Python 3 unicode example: I found the geometry bits distracted from the message. A more pedestrian example would help.
[x] p7 Typo: will be generally be reviewed Needs one fewer be

I found ch 0 was a smooth and easy read which didn't say too much or say to little.

hdashnow commented 8 years ago

Completed all suggestions here that I can as of #72. Just need @stefanv to do the last 3 above, namely: Link to scipy-lectures.github.io Mention python package index (known as the cheese shop) Mention "Effective Computation in Physics" book by Katie Huff et al.

stefanv commented 8 years ago

In The Rosie Effect, Graeme Simsion twists the conventions of the word "elegant" around.
Most would use it to describe the visual simplicity of something or someone stylish or graceful.
Say, the first iPhone. Instead, just such an object (the wedding dress) is compared to delightfully concise code. The kind of code that you rarely encounter, yet know immediately when you do.

I think this is a fantastic "hook", but it can be more clear. You say that he twists the word elegant around. But from what to what? From saying something is stylish or graceful to... ?

stefanv commented 8 years ago

What is "IHOP"?

hdashnow commented 8 years ago

@stefanv http://www.ihop.com/ I love that joke, BTW

stefanv commented 8 years ago

:) Should we replace it with an American shop?

On Tue, 14 Jun 2016 at 16:53 Harriet Dashnow notifications@github.com wrote:

@stefanv https://github.com/stefanv http://www.ihop.com/ I love that joke, BTW

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/elegant-scipy/elegant-scipy/issues/22#issuecomment-226050966, or mute the thread https://github.com/notifications/unsubscribe/AACwD6-gc_4_eRv7nHzQT9YvEDIm1-tpks5qLz79gaJpZM4DwSyQ .

hdashnow commented 8 years ago

It is an American shop. I'm doing another preface PR now, and spelling it out so that non-USA-pancake-lovers will get it :P It will help when it is published in another languages ;)

On Wed, Jun 15, 2016 at 9:59 AM, Stefan van der Walt < notifications@github.com> wrote:

:) Should we replace it with an American shop?

On Tue, 14 Jun 2016 at 16:53 Harriet Dashnow notifications@github.com wrote:

@stefanv https://github.com/stefanv http://www.ihop.com/ I love that joke, BTW

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub < https://github.com/elegant-scipy/elegant-scipy/issues/22#issuecomment-226050966 , or mute the thread < https://github.com/notifications/unsubscribe/AACwD6-gc_4_eRv7nHzQT9YvEDIm1-tpks5qLz79gaJpZM4DwSyQ

.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/elegant-scipy/elegant-scipy/issues/22#issuecomment-226051876, or mute the thread https://github.com/notifications/unsubscribe/ADnnhSRAsHJ76Y_fMgoJVqLsQGUOSLQiks5qL0BWgaJpZM4DwSyQ .

Harriet Dashnow BSc, BA, MSc (Bioinformatics), PhD candidate www.harrietdashnow.com/about

hdashnow commented 8 years ago

@stefanv can we close this issue?

stefanv commented 8 years ago

All done here!

jni commented 8 years ago

This is amazing. =D

Ironically it would have been clearer if I'd used the Aussie equivalent, The Pancake Parlour. =D

hdashnow commented 8 years ago

We're not advertising for scientologists in our book!

On Wed, Jun 15, 2016 at 2:14 PM, Juan Nunez-Iglesias < notifications@github.com> wrote:

This is amazing. =D

Ironically it would have been clearer if I'd used the Aussie equivalent, The Pancake Parlour. =D

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/elegant-scipy/elegant-scipy/issues/22#issuecomment-226083649, or mute the thread https://github.com/notifications/unsubscribe/ADnnhZQqU3wt0mqCmnV3I6xt_EVwmUzkks5qL3wMgaJpZM4DwSyQ .

Harriet Dashnow BSc, BA, MSc (Bioinformatics), PhD candidate www.harrietdashnow.com/about

jni commented 8 years ago

@hdashnow and again I learn something new thanks to the book! =)

stefanv commented 8 years ago

I failed to introduce you to another religious chain, In 'n Out, during your visit. Next time, for sure! You can try the hidden menu items, such as "animal style".

On Tue, 14 Jun 2016 at 21:26 Juan Nunez-Iglesias notifications@github.com wrote:

@hdashnow https://github.com/hdashnow and again I learn something new thanks to the book! =)

— You are receiving this because you modified the open/close state. Reply to this email directly, view it on GitHub https://github.com/elegant-scipy/elegant-scipy/issues/22#issuecomment-226084872, or mute the thread https://github.com/notifications/unsubscribe/AACwD2U8RO2okcSKADLVPYB3AxvnWF1aks5qL37xgaJpZM4DwSyQ .

jni commented 8 years ago

@stefanv you forget that I did my PhD in LA. ;) My preference for fries is "light". Having said that I was unaware of any religious affiliations!

stefanv commented 8 years ago

I keep forgetting that, yes. Not that I should be confused by the Australian accent, given my own ;)

elegant-scipy / elegant-scipy

Suggestions for preface #22