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
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://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>
|
|
|