The source content for blog.juliobiason.me
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

385 lines
17 KiB

<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<!-- Enable responsiveness on mobile devices-->
<!-- viewport-fit=cover is to support iPhone X rounded corners and notch in landscape-->
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1, viewport-fit=cover">
<title>Julio Biason .Me 4.3</title>
<!-- CSS -->
<link rel="stylesheet" href="https://blog.juliobiason.me/print.css" media="print">
<link rel="stylesheet" href="https://blog.juliobiason.me/poole.css">
<link rel="stylesheet" href="https://blog.juliobiason.me/hyde.css">
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=PT+Sans:400,400italic,700|Abril+Fatface">
</head>
<body class=" ">
<div class="sidebar">
<div class="container sidebar-sticky">
<div class="sidebar-about">
<a href="https:&#x2F;&#x2F;blog.juliobiason.me"><h1>Julio Biason .Me 4.3</h1></a>
<p class="lead">Old school dev living in a 2.0 dev world</p>
</div>
<ul class="sidebar-nav">
<li class="sidebar-nav-item"><a href="&#x2F;">English</a></li>
<li class="sidebar-nav-item"><a href="&#x2F;pt">Português</a></li>
<li class="sidebar-nav-item"><a href="&#x2F;tags">Tags (EN)</a></li>
<li class="sidebar-nav-item"><a href="&#x2F;pt&#x2F;tags">Tags (PT)</a></li>
</ul>
</div>
</div>
<div class="content container">
<div class="posts">
<div class="post">
<h1 class="post-title">
<a href="https:&#x2F;&#x2F;blog.juliobiason.me&#x2F;books&#x2F;things-i-learnt&#x2F;languages-are-more&#x2F;">
Things I Learnt The Hard Way - A Language Is Much More Than A Language
</a>
</h1>
<div class="post-meta">
<span class="post-date">
2019-06-24
<a href="https://blog.juliobiason.me/tags/books/">#books</a>
<a href="https://blog.juliobiason.me/tags/things-i-learnt/">#things i learnt</a>
<a href="https://blog.juliobiason.me/tags/languages/">#languages</a>
<a href="https://blog.juliobiason.me/tags/community/">#community</a>
<a href="https://blog.juliobiason.me/tags/ecosystem/">#ecosystem</a>
</span>
</div>
<div class="post-summary">
<p>Picking a programming language is much more than just picking the words that
will generate a code. They come with a community, a leadership, an ecosystem
and a thread the binds them all together.</p>
</div>
<a href="https://blog.juliobiason.me/books/things-i-learnt/languages-are-more/">
Read more...
</a>
</div>
<div class="post">
<h1 class="post-title">
<a href="https:&#x2F;&#x2F;blog.juliobiason.me&#x2F;books&#x2F;things-i-learnt&#x2F;boolean-parameters&#x2F;">
Things I Learnt The Hard Way - Don&#x27;t Use Booleans As Parameters
</a>
</h1>
<div class="post-meta">
<span class="post-date">
2019-06-23
<a href="https://blog.juliobiason.me/tags/books/">#books</a>
<a href="https://blog.juliobiason.me/tags/things-i-learnt/">#things i learnt</a>
<a href="https://blog.juliobiason.me/tags/booleans/">#booleans</a>
<a href="https://blog.juliobiason.me/tags/functions/">#functions</a>
<a href="https://blog.juliobiason.me/tags/parameters/">#parameters</a>
</span>
</div>
<div class="post-summary">
<p>When you're designing a function, you may be tempted to add a flag (a
parameter in a function that it is a boolean). Don't do this.</p>
</div>
<a href="https://blog.juliobiason.me/books/things-i-learnt/boolean-parameters/">
Read more...
</a>
</div>
<div class="post">
<h1 class="post-title">
<a href="https:&#x2F;&#x2F;blog.juliobiason.me&#x2F;books&#x2F;things-i-learnt&#x2F;document-and&#x2F;">
Things I Learnt The Hard Way - If A Function Description Includes An &quot;And&quot;, It&#x27;s Wrong
</a>
</h1>
<div class="post-meta">
<span class="post-date">
2019-06-23
<a href="https://blog.juliobiason.me/tags/books/">#books</a>
<a href="https://blog.juliobiason.me/tags/things-i-learnt/">#things i learnt</a>
<a href="https://blog.juliobiason.me/tags/documentation/">#documentation</a>
<a href="https://blog.juliobiason.me/tags/single-responsibility/">#single responsibility</a>
</span>
</div>
<div class="post-summary">
<p>Functions should do one thing and one thing only. I clear indication that
you're breaking this principle is the need to add an &quot;and&quot; in its
documentation.</p>
</div>
<a href="https://blog.juliobiason.me/books/things-i-learnt/document-and/">
Read more...
</a>
</div>
<div class="post">
<h1 class="post-title">
<a href="https:&#x2F;&#x2F;blog.juliobiason.me&#x2F;books&#x2F;things-i-learnt&#x2F;interface-changes&#x2F;">
Things I Learnt The Hard Way - Beware of Interface Changes
</a>
</h1>
<div class="post-meta">
<span class="post-date">
2019-06-23
<a href="https://blog.juliobiason.me/tags/books/">#books</a>
<a href="https://blog.juliobiason.me/tags/things-i-learnt/">#things i learnt</a>
<a href="https://blog.juliobiason.me/tags/interfaces/">#interfaces</a>
<a href="https://blog.juliobiason.me/tags/apis/">#apis</a>
</span>
</div>
<div class="post-summary">
<p>Interfaces and APIs is what you give away to others. If you keep changing them,
you'll make everyone's life sad.</p>
</div>
<a href="https://blog.juliobiason.me/books/things-i-learnt/interface-changes/">
Read more...
</a>
</div>
<div class="post">
<h1 class="post-title">
<a href="https:&#x2F;&#x2F;blog.juliobiason.me&#x2F;books&#x2F;things-i-learnt&#x2F;languages-docs&#x2F;">
Things I Learnt The Hard Way - Good Languages Come With Integrated Documentation
</a>
</h1>
<div class="post-meta">
<span class="post-date">
2019-06-23
<a href="https://blog.juliobiason.me/tags/books/">#books</a>
<a href="https://blog.juliobiason.me/tags/things-i-learnt/">#things i learnt</a>
<a href="https://blog.juliobiason.me/tags/languages/">#languages</a>
<a href="https://blog.juliobiason.me/tags/documentation/">#documentation</a>
</span>
</div>
<div class="post-summary">
<p>If you're worried about learning some new programming language, you can bet
the one with a better documentation is the one that is <em>born</em> with a document
processor.</p>
<p>Same goes for the frameworks/libraries of that language.</p>
</div>
<a href="https://blog.juliobiason.me/books/things-i-learnt/languages-docs/">
Read more...
</a>
</div>
<div class="post">
<h1 class="post-title">
<a href="https:&#x2F;&#x2F;blog.juliobiason.me&#x2F;books&#x2F;things-i-learnt&#x2F;document-is-contract&#x2F;">
Things I Learnt The Hard Way - The Function Documentation Is Its Contract
</a>
</h1>
<div class="post-meta">
<span class="post-date">
2019-06-21
<a href="https://blog.juliobiason.me/tags/books/">#books</a>
<a href="https://blog.juliobiason.me/tags/things-i-learnt/">#things i learnt</a>
<a href="https://blog.juliobiason.me/tags/documentation/">#documentation</a>
<a href="https://blog.juliobiason.me/tags/contracts/">#contracts</a>
</span>
</div>
<div class="post-summary">
<p>When you start the code by <a href="/books/things-i-learnt/steps-as-comments">writing the general flow as
steps</a> and making each step a
function, you're actually making a contract (probably with your future self):
I'm saying this function does <em>this</em> and <em>this</em> is what it does.</p>
</div>
<a href="https://blog.juliobiason.me/books/things-i-learnt/document-is-contract/">
Read more...
</a>
</div>
<div class="post">
<h1 class="post-title">
<a href="https:&#x2F;&#x2F;blog.juliobiason.me&#x2F;books&#x2F;things-i-learnt&#x2F;document-it&#x2F;">
Things I Learnt The Hard Way - Documentation Is a Love Letter To Your Future Self
</a>
</h1>
<div class="post-meta">
<span class="post-date">
2019-06-21
<a href="https://blog.juliobiason.me/tags/books/">#books</a>
<a href="https://blog.juliobiason.me/tags/things-i-learnt/">#things i learnt</a>
<a href="https://blog.juliobiason.me/tags/documentation/">#documentation</a>
</span>
</div>
<div class="post-summary">
<p>We all know writing the damn docs for functions and classes and modules is a
pain in the backside. But realizing what you were thinking when you wrote the
function will save your butt in the future.</p>
</div>
<a href="https://blog.juliobiason.me/books/things-i-learnt/document-it/">
Read more...
</a>
</div>
<div class="post">
<h1 class="post-title">
<a href="https:&#x2F;&#x2F;blog.juliobiason.me&#x2F;books&#x2F;things-i-learnt&#x2F;future-trashing&#x2F;">
Things I Learnt The Hard Way - Future Thinking is Future Trashing
</a>
</h1>
<div class="post-meta">
<span class="post-date">
2019-06-21
<a href="https://blog.juliobiason.me/tags/books/">#books</a>
<a href="https://blog.juliobiason.me/tags/things-i-learnt/">#things i learnt</a>
<a href="https://blog.juliobiason.me/tags/design/">#design</a>
<a href="https://blog.juliobiason.me/tags/solution/">#solution</a>
</span>
</div>
<div class="post-summary">
<p>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.</p>
</div>
<a href="https://blog.juliobiason.me/books/things-i-learnt/future-trashing/">
Read more...
</a>
</div>
<div class="post">
<h1 class="post-title">
<a href="https:&#x2F;&#x2F;blog.juliobiason.me&#x2F;books&#x2F;things-i-learnt&#x2F;tests-dead-code&#x2F;">
Things I Learnt The Hard Way - Testing Every Function Creates Dead Code
</a>
</h1>
<div class="post-meta">
<span class="post-date">
2019-06-21
<a href="https://blog.juliobiason.me/tags/books/">#books</a>
<a href="https://blog.juliobiason.me/tags/things-i-learnt/">#things i learnt</a>
<a href="https://blog.juliobiason.me/tags/unit-tests/">#unit tests</a>
<a href="https://blog.juliobiason.me/tags/dead-code/">#dead code</a>
</span>
</div>
<div class="post-summary">
<p>If you write a test for every single function on your system, and your system
keeps changing, how will you know when a function is not necessary anymore?</p>
</div>
<a href="https://blog.juliobiason.me/books/things-i-learnt/tests-dead-code/">
Read more...
</a>
</div>
<div class="post">
<h1 class="post-title">
<a href="https:&#x2F;&#x2F;blog.juliobiason.me&#x2F;books&#x2F;things-i-learnt&#x2F;languages-tests&#x2F;">
Things I Learnt The Hard Way - Good Languages Come With Tests
</a>
</h1>
<div class="post-meta">
<span class="post-date">
2019-06-20
<a href="https://blog.juliobiason.me/tags/books/">#books</a>
<a href="https://blog.juliobiason.me/tags/things-i-learnt/">#things i learnt</a>
<a href="https://blog.juliobiason.me/tags/programming-languages/">#programming languages</a>
<a href="https://blog.juliobiason.me/tags/tests/">#tests</a>
</span>
</div>
<div class="post-summary">
<p>You can be sure that if a language brings a testing framework -- even minimal
-- in its standard library, the ecosystem around it will have better tests
than a language that doesn't carry a testing framework, no matter how good the
external testing frameworks for the language are.</p>
</div>
<a href="https://blog.juliobiason.me/books/things-i-learnt/languages-tests/">
Read more...
</a>
</div>
</div>
</div>
</body>
</html>