Skip to content

Commit

Permalink
Reviews
Browse files Browse the repository at this point in the history
  • Loading branch information
gvwilson committed May 26, 2024
1 parent 74e23c4 commit 0d138e1
Show file tree
Hide file tree
Showing 4 changed files with 143 additions and 45 deletions.
2 changes: 1 addition & 1 deletion docs/colophon/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ <h1>Colophon</h1>
<li>
<p>The colors in this theme
are lightened versions of those used in <a href="https://third-bit.com/colophon/">classic Canadian postage stamps</a>.
The art in the title is by <a href="https://blog.djnavarro.net/posts/2023-05-31_software-design-by-example/">Danielle Navarro</a>
The art in the title is by [Danielle Navarro][navarro_danielle]
and used with her gracious permission.</p>
</li>
<li>
Expand Down
75 changes: 60 additions & 15 deletions docs/intro/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -258,27 +258,72 @@ <h2 id="intro-praise">What People Are Saying</h2>
<p>Here&rsquo;s what people said about the JavaScript version of this book <span class="bib-ref">[<a class="bib-ref" href="../bib/#Wilson2022a">Wilson2022a</a>]</span>:</p>
<ul>
<li>
<p><a href="https://jessitron.com/2023/02/20/book-review-software-design-by-example/">Jessica Kerr</a>:
&ldquo;<em>Software Design by Example</em> is the book I&rsquo;ll recommend to every new dev…
It is nice to you.
It wants you to succeed…
It&rsquo;s a bridge from &lsquo;learn to program&rsquo; to working programmer.&rdquo;</p>
<p><a href="https://sback.it/">Alberto Bacchelli</a>:
I&rsquo;ve been using this book to teach software design to an undergraduate class of 250 students,
and the students and I love it!
The positive impact of the book is evident from the improvements in student grades
and the quality of their practical assignments,
reflecting the substantial learning that&rsquo;s taking place.
It&rsquo;s been a joy to see them feel so equipped and inspired.</p>
</li>
<li>
<p><a href="https://mastodon.social/@[email protected]/109985276835264400">Jenn Schiffer</a>:
&ldquo;I am v much enjoying gvwilson&rsquo;s book <em>Software Design by Example</em>.
It makes me miss teaching, it would be such a fun text to use!&rdquo;</p>
<p><a href="https://naomiceder.tech/">Naomi Ceder</a>:
This is my new favorite book on the art of writing software.
There is so much to like about it—the way it leads the reader to explore and develop their understanding,
the choice of projects and examples,
the clarity of the instruction,
the Creative Commons license,
and much more.
It will be my first recommendation for people looking to really learn professional development,
either on their own or in a classroom setting.</p>
</li>
<li>
<p><a href="https://emilygorcenski.com/post/book-report-software-design-by-example-by-greg-wilson/">Emily Gorcenski</a>:
&ldquo;There&rsquo;s a lot of books on programming
but fewer books that couple software development with effective and practical use of tools,
presenting a language not as a main course but as a part of an engineering ecosystem.
Greg Wilson&rsquo;s book hits all the right notes in bringing together theory, pragmatism, and best practices.&rdquo;</p>
<p><a href="https://www.juliaferraioli.com/">Julia Ferraioli</a>:
Blending computer science with sound software engineering practices (with citations!)
is difficult enough on its own,
but this book guides the reader through practical design patterns that they can put into practice.
The addition of historic anecdotes gives readers extra context for what they&rsquo;ve learned
and brings theory back to practice.</p>
</li>
<li>
<p><a href="https://blog.djnavarro.net/posts/2023-05-31_software-design-by-example/">Danielle Navarro</a>:
&ldquo;The book is really bloody lovely.&rdquo;</p>
<p><a href="https://jenniferplusplus.com/">Jennifer Moore</a>:
The book is an excellent guide for anyone going from &ldquo;just programming&rdquo; to building larger projects.
It&rsquo;s like a choose-your-own adventure,
but the adventure is learning to build very complex software as a composition of much simpler patterns.</p>
</li>
<li>
<p><a href="https://jennschiffer.com/">Jenn Schiffer</a>:
This book is both a great refresher if you&rsquo;ve not worked with Python in a long time,
or your next textbook if you know just enough to be a little dangerous and want to level up.
The exercises being tool-based means the experience gained will instantly feel applicable
to whatever you end up using the language for.</p>
</li>
<li>
<p><a href="https://www.benormal.info/">Sue Smith</a>:
I know I can share this book with folk in the confidence that
they&rsquo;ll get a guided experience that&rsquo;s both accessible and comprehensive,
leaving them with real world software skills.
Teaching using examples makes the techniques meaningful and tangible to the learner
which is in itself a great motivator,
and the use of tooling examples is a bonus.</p>
</li>
<li>
<p><a href="https://chelseatroy.com/">Chelsea Troy</a>:
Rather than stacking up isolated examples divorced from practical use cases,
this book teaches concepts the way we use them: in collaboration with one another.
Filled with both pragmatic advice and juicy historical nuggets,
this book just might manage to do the thing I&rsquo;ve tried to do in classrooms for half a decade:
transfer basic engineering skills
while conveying what it&rsquo;s like to manage complex software projects.</p>
</li>
<li>
<p><a href="https://hazelweakly.me/">Hazel Weakly</a>:
This is an absolutely marvelous book.
Very rarely do insightful diagrams,
contentious syntax disambiguation,
and thoughtful attention to how humans learn and absorb information come together in a coherent package like this.
It is exactly the sort of book I wish I&rsquo;d had at the start of my programming journey;
it would&rsquo;ve saved me from countless lessons learned the hard way.</p>
</li>
</ul>
<h2 id="intro-acknowledgments">Acknowledgments</h2>
Expand Down
38 changes: 25 additions & 13 deletions info/links.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,9 @@

