Skip to content

Commit dadc205

Browse files
committed
Reviews
1 parent 74e23c4 commit dadc205

File tree

4 files changed

+145
-44
lines changed

4 files changed

+145
-44
lines changed

docs/colophon/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ <h1>Colophon</h1>
8282
<li>
8383
<p>The colors in this theme
8484
are lightened versions of those used in <a href="https://third-bit.com/colophon/">classic Canadian postage stamps</a>.
85-
The art in the title is by <a href="https://blog.djnavarro.net/posts/2023-05-31_software-design-by-example/">Danielle Navarro</a>
85+
The art in the title is by <a href="https://art.djnavarro.net/">Danielle Navarro</a>
8686
and used with her gracious permission.</p>
8787
</li>
8888
<li>

docs/intro/index.html

Lines changed: 60 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -258,27 +258,72 @@ <h2 id="intro-praise">What People Are Saying</h2>
258258
<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>
259259
<ul>
260260
<li>
261-
<p><a href="https://jessitron.com/2023/02/20/book-review-software-design-by-example/">Jessica Kerr</a>:
262-
&ldquo;<em>Software Design by Example</em> is the book I&rsquo;ll recommend to every new dev…
263-
It is nice to you.
264-
It wants you to succeed…
265-
It&rsquo;s a bridge from &lsquo;learn to program&rsquo; to working programmer.&rdquo;</p>
261+
<p><a href="https://sback.it/">Alberto Bacchelli</a>:
262+
I&rsquo;ve been using this book to teach software design to an undergraduate class of 250 students,
263+
and the students and I love it!
264+
The positive impact of the book is evident from the improvements in student grades
265+
and the quality of their practical assignments,
266+
reflecting the substantial learning that&rsquo;s taking place.
267+
It&rsquo;s been a joy to see them feel so equipped and inspired.</p>
266268
</li>
267269
<li>
268-
<p><a href="https://mastodon.social/@[email protected]/109985276835264400">Jenn Schiffer</a>:
269-
&ldquo;I am v much enjoying gvwilson&rsquo;s book <em>Software Design by Example</em>.
270-
It makes me miss teaching, it would be such a fun text to use!&rdquo;</p>
270+
<p><a href="https://naomiceder.tech/">Naomi Ceder</a>:
271+
This is my new favorite book on the art of writing software.
272+
There is so much to like about it—the way it leads the reader to explore and develop their understanding,
273+
the choice of projects and examples,
274+
the clarity of the instruction,
275+
the Creative Commons license,
276+
and much more.
277+
It will be my first recommendation for people looking to really learn professional development,
278+
either on their own or in a classroom setting.</p>
271279
</li>
272280
<li>
273-
<p><a href="https://emilygorcenski.com/post/book-report-software-design-by-example-by-greg-wilson/">Emily Gorcenski</a>:
274-
&ldquo;There&rsquo;s a lot of books on programming
275-
but fewer books that couple software development with effective and practical use of tools,
276-
presenting a language not as a main course but as a part of an engineering ecosystem.
277-
Greg Wilson&rsquo;s book hits all the right notes in bringing together theory, pragmatism, and best practices.&rdquo;</p>
281+
<p><a href="https://www.juliaferraioli.com/">Julia Ferraioli</a>:
282+
Blending computer science with sound software engineering practices (with citations!)
283+
is difficult enough on its own,
284+
but this book guides the reader through practical design patterns that they can put into practice.
285+
The addition of historic anecdotes gives readers extra context for what they&rsquo;ve learned
286+
and brings theory back to practice.</p>
278287
</li>
279288
<li>
280-
<p><a href="https://blog.djnavarro.net/posts/2023-05-31_software-design-by-example/">Danielle Navarro</a>:
281-
&ldquo;The book is really bloody lovely.&rdquo;</p>
289+
<p><a href="https://jenniferplusplus.com/">Jennifer Moore</a>:
290+
The book is an excellent guide for anyone going from &ldquo;just programming&rdquo; to building larger projects.
291+
It&rsquo;s like a choose-your-own adventure,
292+
but the adventure is learning to build very complex software as a composition of much simpler patterns.</p>
293+
</li>
294+
<li>
295+
<p><a href="https://jennschiffer.com/">Jenn Schiffer</a>:
296+
This book is both a great refresher if you&rsquo;ve not worked with Python in a long time,
297+
or your next textbook if you know just enough to be a little dangerous and want to level up.
298+
The exercises being tool-based means the experience gained will instantly feel applicable
299+
to whatever you end up using the language for.</p>
300+
</li>
301+
<li>
302+
<p><a href="https://www.benormal.info/">Sue Smith</a>:
303+
I know I can share this book with folk in the confidence that
304+
they&rsquo;ll get a guided experience that&rsquo;s both accessible and comprehensive,
305+
leaving them with real world software skills.
306+
Teaching using examples makes the techniques meaningful and tangible to the learner
307+
which is in itself a great motivator,
308+
and the use of tooling examples is a bonus.</p>
309+
</li>
310+
<li>
311+
<p><a href="https://chelseatroy.com/">Chelsea Troy</a>:
312+
Rather than stacking up isolated examples divorced from practical use cases,
313+
this book teaches concepts the way we use them: in collaboration with one another.
314+
Filled with both pragmatic advice and juicy historical nuggets,
315+
this book just might manage to do the thing I&rsquo;ve tried to do in classrooms for half a decade:
316+
transfer basic engineering skills
317+
while conveying what it&rsquo;s like to manage complex software projects.</p>
318+
</li>
319+
<li>
320+
<p><a href="https://hazelweakly.me/">Hazel Weakly</a>:
321+
This is an absolutely marvelous book.
322+
Very rarely do insightful diagrams,
323+
contentious syntax disambiguation,
324+
and thoughtful attention to how humans learn and absorb information come together in a coherent package like this.
325+
It is exactly the sort of book I wish I&rsquo;d had at the start of my programming journey;
326+
it would&rsquo;ve saved me from countless lessons learned the hard way.</p>
282327
</li>
283328
</ul>
284329
<h2 id="intro-acknowledgments">Acknowledgments</h2>

