From b63c628a6f49c5c52e53e5f67d4ac6473e6441d3 Mon Sep 17 00:00:00 2001 From: Julio Biason Date: Thu, 25 Jul 2019 12:19:03 -0300 Subject: [PATCH 1/8] New chapter: hero projects --- content/books/things-i-learnt/_index.md | 1 + .../google-code-style/index.md | 2 +- .../things-i-learnt/hero-projects/index.md | 31 +++++++++++++++++++ .../things-i-learnt/specialists/index.md | 2 +- 4 files changed, 34 insertions(+), 2 deletions(-) create mode 100644 content/books/things-i-learnt/hero-projects/index.md diff --git a/content/books/things-i-learnt/_index.md b/content/books/things-i-learnt/_index.md index 6e9ca1c..055c3f0 100644 --- a/content/books/things-i-learnt/_index.md +++ b/content/books/things-i-learnt/_index.md @@ -70,6 +70,7 @@ template = "section-contentless.html" * [Code Formatting Tools Are Ok, But No Silver Bullet](code-formatters) * [Code Style: Follow It](code-style) * [... Unless That Code Style Is The Google Code Style](google-code-style) + * [Hero Projects: You'll Have To Do It Yourself](hero-projects) * Personal * [Companies Look For Specialists But Keep Generalists Longer](specialists) * [Keep A List of Stupid Bugs That Took More Than 1 Hour To Solve](stupid-bugs-list) diff --git a/content/books/things-i-learnt/google-code-style/index.md b/content/books/things-i-learnt/google-code-style/index.md index db4c93d..5efeac4 100644 --- a/content/books/things-i-learnt/google-code-style/index.md +++ b/content/books/things-i-learnt/google-code-style/index.md @@ -16,4 +16,4 @@ The only reason to use Google Code Style is in case someone less smart than you decided it would be a good idea to use it. Then, I feel sorry for you, but you'll have to follow Google Code Style. -{{ chapters(prev_chapter_link="/books/things-i-learnt/code-style", prev_chapter_title="Code Style: Follow It", next_chapter_link="/books/things-i-learnt/google-code-style", next_chapter_title="... Unless That Code Style Is The Google Code Style") }} +{{ chapters(prev_chapter_link="/books/things-i-learnt/code-style", prev_chapter_title="Code Style: Follow It", next_chapter_link="/books/things-i-learnt/hero-projects", next_chapter_title="Hero Projects: You'll Have To Do It Yourself") }} diff --git a/content/books/things-i-learnt/hero-projects/index.md b/content/books/things-i-learnt/hero-projects/index.md new file mode 100644 index 0000000..ec631bd --- /dev/null +++ b/content/books/things-i-learnt/hero-projects/index.md @@ -0,0 +1,31 @@ ++++ +title = "Things I Learnt The Hard Way - ... Unless That Code Style Is The Google Code Style" +date = 2019-07-25 + +[taxonomies] +tags = ["en-au", "books", "things i learnt", "community", "teams", "hero project"] ++++ + +An "hero project" is a project/spec change that you personally think will +solve a group of problems in your project. It could be a different +architecture, a new framework or even a new language. + + + +Hero projects happen mostly when a single developer wants to prove something +without the support of the company or even the time they are in. + +On those projects, developers will spend their free time to write a +proof-of-concept, just to prove a point. + +And, sometimes, it just proves that they are were wrong. + +(Although that last point sounds a bit sad, if you have to do an hero project, +you'll still learn something new and, maybe, even add a new bullet point to +your CV.) + +Just to be clear: Sometimes an hero project will fail [because the answer is +obvious](/books/things-i-learnt/right-tool-obvious). Don't let that make you +feel down. + +{{ chapters(prev_chapter_link="/books/things-i-learnt/google-code-style", prev_chapter_title="... Unless That Code Style Is The Google Code Style", next_chapter_link="/books/things-i-learnt/specialists", next_chapter_title="Companies Look For Specialists But Keep Generalists Longer") }} diff --git a/content/books/things-i-learnt/specialists/index.md b/content/books/things-i-learnt/specialists/index.md index d5bb30c..843edcf 100644 --- a/content/books/things-i-learnt/specialists/index.md +++ b/content/books/things-i-learnt/specialists/index.md @@ -40,4 +40,4 @@ in C show up and guess who also knew C? [^1]: ... which led me into some sad times when I was working with Python. -{{ chapters(prev_chapter_link="/books/things-i-learnt/google-code-style", prev_chapter_title="... Unless That Code Style Is The Google Code Style", next_chapter_link="/books/things-i-learnt/stupid-bugs-list", next_chapter_title="Keep A List of Stupid Bugs That Took More Than 1 Hour To Solve") }} +{{ chapters(prev_chapter_link="/books/things-i-learnt/hero-projects", prev_chapter_title="Hero Projects: You'll Have To Do It Yourself", next_chapter_link="/books/things-i-learnt/stupid-bugs-list", next_chapter_title="Keep A List of Stupid Bugs That Took More Than 1 Hour To Solve") }} From f43fcbb06b260ed27fc12a77ba3e388c45a2bfe0 Mon Sep 17 00:00:00 2001 From: Julio Biason Date: Thu, 25 Jul 2019 12:29:09 -0300 Subject: [PATCH 2/8] New chapter: hero syndrome --- content/books/things-i-learnt/_index.md | 1 + .../things-i-learnt/hero-syndrome/index.md | 30 +++++++++++++++++++ .../things-i-learnt/toxic-people/index.md | 2 +- .../things-i-learnt/watch-reactions/index.md | 2 +- 4 files changed, 33 insertions(+), 2 deletions(-) create mode 100644 content/books/things-i-learnt/hero-syndrome/index.md diff --git a/content/books/things-i-learnt/_index.md b/content/books/things-i-learnt/_index.md index 055c3f0..e6974b2 100644 --- a/content/books/things-i-learnt/_index.md +++ b/content/books/things-i-learnt/_index.md @@ -82,6 +82,7 @@ template = "section-contentless.html" * [People Get Upset About Code And Architecture Quality 'Cause They Care](people-care) * [You'll Learn About Yourself The Hard Way](learn-about-yourself) * [Pay Attention On How People React To You](watch-reactions) + * [Don't Confuse Hero Project With Hero Syndrome](hero-syndrome) * [Beware of Toxic People](toxic-people) * [Beware of Microaggressions](microaggressions) * [Toxic/Aggressive People Are Not Fixable -- Unless It's You](fixable) diff --git a/content/books/things-i-learnt/hero-syndrome/index.md b/content/books/things-i-learnt/hero-syndrome/index.md new file mode 100644 index 0000000..d6908c3 --- /dev/null +++ b/content/books/things-i-learnt/hero-syndrome/index.md @@ -0,0 +1,30 @@ ++++ +title = "Things I Learnt The Hard Way - Don't Confuse Hero Project With Hero Syndrome" +date = 2019-07-25 + +[taxonomies] +tags = ["en-au", "books", "things i learnt", "personal", "hero syndrome"] ++++ + +Someone that suffers from Hero Syndrome will claim that things won't work +unless they are carefully watching over everything. + + + +I've seen this at least two times in my professional life. Usually, those +people are actually doing so much micromanaging that they are not other +realize when things are in trouble. + +I've even seen someone doing a poor job on _their job_, so things would break +and then start calling people out that he had to fix it 'cause nobody would. + +Don't do that. + +I know you can get frustrated when you're the only one realizing things are +breaking apart, but you can add some +[monitoring](/books/things-i-learnt/monitoring) to your project, asking your +manager to show your solution -- you can even mention it on your group/daily +stand up meeting -- and pointing out to people how to realize when your +project broke. Suddenly, people will realize how to monitor theirs too. + +{{ chapters(prev_chapter_link="/books/things-i-learnt/watch-reactions", prev_chapter_title="Pay Attention On How People React To You", next_chapter_link="/books/things-i-learnt/toxic-people", next_chapter_title="Beware of Toxic People") }} diff --git a/content/books/things-i-learnt/toxic-people/index.md b/content/books/things-i-learnt/toxic-people/index.md index 300acea..02f09a6 100644 --- a/content/books/things-i-learnt/toxic-people/index.md +++ b/content/books/things-i-learnt/toxic-people/index.md @@ -31,4 +31,4 @@ realize that you may be seen as toxic 'cause [you don't understand yourself yet](/books/things-i-learnt/learn-about-yourself) and the way [people react to you](/books/things-i-learnt/watch-reactions). -{{ chapters(prev_chapter_link="/books/things-i-learnt/watch-reactions", prev_chapter_title="Pay Attention On How People React To You", next_chapter_link="/books/things-i-learnt/microaggressions", next_chapter_title="Beware of Microaggressions") }} +{{ chapters(prev_chapter_link="/books/things-i-learnt/hero-syndrome", prev_chapter_title="Don't Confuse Hero Project With Hero Syndrome", next_chapter_link="/books/things-i-learnt/microaggressions", next_chapter_title="Beware of Microaggressions") }} diff --git a/content/books/things-i-learnt/watch-reactions/index.md b/content/books/things-i-learnt/watch-reactions/index.md index 7b890c1..0e31d19 100644 --- a/content/books/things-i-learnt/watch-reactions/index.md +++ b/content/books/things-i-learnt/watch-reactions/index.md @@ -28,4 +28,4 @@ they opening themselves to you or are they closing? [^1]: I have this "serious" problem that, depending on the word someone says, I recall some lyrics and suddenly start singing it. -{{ chapters(prev_chapter_link="/books/things-i-learnt/learn-about-yourself", prev_chapter_title="You'll Learn About Yourself The Hard Way", next_chapter_link="/books/things-i-learnt/toxic-people", next_chapter_title="Beware of Toxic People") }} +{{ chapters(prev_chapter_link="/books/things-i-learnt/learn-about-yourself", prev_chapter_title="You'll Learn About Yourself The Hard Way", next_chapter_link="/books/things-i-learnt/hero-syndrome", next_chapter_title="Don't Confuse Hero Project With Hero Syndrome") }} From d2d160b5e066bb2dff9c5b4ca25d77400ebd2f8c Mon Sep 17 00:00:00 2001 From: Julio Biason Date: Thu, 25 Jul 2019 12:37:37 -0300 Subject: [PATCH 3/8] New chapter: quit --- content/books/things-i-learnt/_index.md | 1 + .../books/things-i-learnt/fixable/index.md | 2 +- content/books/things-i-learnt/quit/index.md | 30 +++++++++++++++++++ 3 files changed, 32 insertions(+), 1 deletion(-) create mode 100644 content/books/things-i-learnt/quit/index.md diff --git a/content/books/things-i-learnt/_index.md b/content/books/things-i-learnt/_index.md index e6974b2..241facf 100644 --- a/content/books/things-i-learnt/_index.md +++ b/content/books/things-i-learnt/_index.md @@ -86,3 +86,4 @@ template = "section-contentless.html" * [Beware of Toxic People](toxic-people) * [Beware of Microaggressions](microaggressions) * [Toxic/Aggressive People Are Not Fixable -- Unless It's You](fixable) + * [Realize When It's Time To Quit](quit) diff --git a/content/books/things-i-learnt/fixable/index.md b/content/books/things-i-learnt/fixable/index.md index 32ab831..bb82fe1 100644 --- a/content/books/things-i-learnt/fixable/index.md +++ b/content/books/things-i-learnt/fixable/index.md @@ -28,4 +28,4 @@ you](/books/things-i-learnt/watch-reactions), you may notice that you may be doing this to others. And now the ball is in your park: Do you want to be a better person or not? -{{ chapters(prev_chapter_link="/books/things-i-learnt/microaggressions", prev_chapter_title="Beware of Microaggressions") }} +{{ chapters(prev_chapter_link="/books/things-i-learnt/microaggressions", prev_chapter_title="Beware of Microaggressions", next_chapter_link="/books/things-i-learnt/quit", next_chapter_title="Realize When It's Time To Quit") }} diff --git a/content/books/things-i-learnt/quit/index.md b/content/books/things-i-learnt/quit/index.md new file mode 100644 index 0000000..2b0430e --- /dev/null +++ b/content/books/things-i-learnt/quit/index.md @@ -0,0 +1,30 @@ ++++ +title = "Things I Learnt The Hard Way - Toxic/Aggressive People Are Not Fixable" +date = 2019-07-25 + +[taxonomies] +tags = ["en-au", "books", "things i learnt", "personal", "quit"] ++++ + +Instead of taking the blows and keep moving, maybe it would be better to your +own health to simply quit. + + + +Unexpected circumstances caused a delay on your task and your boss lashed at +you. + +You need to keep avoiding a guy that keeps bad mouthing some minority, +something that you don't agree. + +Another guy keeps an aggressive posture around women, and you know that's not +something nice to do. + +Yet a third one keeps complaining that, when he's not around, things don't +work. + +I've to say it: You're in a toxic environment. Even if the pay is nice and the +project is interesting, it's not worth your health. You'd end up being a +constantly pissed off, annoyed person on your forties (_cough_). + +{{ chapters(prev_chapter_link="/books/things-i-learnt/fixable", prev_chapter_title="Toxic/Aggressive People Are Not Fixable -- Unless It's You") }} From 344be0a718b6c7a35b0a60a54035e18fefb66f35 Mon Sep 17 00:00:00 2001 From: Julio Biason Date: Thu, 25 Jul 2019 12:47:51 -0300 Subject: [PATCH 4/8] New chapter: it is a small world --- content/books/things-i-learnt/_index.md | 1 + content/books/things-i-learnt/quit/index.md | 2 +- .../things-i-learnt/small-world/index.md | 36 +++++++++++++++++++ 3 files changed, 38 insertions(+), 1 deletion(-) create mode 100644 content/books/things-i-learnt/small-world/index.md diff --git a/content/books/things-i-learnt/_index.md b/content/books/things-i-learnt/_index.md index 241facf..acac128 100644 --- a/content/books/things-i-learnt/_index.md +++ b/content/books/things-i-learnt/_index.md @@ -87,3 +87,4 @@ template = "section-contentless.html" * [Beware of Microaggressions](microaggressions) * [Toxic/Aggressive People Are Not Fixable -- Unless It's You](fixable) * [Realize When It's Time To Quit](quit) + * [I.T. World Is Really Small](small-world) diff --git a/content/books/things-i-learnt/quit/index.md b/content/books/things-i-learnt/quit/index.md index 2b0430e..338cdd2 100644 --- a/content/books/things-i-learnt/quit/index.md +++ b/content/books/things-i-learnt/quit/index.md @@ -27,4 +27,4 @@ I've to say it: You're in a toxic environment. Even if the pay is nice and the project is interesting, it's not worth your health. You'd end up being a constantly pissed off, annoyed person on your forties (_cough_). -{{ chapters(prev_chapter_link="/books/things-i-learnt/fixable", prev_chapter_title="Toxic/Aggressive People Are Not Fixable -- Unless It's You") }} +{{ chapters(prev_chapter_link="/books/things-i-learnt/fixable", prev_chapter_title="Toxic/Aggressive People Are Not Fixable -- Unless It's You", next_chapter_link="/books/things-i-learnt/small-world", next_chapter_title="I.T. World Is Really Small") }} diff --git a/content/books/things-i-learnt/small-world/index.md b/content/books/things-i-learnt/small-world/index.md new file mode 100644 index 0000000..33205a6 --- /dev/null +++ b/content/books/things-i-learnt/small-world/index.md @@ -0,0 +1,36 @@ ++++ +title = "Things I Learnt The Hard Way - I.T. World Is Really Small" +date = 2019-07-25 + +[taxonomies] +tags = ["en-au", "books", "things i learnt", "personal"] ++++ + +We have two expressions here: "The world turns around"; it means whatever you +do, sometime in the future, you'll face the consequences of it. Another +expression is "The world of _something_ is an egg"; because the world turns +around, if the world is an egg, you'll face the consequences sooner than you +think. + + + +What do I meant with those two expressions? + +Well, first thing, if you do a bad job, if you don't care about your +co-workers, if you're not a team player, if you keep bad mouthing someone... +You'll find someone that heard about the things you do and may damage your +reputation. + +So be nice and a team player. + +Just to be clear: Yes, I did my fair share of not being a team player and bad +mouthing people[^1] and I'm pretty sure there are companies around that would +never hire me 'cause someone inside heard that I bad mouth someone or didn't +do as a team player in some other place. I try to avoid doing it so as much as +I can but, hey, I'm just human. + +[^1]: I still call actions of previous colleagues around even to this day. If + I'm bad mouthing or just telling what happened is up to whoever is listening + to me. + +{{ chapters(prev_chapter_link="/books/things-i-learnt/quit", prev_chapter_title="Realize When It's Time To Quit") }} From fd525652291f164948707fbfed6285e959a5b8ce Mon Sep 17 00:00:00 2001 From: Julio Biason Date: Thu, 25 Jul 2019 12:59:21 -0300 Subject: [PATCH 5/8] New chapter: paper trail --- content/books/things-i-learnt/_index.md | 1 + .../books/things-i-learnt/libraries/index.md | 2 +- .../things-i-learnt/paper-notes/index.md | 24 +++++++++++++++++++ .../books/things-i-learnt/throw-away/index.md | 2 +- 4 files changed, 27 insertions(+), 2 deletions(-) create mode 100644 content/books/things-i-learnt/paper-notes/index.md diff --git a/content/books/things-i-learnt/_index.md b/content/books/things-i-learnt/_index.md index acac128..7e16c78 100644 --- a/content/books/things-i-learnt/_index.md +++ b/content/books/things-i-learnt/_index.md @@ -37,6 +37,7 @@ template = "section-contentless.html" * Project Organization * [Organize Your Code by Data/Type, Not Functionality](project-organization) * [Create Libraries](libraries) + * [Paper Notes Are Actually Helpful](paper-notes) * Writing code * [Be Ready To Throw Your Code Away](throw-away) * [Future Thinking Is Future Trashing](future-trashing) diff --git a/content/books/things-i-learnt/libraries/index.md b/content/books/things-i-learnt/libraries/index.md index ac3a563..da487c4 100644 --- a/content/books/things-i-learnt/libraries/index.md +++ b/content/books/things-i-learnt/libraries/index.md @@ -45,4 +45,4 @@ your control, they are external to the project. So you may need to learn how to deal with this before creating the libraries. And, unfortunately, each language and build tool has its own way to manage this. -{{ chapters(prev_chapter_link="/books/things-i-learnt/project-organization", prev_chapter_title="Organize Your Code by Data/Type, Not Functionality", next_chapter_link="/books/things-i-learnt/throw-away", next_chapter_title="Be Ready To Throw Your Code Away") }} +{{ chapters(prev_chapter_link="/books/things-i-learnt/project-organization", prev_chapter_title="Organize Your Code by Data/Type, Not Functionality", next_chapter_link="/books/things-i-learnt/paper-notes", next_chapter_title="Paper Notes Are Actually Helpful") }} diff --git a/content/books/things-i-learnt/paper-notes/index.md b/content/books/things-i-learnt/paper-notes/index.md new file mode 100644 index 0000000..b33a1dd --- /dev/null +++ b/content/books/things-i-learnt/paper-notes/index.md @@ -0,0 +1,24 @@ ++++ +title = "Things I Learnt The Hard Way - Create Libraries" +date = 2019-07-25 + +[taxonomies] +tags = ["en-au", "books", "things i learnt", "paper notes", "post its", "project organization"] ++++ + +I've tried to go paperless many, many times. But keeping a notepad and a bunch +of post its in my desk has been one of the most helpful tools I ever got. + + + +I've even managed to hide all my pens, move notepads to desks and use some +note-taking application instead. In the end, none of those managed to come +close to the utility of having something to scribble notes fast, or to draw a +very high concept of whatever I'm trying to explain. + +Also, a desk full of post its, or even a monitor with a bunch of things around +gives the impression that you're really busy working -- just be careful to not +have too many post its, or it will look like you can't complete anything. It +even beats Trello! + +{{ chapters(prev_chapter_link="/books/things-i-learnt/libraries", prev_chapter_title="Create Libraries", next_chapter_link="/books/things-i-learnt/throw-away", next_chapter_title="Be Ready To Throw Your Code Away") }} diff --git a/content/books/things-i-learnt/throw-away/index.md b/content/books/things-i-learnt/throw-away/index.md index 7f4ace5..cd8922a 100644 --- a/content/books/things-i-learnt/throw-away/index.md +++ b/content/books/things-i-learnt/throw-away/index.md @@ -39,4 +39,4 @@ And not just code that solves the problem, but also the tests for that code. ... unless you focus mostly on [integration tests](/books/things-i-learnt/integration-tests). -{{ chapters(prev_chapter_link="/books/things-i-learnt/config-file", prev_chapter_title="The Config File Is Friend", next_chapter_link="/books/things-i-learnt/future-trashing", next_chapter_title="Future Thinking Is Future Trashing") }} +{{ chapters(prev_chapter_link="/books/things-i-learnt/paper-notes", prev_chapter_title="Be Ready To Throw Your Code Away", next_chapter_link="/books/things-i-learnt/future-trashing", next_chapter_title="Future Thinking Is Future Trashing") }} From 1ef67981709081208596f9a44e98dbac3786aeb2 Mon Sep 17 00:00:00 2001 From: Julio Biason Date: Thu, 25 Jul 2019 13:08:20 -0300 Subject: [PATCH 6/8] New chapter: blog it! --- content/books/things-i-learnt/_index.md | 1 + .../books/things-i-learnt/blogging/index.md | 33 +++++++++++++++++++ .../things-i-learnt/small-world/index.md | 2 +- 3 files changed, 35 insertions(+), 1 deletion(-) create mode 100644 content/books/things-i-learnt/blogging/index.md diff --git a/content/books/things-i-learnt/_index.md b/content/books/things-i-learnt/_index.md index 7e16c78..95d121b 100644 --- a/content/books/things-i-learnt/_index.md +++ b/content/books/things-i-learnt/_index.md @@ -89,3 +89,4 @@ template = "section-contentless.html" * [Toxic/Aggressive People Are Not Fixable -- Unless It's You](fixable) * [Realize When It's Time To Quit](quit) * [I.T. World Is Really Small](small-world) + * [Blogging About Your Stupid Solution Is Still Better Than Being Quiet](blogging) diff --git a/content/books/things-i-learnt/blogging/index.md b/content/books/things-i-learnt/blogging/index.md new file mode 100644 index 0000000..86ce961 --- /dev/null +++ b/content/books/things-i-learnt/blogging/index.md @@ -0,0 +1,33 @@ ++++ +title = "Things I Learnt The Hard Way - Blogging About Your Stupid Solution Is Still Better Than Being Quiet" +date = 2019-07-25 + +[taxonomies] +tags = ["en-au", "books", "things i learnt", "personal", "blogging"] ++++ + +You may feel "I'm not start enough to talk about this" or "This must be so +stupid I shouldn't talk about it". Don't. + + + +Create a blog. Post about your stupid solutions. They are still smarter than +someone else's solution. + +Also, come back later and fight your own solutions with better ones. + +Show your growth. + +But do yourself a favour and turn off comments. Unfortunately, the internet is +a toxic place and the fears you may have are created by a small portion of it +that doesn't care about people learning. + +Focus on your work. Focus on whatever you are thinking. Post about your +speculations if something would work. Revisit them later. Answer yourself. All +that will show that you're interested in the field and will count points +towards you. + +There are several options on where to blog; even Github/Gitlab can be used to +blogging, using their Pages features. + +{{ chapters(prev_chapter_link="/books/things-i-learnt/small-world", prev_chapter_title="I.T. World Is Really Small") }} diff --git a/content/books/things-i-learnt/small-world/index.md b/content/books/things-i-learnt/small-world/index.md index 33205a6..f1e4f30 100644 --- a/content/books/things-i-learnt/small-world/index.md +++ b/content/books/things-i-learnt/small-world/index.md @@ -33,4 +33,4 @@ I can but, hey, I'm just human. I'm bad mouthing or just telling what happened is up to whoever is listening to me. -{{ chapters(prev_chapter_link="/books/things-i-learnt/quit", prev_chapter_title="Realize When It's Time To Quit") }} +{{ chapters(prev_chapter_link="/books/things-i-learnt/quit", prev_chapter_title="Realize When It's Time To Quit", next_chapter_link="/books/things-i-learnt/blogging", next_chapter_title="Blogging About Your Stupid Solution Is Still Better Than Being Quiet") }} From dba62ed5b5156f8ee7383e61aaa5c45dfe262945 Mon Sep 17 00:00:00 2001 From: Julio Biason Date: Thu, 25 Jul 2019 13:16:28 -0300 Subject: [PATCH 7/8] New chapter: post your code --- content/books/things-i-learnt/_index.md | 1 + .../books/things-i-learnt/blogging/index.md | 2 +- .../things-i-learnt/post-solution/index.md | 35 +++++++++++++++++++ 3 files changed, 37 insertions(+), 1 deletion(-) create mode 100644 content/books/things-i-learnt/post-solution/index.md diff --git a/content/books/things-i-learnt/_index.md b/content/books/things-i-learnt/_index.md index 95d121b..1100eef 100644 --- a/content/books/things-i-learnt/_index.md +++ b/content/books/things-i-learnt/_index.md @@ -90,3 +90,4 @@ template = "section-contentless.html" * [Realize When It's Time To Quit](quit) * [I.T. World Is Really Small](small-world) * [Blogging About Your Stupid Solution Is Still Better Than Being Quiet](blogging) + * [Don't Hide Your Stupid Solution](post-solution) diff --git a/content/books/things-i-learnt/blogging/index.md b/content/books/things-i-learnt/blogging/index.md index 86ce961..4aa4516 100644 --- a/content/books/things-i-learnt/blogging/index.md +++ b/content/books/things-i-learnt/blogging/index.md @@ -30,4 +30,4 @@ towards you. There are several options on where to blog; even Github/Gitlab can be used to blogging, using their Pages features. -{{ chapters(prev_chapter_link="/books/things-i-learnt/small-world", prev_chapter_title="I.T. World Is Really Small") }} +{{ chapters(prev_chapter_link="/books/things-i-learnt/small-world", prev_chapter_title="I.T. World Is Really Small", next_chapter_link="/books/things-i-learnt/post-solution", next_chapter_title="Don't Hide Your Stupid Solution") }} diff --git a/content/books/things-i-learnt/post-solution/index.md b/content/books/things-i-learnt/post-solution/index.md new file mode 100644 index 0000000..9bed7b2 --- /dev/null +++ b/content/books/things-i-learnt/post-solution/index.md @@ -0,0 +1,35 @@ ++++ +title = "Things I Learnt The Hard Way - Blogging About Your Stupid Solution Is Still Better Than Being Quiet" +date = 2019-07-25 + +[taxonomies] +tags = ["en-au", "books", "things i learnt", "personal", "solutions"] ++++ + +You may think "This project is so small and so focused on whatever I needed, I +should never post it on Github. What would people think?" Github is not for +that. + + + +Github is not a repository for "cool, almost perfect" projects. You're free to +show that, at some point, you were a beginner[^1]. + +You can always come back, review what you did and fix it. It will, as your +[blog](/books/things-i-learnt/blogging), show that you're improving. + +... or maybe you'll let your project there just to rot. I still have some +Python projects that I wrote when I was learning the language that, although +they work, they don't look like Python projects. + +But who knows? Maybe the code you wrote to solve your small problem can help +someone else to fix their problem, which was not exactly the same, but pretty +close. Or even you could get a code review that would teach you something new +about the language/design you used. + +[^1]: Whoever see the first projects I did in + [Rust](https://www.rust-lang.org/) wouldn't think I have 30 years of + experience in the field. Everybody is a beginner at some point. + +{{ chapters(prev_chapter_link="/books/things-i-learnt/blogging", prev_chapter_title="Blogging About Your Stupid Solution Is Still Better Than Being Quiet") }} + From cce922313e485b7ca19138b198df936651012af0 Mon Sep 17 00:00:00 2001 From: Julio Biason Date: Thu, 25 Jul 2019 13:21:24 -0300 Subject: [PATCH 8/8] New chapter: Things I don't know --- content/books/things-i-learnt/_index.md | 1 + .../things-i-learnt/post-solution/index.md | 3 +-- .../things-i-dont-know/index.md | 22 +++++++++++++++++++ 3 files changed, 24 insertions(+), 2 deletions(-) create mode 100644 content/books/things-i-learnt/things-i-dont-know/index.md diff --git a/content/books/things-i-learnt/_index.md b/content/books/things-i-learnt/_index.md index 1100eef..4e83efc 100644 --- a/content/books/things-i-learnt/_index.md +++ b/content/books/things-i-learnt/_index.md @@ -91,3 +91,4 @@ template = "section-contentless.html" * [I.T. World Is Really Small](small-world) * [Blogging About Your Stupid Solution Is Still Better Than Being Quiet](blogging) * [Don't Hide Your Stupid Solution](post-solution) + * [Keep A List of Things I Don't Know](things-i-dont-know) diff --git a/content/books/things-i-learnt/post-solution/index.md b/content/books/things-i-learnt/post-solution/index.md index 9bed7b2..109d259 100644 --- a/content/books/things-i-learnt/post-solution/index.md +++ b/content/books/things-i-learnt/post-solution/index.md @@ -31,5 +31,4 @@ about the language/design you used. [Rust](https://www.rust-lang.org/) wouldn't think I have 30 years of experience in the field. Everybody is a beginner at some point. -{{ chapters(prev_chapter_link="/books/things-i-learnt/blogging", prev_chapter_title="Blogging About Your Stupid Solution Is Still Better Than Being Quiet") }} - +{{ chapters(prev_chapter_link="/books/things-i-learnt/blogging", prev_chapter_title="Blogging About Your Stupid Solution Is Still Better Than Being Quiet", next_chapter_link="/books/things-i-learnt/things-i-dont-know", next_chapter_title="Keep A List of Things I Don't Know") }} diff --git a/content/books/things-i-learnt/things-i-dont-know/index.md b/content/books/things-i-learnt/things-i-dont-know/index.md new file mode 100644 index 0000000..b0c6efa --- /dev/null +++ b/content/books/things-i-learnt/things-i-dont-know/index.md @@ -0,0 +1,22 @@ ++++ +title = "Things I Learnt The Hard Way - Keep A List of Things I Don't Know" +date = 2019-07-25 + +[taxonomies] +tags = ["en-au", "books", "things i learnt", "personal", "things i don't know", "richard feyman"] ++++ + +Richard Feymann, famous physicist, kept a notebook with the title "Things I +Don't Know". + + + +I keep a similar "Task List" for myself. If some technology starts appearing +everywhere or something grabs my attention, but I don't have the time to +research it, I put it on this task list. + +When I start my research, I keep some notes together, although [not on +paper](/books/things-i-learnt/paper-notes), so I can use as reference in the +future. + +{{ chapters(prev_chapter_link="/books/things-i-learnt/post-solution", prev_chapter_title="Don't Hide Your Stupid Solution") }}