# B

- key: bs4
url: https://beautiful-soup-4.readthedocs.io/
en: Beautiful Soup
- key: bacchelli_alberto
url: https://sback.it/
en: Alberto Bacchelli
- key: beuchat_odin
url: https://www.drafolin.ch/
en: Odin Beuchat
Expand Down Expand Up @@ -51,6 +51,9 @@
- key: brubeck_matt
url: https://limpet.net/mbrubeck/
en: Matt Brubeck
- key: bs4
url: https://beautiful-soup-4.readthedocs.io/
en: Beautiful Soup

# C

Expand All @@ -61,6 +64,9 @@
url: https://creativecommons.org/licenses/by-nc/4.0/legalcode
en: CC-BY-NC License (full text)
direct: true
- key: ceder_naomi
url: https://naomiceder.tech/
en: Naomi Ceder
- key: clarkes_laws
url: https://en.wikipedia.org/wiki/Clarke%27s_three_laws
en: "Clarke's Laws on Wikipedia"
Expand Down Expand Up @@ -121,6 +127,9 @@

# F

- key: ferraioli_julia
url: https://www.juliaferraioli.com/
en: Julia Ferraioli
- key: flake8
url: https://flake8.pycqa.org/
en: Flake8
Expand Down Expand Up @@ -148,9 +157,6 @@
- key: gnu_make
url: https://www.gnu.org/software/make/
en: GNU Make
- key: gorcenski_emily
url: https://emilygorcenski.com/post/book-report-software-design-by-example-by-greg-wilson/
en: Emily Gorcenski
- key: gutenberg
url: https://www.gutenberg.org/
en: Project Gutenberg
Expand Down Expand Up @@ -202,9 +208,6 @@

# K

- key: kerr_jessica
url: https://jessitron.com/2023/02/20/book-review-software-design-by-example/
en: Jessica Kerr
- key: kilo_editor
url: https://viewsourcecode.org/snaptoken/kilo/index.html
en: kilo text editor
Expand Down Expand Up @@ -232,15 +235,15 @@
- key: marthas_rules
url: https://journals.sagepub.com/doi/10.1177/088610998600100206
en: Martha's Rules
- key: moore_jennifer
url: https://jenniferplusplus.com/
en: Jennifer Moore

# N

- key: nano
url: https://www.nano-editor.org/
en: Nano text editor
- key: navarro_danielle
url: https://blog.djnavarro.net/posts/2023-05-31_software-design-by-example/
en: Danielle Navarro
- key: nginx
url: https://nginx.org/
en: nginx
Expand Down Expand Up @@ -406,7 +409,7 @@
# S