info/links.yml

Lines changed: 27 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@
1818

1919
# B
2020

21-
- key: bs4
22-
url: https://beautiful-soup-4.readthedocs.io/
23-
en: Beautiful Soup
21+
- key: bacchelli_alberto
22+
url: https://sback.it/
23+
en: Alberto Bacchelli
2424
- key: beuchat_odin
2525
url: https://www.drafolin.ch/
2626
en: Odin Beuchat
@@ -51,6 +51,9 @@
5151
- key: brubeck_matt
5252
url: https://limpet.net/mbrubeck/
5353
en: Matt Brubeck
54+
- key: bs4
55+
url: https://beautiful-soup-4.readthedocs.io/
56+
en: Beautiful Soup
5457

5558
# C
5659

@@ -61,6 +64,9 @@
6164
url: https://creativecommons.org/licenses/by-nc/4.0/legalcode
6265
en: CC-BY-NC License (full text)
6366
direct: true
67+
- key: ceder_naomi
68+
url: https://naomiceder.tech/
69+
en: Naomi Ceder
6470
- key: clarkes_laws
6571
url: https://en.wikipedia.org/wiki/Clarke%27s_three_laws
6672
en: "Clarke's Laws on Wikipedia"
@@ -121,6 +127,9 @@
121127

122128
# F
123129

130+
- key: ferraioli_julia
131+
url: https://www.juliaferraioli.com/
132+
en: Julia Ferraioli
124133
- key: flake8
125134
url: https://flake8.pycqa.org/
126135
en: Flake8
@@ -148,9 +157,6 @@
148157
- key: gnu_make
149158
url: https://www.gnu.org/software/make/
150159
en: GNU Make
151-
- key: gorcenski_emily
152-
url: https://emilygorcenski.com/post/book-report-software-design-by-example-by-greg-wilson/
153-
en: Emily Gorcenski
154160
- key: gutenberg
155161
url: https://www.gutenberg.org/
156162
en: Project Gutenberg
@@ -202,9 +208,6 @@
202208

203209
# K
204210

205-
- key: kerr_jessica
206-
url: https://jessitron.com/2023/02/20/book-review-software-design-by-example/
207-
en: Jessica Kerr
208211
- key: kilo_editor
209212
url: https://viewsourcecode.org/snaptoken/kilo/index.html
210213
en: kilo text editor
@@ -232,15 +235,18 @@
232235
- key: marthas_rules
233236
url: https://journals.sagepub.com/doi/10.1177/088610998600100206
234237
en: Martha's Rules
238+
- key: moore_jennifer
239+
url: https://jenniferplusplus.com/
240+
en: Jennifer Moore
235241

236242
# N
237243

238244
- key: nano
239245
url: https://www.nano-editor.org/
240246
en: Nano text editor
241247
- key: navarro_danielle
242-
url: https://blog.djnavarro.net/posts/2023-05-31_software-design-by-example/
243-
en: Danielle Navarro
248+
url: "https://art.djnavarro.net/"
249+
title: "Danielle Navarro"
244250
- key: nginx
245251
url: https://nginx.org/
246252
en: nginx
@@ -406,7 +412,7 @@
406412
# S
407413

408414
- key: schiffer_jenn
409-
url: https://mastodon.social/@[email protected]/109985276835264400
415+
url: https://jennschiffer.com/
410416
en: Jenn Schiffer
411417
- key: scons
412418
url: https://www.scons.org/
@@ -423,6 +429,9 @@
423429
- key: sinel_joseph
424430
url: https://en.wikipedia.org/wiki/Joseph_Claude_Sinel
425431
en: Joseph Sinel
432+
- key: smith_sue
433+
url: https://www.benormal.info/
434+
en: Sue Smith
426435
- key: snakemake
427436
url: https://snakemake.readthedocs.io/
428437
en: Snakemake
@@ -447,6 +456,9 @@
447456
- key: textualize_fraction
448457
url: https://www.textualize.io/blog/7-things-ive-learned-building-a-modern-tui-framework/
449458
en: "A clever use of the `Fraction` package"
459+
- key: troy_chelsea
460+
url: https://chelseatroy.com/
461+
en: Chelsea Troy
450462

