Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit cf3ee15

Browse files
authored
Merge pull request #218 from pzelnip/inclusive_lang
Adapt language to be more inclusive
2 parents de9e0d7 + e2c5a18 commit cf3ee15

26 files changed

+74
-71
lines changed

content/book-review-clean-coder.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,11 @@ his/herself. How should we as professional developers act? What is the differe
2626
What are our responsibilities? When can we say no & how do we do it? When are we obligated to say yes? How do we get
2727
better at what we do?
2828

29-
Martin tries to distill his nearly 40 years of experience into some hard fought lessons. While it is very much
29+
Martin tries to distill their nearly 40 years of experience into some hard fought lessons. While it is very much
3030
appreciated to hear "tales from the trenches", the book does have a fairly heavy-handed "do as I say" tone. Don't do
3131
TDD? Well then you're not a professional. Do you create ambitious estimates? Well then, you're not a professional.
3232
From a rhetorical point of view, the book does rely on this "proof by appeal to professionalism" approach, rather than
33-
give solid evidence and data to back up many of the arguments he makes. For example, the TDD chapter has the passage:
33+
give solid evidence and data to back up many of the arguments made. For example, the TDD chapter has the passage:
3434

3535
> Yes there have been lots of controversial blogs and articles written about TDD over the years and there still are.
3636
In the early days they were serious attempts at critique and understanding. Nowadays, however, they are just rants.
@@ -40,7 +40,7 @@ I feel like the paragraph should have ended with
4040
"QED". Hardly a conclusive argument in favour of TDD, and the off-hand dismissal of any critiques of the practice
4141
really does hurt the point he's making.
4242

43-
Having said all this, it is certainly clear that much of what he offers is good advice, and represents an open challenge
43+
Having said all this, it is certainly clear that much of what is offered is good advice, and represents an open challenge
4444
to developers to be better. If you put aside the "if you don't do this you're not professional" rhetoric, at its core
4545
this book is a call for developers to live up to the responsibility of the job they have been hired to do. Oftentimes
4646
we as developers like to silo ourselves off, focus on our narrowly defined technical tasks, and that is simply

content/book-review-java-puzzlers.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,8 @@ cover: static/imgs/default_page_imagev2.jpg
2121