- key: schiffer_jenn
url: https://mastodon.social/@[email protected]/109985276835264400
url: https://jennschiffer.com/
en: Jenn Schiffer
- key: scons
url: https://www.scons.org/
Expand All @@ -423,6 +426,9 @@
- key: sinel_joseph
url: https://en.wikipedia.org/wiki/Joseph_Claude_Sinel
en: Joseph Sinel
- key: smith_sue
url: https://www.benormal.info/
en: Sue Smith
- key: snakemake
url: https://snakemake.readthedocs.io/
en: Snakemake
Expand All @@ -447,6 +453,9 @@
- key: textualize_fraction
url: https://www.textualize.io/blog/7-things-ive-learned-building-a-modern-tui-framework/
en: "A clever use of the `Fraction` package"
- key: troy_chelsea
url: https://chelseatroy.com/
en: Chelsea Troy

# U

Expand All @@ -473,6 +482,9 @@
- key: wave
url: https://wave.webaim.org/
en: WAVE
- key: weakly_hazel
url: https://hazelweakly.me/
en: Hazel Weakly
- key: write_yourself_a_git
url: https://wyag.thb.lt/
en: Write yourself a Git
Expand Down
73 changes: 57 additions & 16 deletions src/intro/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -202,24 +202,65 @@ All contributors are required to abide by our Code of Conduct

Here's what people said about the JavaScript version of this book [%b Wilson2022a %]:

- [Jessica Kerr][kerr_jessica]:
"*Software Design by Example* is the book I'll recommend to every new dev…
It is nice to you.
It wants you to succeed…
It's a bridge from 'learn to program' to working programmer."
- [Alberto Bacchelli][bacchelli_alberto]:
I've been using this book to teach software design to an undergraduate class of 250 students,
and the students and I love it!
The positive impact of the book is evident from the improvements in student grades
and the quality of their practical assignments,
reflecting the substantial learning that's taking place.
It's been a joy to see them feel so equipped and inspired.

- [Naomi Ceder][ceder_naomi]:
This is my new favorite book on the art of writing software.
There is so much to like about it—the way it leads the reader to explore and develop their understanding,
the choice of projects and examples,
the clarity of the instruction,
the Creative Commons license,
and much more.
It will be my first recommendation for people looking to really learn professional development,
either on their own or in a classroom setting.

- [Julia Ferraioli][ferraioli_julia]:
Blending computer science with sound software engineering practices (with citations!)
is difficult enough on its own,
but this book guides the reader through practical design patterns that they can put into practice.
The addition of historic anecdotes gives readers extra context for what they've learned
and brings theory back to practice.

- [Jennifer Moore][moore_jennifer]:
The book is an excellent guide for anyone going from "just programming" to building larger projects.
It's like a choose-your-own adventure,
but the adventure is learning to build very complex software as a composition of much simpler patterns.

- [Jenn Schiffer][schiffer_jenn]:
"I am v much enjoying gvwilson's book *Software Design by Example*.
It makes me miss teaching, it would be such a fun text to use!"

- [Emily Gorcenski][gorcenski_emily]:
"There's a lot of books on programming
but fewer books that couple software development with effective and practical use of tools,
presenting a language not as a main course but as a part of an engineering ecosystem.
Greg Wilson's book hits all the right notes in bringing together theory, pragmatism, and best practices."

- [Danielle Navarro][navarro_danielle]:
"The book is really bloody lovely."
This book is both a great refresher if you've not worked with Python in a long time,
or your next textbook if you know just enough to be a little dangerous and want to level up.
The exercises being tool-based means the experience gained will instantly feel applicable
to whatever you end up using the language for.

- [Sue Smith][smith_sue]:
I know I can share this book with folk in the confidence that
they'll get a guided experience that's both accessible and comprehensive,
leaving them with real world software skills.
Teaching using examples makes the techniques meaningful and tangible to the learner
which is in itself a great motivator,
and the use of tooling examples is a bonus.

- [Chelsea Troy][troy_chelsea]:
Rather than stacking up isolated examples divorced from practical use cases,
this book teaches concepts the way we use them: in collaboration with one another.
Filled with both pragmatic advice and juicy historical nuggets,
this book just might manage to do the thing I've tried to do in classrooms for half a decade:
transfer basic engineering skills
while conveying what it's like to manage complex software projects.

- [Hazel Weakly][weakly_hazel]:
This is an absolutely marvelous book.
Very rarely do insightful diagrams,
contentious syntax disambiguation,
and thoughtful attention to how humans learn and absorb information come together in a coherent package like this.
It is exactly the sort of book I wish I'd had at the start of my programming journey;
it would've saved me from countless lessons learned the hard way.

## Acknowledgments {: #intro-acknowledgments}

Expand Down

0 comments on commit 0d138e1

Please sign in to comment.