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.
386 lines
17 KiB
386 lines
17 KiB
11 months ago
|
<!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://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="/">English</a></li>
|
||
|
|
|
||
|
|
<li class="sidebar-nav-item"><a href="/pt">Português</a></li>
|
||
|
|
|
||
|
|
<li class="sidebar-nav-item"><a href="/tags">Tags (EN)</a></li>
|
||
|
|
|
||
|
|
<li class="sidebar-nav-item"><a href="/pt/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://blog.juliobiason.me/books/things-i-learnt/languages-are-more/">
|
||
|
|
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://blog.juliobiason.me/books/things-i-learnt/boolean-parameters/">
|
||
|
|
Things I Learnt The Hard Way - Don'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://blog.juliobiason.me/books/things-i-learnt/document-and/">
|
||
|
|
Things I Learnt The Hard Way - If A Function Description Includes An "And", It'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 "and" 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://blog.juliobiason.me/books/things-i-learnt/interface-changes/">
|
||
|
|
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://blog.juliobiason.me/books/things-i-learnt/languages-docs/">
|
||
|
|
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://blog.juliobiason.me/books/things-i-learnt/document-is-contract/">
|
||
|
|
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://blog.juliobiason.me/books/things-i-learnt/document-it/">
|
||
|
|
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://blog.juliobiason.me/books/things-i-learnt/future-trashing/">
|
||
|
|
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://blog.juliobiason.me/books/things-i-learnt/tests-dead-code/">
|
||
|
|
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://blog.juliobiason.me/books/things-i-learnt/languages-tests/">
|
||
|
|
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>
|