2222
Java Puzzlers is not so much a book, but a collection of obscure corner cases in the Java programming language. The
2323
author (Joshua Bloch) is well known as the author of [Effective Java](http://www.amazon.ca/Effective-Java-2nd-Edition-Programming-ebook/dp/B000WJOUPA/ref=pd_sim_kinc_2)
24-
which is widely regarded as the premier text for the language, and furthermore he is one the designers and authors of
25-
the Java Collections Framework. So to say the least, he knows his stuff.
24+
which is widely regarded as the premier text for the language, and furthermore they are one the designers and authors of
25+
the Java Collections Framework. So to say the least, they know their stuff.
2626

2727
Each chapter of the book features a collection of "puzzlers" centered around a particular section of the language
2828
(examples include loops, strings, exceptions, classes, etc). Each "puzzler" is formulated where a puzzle (typically in

content/book-review-the-software-craftsman.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,14 +20,15 @@ cover: static/imgs/default_page_imagev2.jpg
2020
## Summary Of Content Read
2121

2222
This book frustrated me. I once had the fortune of seeing Sandro give a talk at the Software Craftsmanship North America
23-
(SCNA) conference in 2013, and found his talk uplifting, and inspirational. As a result of that, when I saw this book
23+
(SCNA) conference in 2013, and found that talk uplifting, and inspirational. As a result of that, when I saw this book
2424
had been released it was an "instant buy" for me.
2525

2626
Ultimately though I was incredibly disappointed by this book.
2727

2828
I wanted to like this book. Rather I wanted to love this book. And honestly, much of what Sandro espouses in this book
29-
I agree with and believe. But, this book is poorly written and filled with anecdotal "evidence" to support his claims.
30-
This is a shame, as there is much well documented, well-researched evidence to support much of what he argues for. See,
29+
I agree with and believe. But, this book is poorly written and filled with anecdotal "evidence" to support their claims.
30+
This is a shame, as there is much well documented, well-researched evidence to support much of what is argued for in this
31+
book. See,
3132
the thing is when you make empirical claims (ie - if you do TDD you will reduce bugs and therefore reduce costs, or if
3233
you pair with other developers you will create a culture of learning which will improve productivity, or if you hire
3334
craftsmen your company will be better off), you need to back that up with empirical evidence, not just "I had this job
@@ -57,7 +58,7 @@ thing and want to know more? For the Bob Martin's of the world? It's so inconsis
5758
audience who's only vaguely familiar with the craftsmanship movement, and other parts feel like unless you've been
5859
writing code for decades you'll have trouble relating.
5960

60-
I'm being overly harsh, there are nuggets of really good insights in this book and he certainly knows the craftsmanship
61+
I'm being overly harsh, there are nuggets of really good insights in this book and Sandro certainly knows the craftsmanship
6162
movement. The thing is though there's nothing you won't get from simply reading the blogs or books of some of the people
6263
in the craftsmanship community. If you've read Clean Coder by Bob Martin, there's no reason to read this book.
6364

content/cool-link-of-the-day.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Date: 2017-03-25 22:14
33
tags: shell
44
cover: static/imgs/default_page_imagev2.jpg
55

6-
Ever wanted to sanity check your shell scripts?  Check out <https://www.shellcheck.net/>
6+
Ever wanted to coherence check your shell scripts?  Check out <https://www.shellcheck.net/>
77

88
Provides a basic REPL that checks your shell scripts for common issues.  Kinda neat, and admittedly I learned a thing or
99
two while playing with it.

content/devopsdaysyyj.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -42,9 +42,9 @@ Anubhav works for [Hashicorp](https://www.hashicorp.com), well known for many to
4242
space such as Vagrant, Terraform, Vault, and others.
4343

4444
The talk started with a bit of a history lesson on how operations work has evolved over the last
45-
10 years or so, going from physical servers to virtualization, to the cloud, etc. He then dove
45+
10 years or so, going from physical servers to virtualization, to the cloud, etc. They then dove
4646
in to an overview of [Terraform](https://www.terraform.io/) which is a really great tool for provisioning
47-
infrastructure via code. He then concluded with a quick demo of using Terraform to provision a
47+
infrastructure via code. They then concluded with a quick demo of using Terraform to provision a
4848
webserver in Google Cloud with a DNS entry provisioned in AWS via Route 53. Simple, but really
4949
was a nice little overview of the kind of stuff that's possible with Terraform.
5050

@@ -57,7 +57,7 @@ the expense of the latter.
5757

5858
I think this is why I really enjoyed Eduardo's talk. Eduardo works for
5959
[Daitan Group](https://www.daitangroup.com)
60-
and he gave a description of their company's journey through DevOps transformation, not from
60+
and they gave a description of their company's journey through DevOps transformation, not from
6161
a tools & automation perspective, but on the perspective of the human focus. Discussions of
6262
the importance of empathy and communication, the challenges of collaborating with people from
6363
very different cultures, and some of the lessons learned along the way. Really inspiring,
@@ -66,7 +66,7 @@ and I enjoyed it a great deal.
6666
## Distributed Brute Force Login Attack - Peter Locke
6767

6868
Peter, like Jeff who did the Serverless talk earlier in the day, also works at
69-
[Giftbit](https://www.giftbit.com). In this talk he delved into how they've had to deal with
69+
[Giftbit](https://www.giftbit.com). In this talk they delved into how they've had to deal with
7070
distributed brute force login attacks where distributed botnets try to attack a login page
7171
with leaked credentials trying to compromise accounts on their service.
7272

@@ -81,7 +81,7 @@ could potentially be used was had.
8181
## Bitrot: A Story of Maintenance Failure - Will Whittaker
8282

8383
This talk was just funny. Will's been in the industry for some time, and told the story
84-
of a project he was a part of that started in the early 2000's, that he left, and came back
84+
of a project they were a part of that started in the early 2000's, that they left, and came back
8585
to and saw how the project had devolved in that time. Lots of humourous, cynical anecdotes
8686
about the horrors of maintaining a system for a long time.
8787

@@ -94,8 +94,8 @@ applications will likely become a maintenance nightmare years from now. Interes
9494
This again was one of the "human-side" talks of the day. Unfortunately the schedule doesn't
9595
have the speaker's name, and I didn't make a note of it, but the presenter told the story of
9696
how while working at a company as the head of the ops team, was in the hospital for the birth
97-
of his third son when he got a phone call from the CTO telling him that everything was on
98-
fire and he needed to fix it. Inspiring story of the cost of siloing from a human perspective.
97+
of their third son when they got a phone call from the CTO telling him that everything was on
98+
fire and they needed to fix it. Inspiring story of the cost of siloing from a human perspective.
9999
Lots of discussion on techniques they employed to help improve their culture & process over
100100
time (blameless post-mortems, release planning, etc).
101101

content/django-pytest-runner.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ video](https://www.youtube.com/watch?v=7it7JFPInX0) showing the process.
1717

1818
That's all fine and good, but one of the complaints I've heard from
1919
Django-ista's (is that a term? Djangoites? Django Devotees?) is that it means
20-
now the good old normal `python manage.py test` no longer works (well, I suppose
20+
now the good old plain `python manage.py test` no longer works (well, I suppose
2121
technically it still works, but doesn't use Pytest).
2222

2323
So challenge accepted, as one can certainly create [custom manage.py
@@ -27,7 +27,7 @@ Pytest instead of the default built-in runner.
2727

2828
## Python Manage.py pytest
2929

30-
So first challenge is "how do we run pytest from Python?" as normally you run
30+
So first challenge is "how do we run pytest from Python?" as typically you run
3131
Pytest as a command line tool. As it turns out there's [docs on how to do this
3232
on Pytest's site](https://docs.pytest.org/en/latest/usage.html#calling-pytest-from-python-code).
3333

@@ -58,7 +58,7 @@ class Command(BaseCommand):
5858
This works, in that now I can do `python manage.py pytest` and it'll run Pytest
5959
as if I just ran the `pytest` executable in the current directory.
6060

61-
Cool, but how do I start passing arguments? Normally in a custom Django
61+
Cool, but how do I start passing arguments? Typically in a custom Django
6262
management command you define a `add_arguments` function and use the `argparse`
6363
module to define the expected arguments for your custom command. In this case
6464
though, I essentially want the interface to Pytest, which would be non-trivial

content/embracing-change.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,11 @@ cover: static/imgs/default_page_imagev2.jpg
55

66
I recently listened to a recording of a webinar put on through the ACM titled
77
["Agile Methods: Agile Methods: The Good, the Hype and the Ugly"](https://event.on24.com/eventRegistration/EventLobbyServlet?target=reg20.jsp&eventid=937091&sessionid=1&key=5B3C11566E06BE6564E638C6DFE0F413&sourcepage=register)
8-
where Bertrand Meyer (the Eiffel/Design by Contract guy) gave his interpretation of the agile software movement, and how
9-
we may tweak agile thinking.
8+
where Bertrand Meyer (the Eiffel/Design by Contract person) gave their interpretation of the agile software movement,
9+
and how we may tweak agile thinking.
1010

11-
A point in particular caught my attention. He talked about a rephrasing of some of the agile principles as stated in
12-
the manifesto, and in particular he talked about rather than "embracing" change, one should "accept" change. While this
11+
A point in particular caught my attention. They talked about a rephrasing of some of the agile principles as stated in
12+
the manifesto, and in particular they talked about rather than "embracing" change, one should "accept" change. While this
1313
might seem like splitting hairs, I think it an important distinction, and one I completely disagree with. I'd like to
1414
elaborate why I feel the distinction matters.
1515

content/failure-bow-1-aws-lambda-goof.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -85,8 +85,9 @@ million Lambda requests:
8585
But that's nothing:the real problem was that each one of those lambda calls represented
8686
a PUT to a S3 bucket.
8787
PUT's with S3 are actually one of the more expensive operations. For the `ca-central-1`
88-
region where I host my stuff, it's currently $0.0055 per 1,000 of them. This sounds crazy
89-
cheap, and it is, but when you're doing about 1.1 million of them, well, that adds up:
88+
region where I host my stuff, it's currently $0.0055 per 1,000 of them. This
89+
sounds unbelievably cheap, and it is, but when you're doing about 1.1 million of
90+
them, well, that adds up:
9091

9192
![The S3 PUT count & costs]({static}/static/imgs/s3_costs-fs8.png)
9293

@@ -95,7 +96,7 @@ Queue the Iron Maiden -- 6, 6, 6, THE NUMBER OF THE BEAST!
9596
To give some context: this site usually costs me well under $0.50 a month, the biggest portion of
9697
which is Cloudfront which clocks in around $0.24. Everything else is misc stuff: data
9798
transfer, S3 storage costs, S3 request costs, I have some old data in Glacier, etc. So to
98-
see ~$7 accrued in a day felt, well, crazy.
99+
see ~$7 accrued in a day felt, well, excessive.
99100

100101
What really bugged me was how *dumb* I felt, such a silly mistake. What's kinda scary is
101102
that had I not gotten that email from AWS indicating I was close to the free tier limit,

content/iterm2-setup.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ piece of text at all times in the top right corner of the terminal window. It's
6363
handy for displaying things like what branch you're currently on or similar
6464
"contextual" items. For me because I do a lot of Python work and I'm constantly
6565
switching between various Python virtual environments I have my badge display
66-
the current Python version that's enabled. To set this up, I have the following
66+
the current Python version that's active. To set this up, I have the following
6767
in my `.bashrc` file:
6868

6969
```shell

content/lotd-code-reviews-and-prs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ included) can unfortunately bring to code reviews and have them turn adversarial
3636
than collaborative. One of the things I love about Sandya's article is that it shines a
3737
light on bad habits that are common, particularly amongst experienced developers. I've
3838
definitely been guilty of passing off opinion as fact as well as bombarding a review with
39-
an avalanche of comments. As well, she also not only points out some of the "bad" (or
39+
an avalanche of comments. As well, they also not only points out some of the "bad" (or
4040
toxic) behaviours but offers constructive practices. Really, really good stuff.
4141

4242
The last one I have is more lightweight:

content/m1-initial-impressions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ experienced through the lens of a developer.
2020

2121
Everything I've run through Rosetta has been flawless from a functionality
2222
perspective. Having said that though: anything run through Rosetta does seem to
23-
suck battery life. And not just apps that are normally CPU intensive. For
23+
suck battery life. And not just apps that are typically CPU intensive. For
2424
example: I found that having Dropbox (which doesn't support M1), Itsycal, and
2525
Spectacle constantly running in my menu bar all seemed to have a significant
2626
drain on battery life. I've since switched from
@@ -130,7 +130,7 @@ if I had my way I'd have Catalina instead of Big Sur on this machine
130130
131131
## In Summary
132132
133-
This machine is awesome. It's expensive (as all Macs are), but is crazy
133+
This machine is awesome. It's expensive (as all Macs are), but is super
134134
fast, and (once you get rid of all your Intel apps) sips battery very
135135
lightly.
136136

content/polyglotconf-2012.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ started with the facilitator soliciting people in the audience to share their ex
7676
were actually fairly small, anecdotal discussions about the difficulties of working with larger amounts of data with
7777
traditional RDBMS systems. Partway through an attendee (who is an employee of Amazon) chimed in and gave an intro on
7878
some of the concepts behind true big data (ie Amazon S3) systems. This was good and bad, while it was great to see
79-
someone with expert knowledge step in and share his insights, it did feel as though the talk moved from "how can we do
79+
someone with expert knowledge step in and share their insights, it did feel as though the talk moved from "how can we do
8080
big data, what are the challenges associated with it" to "if you need to do big data, you can use Amazon S3 for the backend".
8181

8282
# R and Python

content/polyglotconf-2017.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ true at this event, but it seemed particularly diverse to me this year than in p
3535
Union" discussion which has happened in prior years at the unconference. Unsurprisingly [React](https://github.com/reactjs)
3636
was a technology mentioned a fair bit in this session, as was [Vue.js](https://vuejs.org/).
3737

38-
I'm not a front-end guy, so this was definitely not my forte, but themes I took away from this session was the continued
38+
I'm not a front-end dev, so this was definitely not my forte, but themes I took away from this session was the continued
3939
explosion of the sheer number of JS frameworks out there. I didn't stick around for the entire session, instead following
4040
the law of two feet to switch to....
4141

0 commit comments

Comments
 (0)