More edits for chapter 01
authorCraig Maloney <craig@decafbad.net>
Sat, 4 Aug 2018 11:58:11 +0000 (07:58 -0400)
committerCraig Maloney <craig@decafbad.net>
Sat, 4 Aug 2018 11:58:11 +0000 (07:58 -0400)
chapter01.md

index 0e5a614cf051b56c3f769250ad99333b56888820..12c99a58fd3b5b28ed6c42698cde50a1090de24b 100644 (file)
@@ -1,25 +1,29 @@
 # The Journey of the mediocre programmer
 ## How we got here
 
-You have your own unique story of how you got here as a programmer. Whether you found out about programming as a curious child who wanted to see what the computer could do, or as an adult who heard that there were these things called computers that you could program, you had a journey to get to this point. And you learned a certain amount to get here. You spent your free time learning how to code or you were fortunate to be able to work on it as part of your job. You went to school to learn more about programming or you took training classes. You bought books or read articles online to learn more about programming. Whatever the path you took you started the journey as a programmer.
+You have your own unique story of how you got here as a programmer. Whether you found out about programming as a curious child who wanted to see what the computer could do, or as an adult who heard that there were these things called computers that you could program, you had a journey to get to this point. And you learned a certain amount to get here. You spent your free time learning how to code or you were fortunate to be able to work on programming as part of your job. You went to school to learn more about programming or you took training classes. You bought books or read articles online to learn more about programming. Whatever the path you took you started the journey as a programmer.
 
 And now you feel stuck.
 
-You look around and wonder if you'll ever know everything that you should know. You read an article on a site and your interest is piqued. A friend online mentions this neat thing that they've found and expects that you should learn more about it. Your colleague found something that seems to solve the issues you're having at work and now you have one more thing to learn. Whatever it is there is now a gap between the you that exists today and the you that feels like you are incomplete without learning this new thing.
+You look around and wonder if you'll ever know everything that you should know. You read an article on a site and your interest is piqued. A friend online mentions this neat thing that they've found and expects that you will learn more about it. Your colleague found something that might solve an issue you're having at work on a project and now you have one more thing to learn. 
 
-Perhaps you're seeing this new thing show up in job postings with a minimum of 3+ years of required experience and you're wondering how anyone would have that level of experience yet. Or you chose to ignore that thing for a while and now it's become a driving factor in your domain of work. And now you look over the horizon of where you feel you should be and you see the gap in between where you are and where you think you should be.
+Perhaps you're seeing new things show up in job postings with a minimum of 3+ years of required experience and you're wondering how anyone would have that level of experience yet. Or you chose to ignore that thing for a while and now it's become a driving factor in your domain of work. It's as if someone flipped a bit somewhere and now you're suddenly unworthy of being called a programmer unless you know this thing. 
+
+Each of these experiences causes you to feel as though you are incomplete without learning these new things. They show us that no matter our current experience there are still gaps in our knowledge that must be filled. As you look to the horizon you can see the gaps that creep up in between where you are and where you think you should be.
 
 ## The Gap
 
-I've chosen the word "gap" to describe the difference between where you are now and where you think you should be for good reason. A gap tends to be something imposed by others, whether by force or by neglect. If you have a gap in a fence it means the fence seems weaker because of the missing slats. A gap can also be something that one would need to be aware of. "Mind the gap" is a phrase that was coined in the late 1960s by the London Underground to warn folks about the space between the platform and the train cars that could lead to an unsafe situation.
+I've chosen the word "gap" to describe the difference between where you are now and where you think you should be for good reason. A gap is something imposed by others, whether by force or by neglect. If a gap appears in your garden fence it means the fence is weaker at protecting the garden. A gap can also be something that requires our attention. "Mind the gap" is a phrase coined in the late 1960s by the London Underground to warn folks of the space between the platform and the train cars. If someone weren't careful around that gap it could lead to an unsafe situation.
+
+The gap in this case is the distance between our current abilities and where we think we should be. Sometimes the gaps are self-imposed because of our desires to improve ourselves, but more often the gap is externally imposed. 
 
-The gap in this case is the distance in our current abilities and where we think we should be. Sometimes they are self-imposed but more often they are externally imposed. Often they are the result of a changing industry or changing priorities and it is our job as programmers to adapt to those changes.
+One of the biggest creators of gaps in our programming career is change. As programmers we are fully aware of the cycle of change in programming culture. We're constantly having changes thrown at us: changing technology, changing priorities at work, or even changing our strategies to try to keep up with the demands made of us.
 
-But change can lead to stress. Stress is prevalent in programmer circles because things are often changing. What worked on Friday afternoon can be different on Monday morning because of a small point release in a library that we were using. Or our development machine was upgraded and now our code has new bugs to fix.
+Change can also come from within our community. Our community of developers and users could move on to a new technology; whether for personal or professional reasons. We may no longer get the support we need to do our jobs and be faced with the prospect that we too need to update our skills or be left behind in an abandoned community.
 
-Change can also come from outside of our domain. Our community of developers might move on to a new technology; whether that is because of professional reasons or personal reasons. We might no longer get the support we need to do our jobs and be faced with the prospect that we too need to update our skills or be left behind in an abandoned community.
+Change can lead to stress. Stress is prevalent in programmer circles because things are often changing. What worked on Friday afternoon can be broken on Monday morning because of a change to a library that we were using. Our development environment could break because of an upgrade that didn't apply properly. Production might need security fixes and those fixes mean we have to redo a major piece of our software because it no longer works. There are plenty of ways in which we are kept in a cycle of change.
 
-Not all change is because of bad events happening. The software that we use could have very good reasons for changing. New features can be introduced that require new ways of thinking about your code.
+Not all change is because of bad events happening. The software that we use could have very good reasons for changing. New features can be introduced that require new ways of thinking about your code. Security fixes may mean that our systems are more resilient to outside attacks, but require different ways of using that system. New optimizations may lead to our code running faster but need a few tweaks to take advantage of those speed benefits.
 
 But change requires time and effort in order to adapt to it. The gap can only be closed if we have the resources and time to work on it.