jbiason
/
blog
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Browse Source

Merge tag '20190611.3' into preview 

20190611.3
master
Julio Biason 6 years ago
parent
8f67632f6c e1e6b93095
commit
c0cf49b2f7
1 changed files with 11 additions and 11 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 22
      content/thoughts/things-i-learnt-the-hard-way.md

22
content/thoughts/things-i-learnt-the-hard-way.md
Unescape View File

@ -7,7 +7,7 @@ tags = ["en-au", "programming", "work"]
+++ +++
This is a cynical, clinical collection of things I learnt in 30 years working This is a cynical, clinical collection of things I learnt in 30 years working
with sofware development. with software development.
Again, some things are really cynical, others are long observations on Again, some things are really cynical, others are long observations on
different jobs. different jobs.
@ -80,7 +80,7 @@ When developers try to solve a problem, they sometimes try to find a way that
will solve all the problems, including the ones that may appear in the future. will solve all the problems, including the ones that may appear in the future.
But here is the thing: The problems from the future will never come and you'll But here is the thing: The problems from the future will never come and you'll
end up either having to maintain a huge behemot of code that will never be end up either having to maintain a huge behemoth of code that will never be
fully used or you'll end up rewriting the whole thing 'cause there is a shitton fully used or you'll end up rewriting the whole thing 'cause there is a shitton
of unused stuff. of unused stuff.
@ -112,7 +112,7 @@ is doing more than one thing. Break that function into two and remove the
### Good languages come with integration documentation ### Good languages come with integration documentation
If the langauge comes with its own way of documentating If the language comes with its own way of documenting
functions/classes/modules/whatever and it comes even with the simplest doc functions/classes/modules/whatever and it comes even with the simplest doc
generator, you can be sure that all the language generator, you can be sure that all the language
functions/classes/modules/libraries/frameworks will have a good documentation functions/classes/modules/libraries/frameworks will have a good documentation
@ -157,7 +157,7 @@ exception/error/result and you know how to handle it, handle it. Show an error
message, try to save the data somewhere else, capture the user input in a log message, try to save the data somewhere else, capture the user input in a log
file to later processing, but _handle_ it. file to later processing, but _handle_ it.
### Types say what you data means ### Types say what you data is
Memory is just a sequence of bytes; bytes are just numbers from 0 to 255; what Memory is just a sequence of bytes; bytes are just numbers from 0 to 255; what
those numbers mean is described on the language type system. those numbers mean is described on the language type system.
@ -403,12 +403,12 @@ code style problems.
### Code formatting tools are ok, but they are no silver bullet ### Code formatting tools are ok, but they are no silver bullet
One thing a team may be tempted to do to avoid discussing style in code reviews One thing a team may be tempted to do to avoid discussing style in code reviews
is to use a code formatting tool to auto-format code before commiting. is to use a code formatting tool to auto-format code before committing.
Now yeah, that kinda solves the problem, but there is one small problem: Now yeah, that kinda solves the problem, but there is one small problem:
we, humans, are not as flexibile to read code as computers are; what is we, humans, are not as flexible to read code as computers are; what is
readable by a computer may not be readable by a human. Surely they try to readable by a computer may not be readable by a human. Surely they try to
create some heristics on what is good for human reading, but that doesn't mean create some heuristics on what is good for human reading, but that doesn't mean
it gets right. it gets right.
If you _do_ use a code formatting tool, use it to find out where it changes the If you _do_ use a code formatting tool, use it to find out where it changes the
@ -537,7 +537,7 @@ be used on.
### You'll learn about yourself the hard way ### You'll learn about yourself the hard way
We get frustrated with code that doesn't compile. We get angry with costumers We get frustrated with code that doesn't compile. We get angry with customers
asking things back and forth. asking things back and forth.
And we lash out on other when that happens. And we lash out on other when that happens.
@ -610,7 +610,7 @@ to them that it feels natural and, most of the time, you're the wrong one (for
not seeing that they are joking, for example, in true "Schrödinger's asshole" not seeing that they are joking, for example, in true "Schrödinger's asshole"
style.) style.)
### Toxic/migro-aggressors are only fixable if they are _YOU_ ### Toxic/micro-aggressors are only fixable if they are _YOU_
Unless it's you realizing you're acting like a toxic person or micro-attacking Unless it's you realizing you're acting like a toxic person or micro-attacking
someone, and realize that you're actually doing more harm than good being that someone, and realize that you're actually doing more harm than good being that
@ -648,9 +648,9 @@ I tried to become "paperless" many times. At some point, I did keep the papers
away, but in the very end, it really do help to have a small notebook and a away, but in the very end, it really do help to have a small notebook and a
pen right next to you write that damn URL you need to send the data. pen right next to you write that damn URL you need to send the data.
### Trello is cool and all, but Postits are nicer ### Trello is cool and all, but Post-its are nicer
Nothing says "I'm really busy, but organized" like having a bunch of post its Nothing says "I'm really busy, but organized" like having a bunch of post-its
on your desk. on your desk.
### Blogging about your stupid solution is still better than being quiet ### Blogging about your stupid solution is still better than being quiet

Write Preview
Loading…
Cancel
Save