Editing the introduction
authorCraig Maloney <craig@decafbad.net>
Wed, 18 Jul 2018 11:37:52 +0000 (07:37 -0400)
committerCraig Maloney <craig@decafbad.net>
Wed, 18 Jul 2018 11:37:52 +0000 (07:37 -0400)
intro.md
title.txt

index 5bff39fc2a7a59f486736a09641084cd2efde28b..0c732791af3766c5ea5afcf9319938166ea5da64 100644 (file)
--- a/intro.md
+++ b/intro.md
@@ -2,27 +2,27 @@
 
 ## The Mediocre Programmer?
 
-Let's face it; we don't want to be mediocre programmers. We want to be great programmers; superlative programmers. We want to be the programmers they call whenever they're in a bind and we want to be the programmers that rush into the code base and produce perfect code in a matter of minutes. Code that would sit in the Louvre as a work of art, studied by generations of programmers for its intrinsic beauty and exceptional functionality.
+Let's face it: we don't want to be mediocre programmers. We want to be ``[great|amazing|superlative]`` programmers! We want to be the programmers they call whenever they're in a bind and we want to be the programmers that rush into unfamiliar code bases and produce perfect code in a matter of minutes. Code that would sit in the Louvre as a work of art, studied by generations of programmers for its intrinsic beauty and exceptional functionality.
 
-Why would we want to be mediocre programmers? Mediocre is the opposite of great. Shouldn't we strive to be great programmers?
+Why would we want to be mediocre programmers? Isn't mediocre the opposite of great? Shouldn't we strive to be great programmers instead?
 
-Sure, we should strive to be great programmers in the long term. But to become great programmers we have to pass through being mediocre programmers first.
+Sure, we should strive to be great programmers in the long term, but to become great programmers we have to pass through being mediocre programmers first.
 
-Mediocre programmers know that they're not great yet. Mediocre programmers see the distance between where they are and where they want to go in their programming career. They see the work that goes into a being a great programmer and they know that one day they'd like to be that great programmer.
+Mediocre programmers know they're not great programmers yet. Mediocre programmers see the distance between where they are and the greatness they want in their programming career. They see the work that goes into a being a great programmer and believe that if they do the work that one day they too will be great programmer.
 
-But they also see their own faults and failings. They see their browser history littered with online-searches for basic syntax and concepts. They see their email archives of questions they've asked other developers. They look at their code from several months back and wonder if they'll ever get to be great programmers with all of those mistakes and missteps. They see the gap between them and the great developer they wish to be and it feels like that gap widens every step of the way.
+But they also see their own faults and failings. They see their browser history littered with online-searches for basic syntax and concepts. They see their email archives of questions they've asked other programmers. They look at their code from several months before and wonder if they'll ever get to be great programmers with all of those mistakes and missteps. They see the gap between them and being a great programmer and it feels like the gap widens every step of the way.
 
-The mediocre developer wonders if it's even worth it; if they should do something else with their lives other then computer programming. Maybe they're not as good as they thought they were, or maybe they lack that special talent that great developers have. Maybe they learned the wrong things early on in their journey, or maybe they think they should have started sooner.
+The mediocre programmer wonders if it's even worth it; if they should do something else with their lives other then computer programming. Maybe they're not as good as they thought they were, or maybe they lack that special talent that great programmers have. Maybe they learned the wrong things early on in their journey, or maybe they think they should have started sooner.
 
-They see others being wildly successful and wonder if they were absent the day that the good programming genes were handed out.
+They see others being wildly successful and wonder if they were absent the day the great programmer genes were handed out.
 
-The truth is we're all mediocre developers in some way. We all still ask questions and have to look up syntax and concepts in our day-to-day programming. Computers continue to add complexity to everyday programming tasks and it takes a lot of mental bandwidth to keep all of those concepts fresh in our mind.
+The truth is we're all mediocre programmers in some way. We all still ask questions and have to look up syntax and concepts in our day-to-day programming. Computers continue to add complexity to everyday programming tasks and it takes a lot of mental bandwidth to keep all of those concepts fresh in our mind.
 
 ## Why this book?
 
-This book is about helping you along on the journey of being a mediocre developer. Together we'll uncover some of common misconceptions we have about programming, failure, and growth and come to understand that the act of programming and development is something we undertake each day and improve in small ways. It's these small changes that over time transform us from being mediocre developers into better developers.
+This book is about helping you along on the journey of being a mediocre programmer. Together we'll uncover some of common misconceptions we have about programming, failure, and growth and come to understand that the act of programming and development is something we undertake each day and improve in small ways. It's these small changes that over time transform us from being mediocre programmers into better programmers.
 
-There are plenty of books on how to become a better developer out there. Usually they have checklists and other things that the author deems important for you to do in order to become a better developer. This book will try not to saddle you with more work (you likely have enough as it is). Rather, we'll discuss what it feels like to be a programmer. We'll talk about the emotion of being a programmer; the feelings of frustration, guilt, anger, and inadequacy. We'll talk about those feelings you have of giving up and walking away from computing and whether those feelings come from a place of love or a worry that you're not keeping up.
+There are plenty of books on how to become a better programmer out there. Usually they have checklists and other things that the author deems important for you to do in order to become a better programmer. They tend to focus on specifics like choosing a better editor, writing better test cases, or drinking lots of water. Those books have a lot of useful advice, but they read like a laundry list of things that you must do all at once in order to succeed. This book will try not to saddle you with more work (you likely have enough as it is). Rather, we'll discuss what it feels like to be a programmer. We'll talk about the emotions in being a programmer; the feelings of frustration, guilt, anger, and inadequacy. We'll cover the struggles in learning new things and keeping your skills current. We'll talk about those times when you feel like giving up and walking away from computing and whether those feelings come from a place of love or a worry that you're not keeping up.
 
 This book is a personal journey for both of us. It's a memoir of my time as a programmer and my feelings along the way. I've thought many times about giving up and finding a different career path but doing anything other than being a computer programmer scares me even more. Does that mean I'm stuck in a perverse ouroboros of self-pity and self-doubt? Hardly. It means that I need to dig deeper to understand why I chose the path of being a programmer and realize that it took a lot to get here and it's going to take a lot more to get where I want to be. It's a commitment to seeing things as they are now and moving forward from wherever I'm standing.
 
index 7100693ab7002d6e0f52df224860a853902ef662..1d7da940a67978955e3b3d49bce66a2a43b6e37c 100644 (file)
--- a/title.txt
+++ b/title.txt
@@ -1,3 +1,3 @@
 % The Mediocre Programmer
-% Craig Maloney
-% Released under the CC-BY-SA International 4.0 license
+% Written by Craig Maloney
+% \textcopyright 2018 by Craig Maloney. \break Released under the CC-BY-SA International 4.0 license