451463
# U
452464

@@ -473,6 +485,9 @@
473485
- key: wave
474486
url: https://wave.webaim.org/
475487
en: WAVE
488+
- key: weakly_hazel
489+
url: https://hazelweakly.me/
490+
en: Hazel Weakly
476491
- key: write_yourself_a_git
477492
url: https://wyag.thb.lt/
478493
en: Write yourself a Git

src/intro/index.md

Lines changed: 57 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -202,24 +202,65 @@ All contributors are required to abide by our Code of Conduct
202202

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

205-
- [Jessica Kerr][kerr_jessica]:
206-
"*Software Design by Example* is the book I'll recommend to every new dev…
207-
It is nice to you.
208-
It wants you to succeed…
209-
It's a bridge from 'learn to program' to working programmer."
205+
- [Alberto Bacchelli][bacchelli_alberto]:
206+
I've been using this book to teach software design to an undergraduate class of 250 students,
207+
and the students and I love it!
208+
The positive impact of the book is evident from the improvements in student grades
209+
and the quality of their practical assignments,
210+
reflecting the substantial learning that's taking place.
211+
It's been a joy to see them feel so equipped and inspired.
212+
213+
- [Naomi Ceder][ceder_naomi]:
214+
This is my new favorite book on the art of writing software.
215+
There is so much to like about it—the way it leads the reader to explore and develop their understanding,
216+
the choice of projects and examples,
217+
the clarity of the instruction,
218+
the Creative Commons license,
219+
and much more.
220+
It will be my first recommendation for people looking to really learn professional development,
221+
either on their own or in a classroom setting.
222+
223+
- [Julia Ferraioli][ferraioli_julia]:
224+
Blending computer science with sound software engineering practices (with citations!)
225+
is difficult enough on its own,
226+
but this book guides the reader through practical design patterns that they can put into practice.
227+
The addition of historic anecdotes gives readers extra context for what they've learned
228+
and brings theory back to practice.
229+
230+
- [Jennifer Moore][moore_jennifer]:
231+
The book is an excellent guide for anyone going from "just programming" to building larger projects.
232+
It's like a choose-your-own adventure,
233+
but the adventure is learning to build very complex software as a composition of much simpler patterns.
210234

211235
- [Jenn Schiffer][schiffer_jenn]:
212-
"I am v much enjoying gvwilson's book *Software Design by Example*.
213-
It makes me miss teaching, it would be such a fun text to use!"
214-
215-
- [Emily Gorcenski][gorcenski_emily]:
216-
"There's a lot of books on programming
217-
but fewer books that couple software development with effective and practical use of tools,
218-
presenting a language not as a main course but as a part of an engineering ecosystem.
219-
Greg Wilson's book hits all the right notes in bringing together theory, pragmatism, and best practices."
220-
221-
- [Danielle Navarro][navarro_danielle]:
222-
"The book is really bloody lovely."
236+
This book is both a great refresher if you've not worked with Python in a long time,
237+
or your next textbook if you know just enough to be a little dangerous and want to level up.
238+
The exercises being tool-based means the experience gained will instantly feel applicable
239+
to whatever you end up using the language for.
240+
241+
- [Sue Smith][smith_sue]:
242+
I know I can share this book with folk in the confidence that
243+
they'll get a guided experience that's both accessible and comprehensive,
244+
leaving them with real world software skills.
245+
Teaching using examples makes the techniques meaningful and tangible to the learner
246+
which is in itself a great motivator,
247+
and the use of tooling examples is a bonus.
248+
249+
- [Chelsea Troy][troy_chelsea]:
250+
Rather than stacking up isolated examples divorced from practical use cases,
251+
this book teaches concepts the way we use them: in collaboration with one another.
252+
Filled with both pragmatic advice and juicy historical nuggets,
253+
this book just might manage to do the thing I've tried to do in classrooms for half a decade:
254+
transfer basic engineering skills
255+
while conveying what it's like to manage complex software projects.
256+
257+
- [Hazel Weakly][weakly_hazel]:
258+
This is an absolutely marvelous book.
259+
Very rarely do insightful diagrams,
260+
contentious syntax disambiguation,
261+
and thoughtful attention to how humans learn and absorb information come together in a coherent package like this.
262+
It is exactly the sort of book I wish I'd had at the start of my programming journey;
263+
it would've saved me from countless lessons learned the hard way.
223264

224265
## Acknowledgments {: #intro-acknowledgments}
225266

0 commit comments

Comments
 (0)