falsehood/README.md

# Awesome Falsehood [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome) [![Build Status](https://travis-ci.org/kdeldycke/awesome-falsehood.svg?branch=master)](https://travis-ci.org/kdeldycke/awesome-falsehood)

A curated list of awesome falsehoods programmers believe in.

> The logic of the world is prior to all truth and falsehood.
> - Ludwig Wittgenstein


## Contents

- [Foreword](#foreword)
---
- [Meta](#meta)
- [Arts](#arts)
- [Business](#business)
- [Dates and Time](#dates-and-time)
- [Emails](#emails)
- [Geography](#geography)
- [Human Identity](#human-identity)
- [Internationalization](#internationalization)
- [Multimedia](#multimedia)
- [Networks](#networks)
- [Phone Numbers](#phone-numbers)
- [Postal Addresses](#postal-addresses)
- [Science](#science)
- [Society](#society)
- [Software Engineering](#software-engineering)
- [Typography](#typography)
---
- [Contributing](#contributing)
- [Good Candidates](#good-candidates)
    - [*Falsehood* Articles](#falsehood-articles)
    - [Libraries](#libraries)
    - [Data Structures](#data-structures)
- [License](#license)


## Foreword

*Falsehood* articles are a form of commentary on a particular subject, and are
appreciated by the developer community at large for their effectiveness and
terseness. They're a convenient written form to approach an unfamiliar domain
by dispelling myths, point out common pitfalls, show inconsistencies and
subtleties.

In a sense, *Falsehood* articles are a suite of wordy unit-tests covering
extensive edge-cases provided by real-world usage.


## Meta

- [Falsehoods Programmers
Believe](https://spaceninja.com/2015/12/07/falsehoods-programmers-believe/) - A
brief list of common falsehoods. A great overview and quick introduction into
the world of falsehoods.
- [Falsehoods About
Programming](https://chiselapp.com/user/ttmrichter/repository/gng/doc/trunk/output/falsehoods.html) -
A humbling and fun list on programming and programmers themselves.
- [Falsehoods About Falsehoods
Lists](https://kevin.deldycke.com/2016/12/falsehoods-programmers-believe-about-falsehoods-lists/) -
Meta commentary on how these falsehoods shouldn't be handled.


## Arts

- [Falsehoods About
Music](https://literateprogrammer.blogspot.fr/2016/07/falsehoods-programmers-believe-about.html) -
False assumption that might be made in codifying music.


## Business

- [Falsehoods About Online
Shopping](http://wiesmann.codiferes.net/wordpress/?p=22201) - Covers prices,
currencies and inventory.
- [Falsehoods About
Prices](https://gist.github.com/rgs/6509585) - Covers currencies, amounts and
localization.
- [Falsehoods About
IBANs](https://github.com/globalcitizen/php-iban/blob/master/docs/FALSEHOODS.md) -
International Bank Account Numbers are not immune to mistakes.
- [Falsehoods About Job
Applicants](https://web.archive.org/web/20170114022820/https://medium.com/@creatrixtiara/falsehoods-programmers-believe-about-job-applicants-99280437c616) -
Assumptions about job applicants and their job histories aren’t necessarily
true.
- [Falsehoods About
Economics](http://exple.tive.org/blarg/2016/09/22/falsehoods-programmers-believe-about-economics/) -
Economics are not simple or rational.
- [CLDR currency
definitions](http://unicode.org/cldr/trac/browser/tags/release-31/common/supplemental/supplementalData.xml#L81) -
Currency validity date ranges overlap due to revolts, invasions, new
constitutions, and slow planned adoption.
- [`tax`](https://github.com/commerceguys/tax) - A PHP 5.4+ tax management
library.


## Dates and Time

- [Falsehoods About
Time](http://infiniteundo.com/post/25326999628/falsehoods-programmers-believe-about-time) -
Seminal article on dates and time.
- [More Falsehoods About
Time](http://infiniteundo.com/post/25509354022/more-falsehoods-programmers-believe-about-time) -
Part. 2 of the article above.
- [Falsehoods About Time and Time
Zones](https://www.creativedeletion.com/2015/01/28/falsehoods-programmers-date-time-zones.html) -
Another takes on time-related falsehoods, with an emphasis on time zones.
- [Critique of Falsehoods About
Time](https://gist.github.com/thanatos/eee17100476a336a711e) - Takes on the
first article above and provides an explanation of each falsehood, with more
context and external resources.
- [Your Calendrical Fallacy Is Thinking…](http://yourcalendricalfallacyis.com) -
List covering intercalation and cultural influence, made by a community of iOS
and macOS developers.
- [Time Zone Database](https://www.iana.org/time-zones) - Code and data that
represent the history of local time for many representative locations around
the globe.
- [The Long, Painful History of Time](http://naggum.no/lugm-time.html) - Most
of the idiosyncrasies in time keeping can find an explanation in history.
- [You Advocate a Calendar Reform](https://qntm.org/calendar) - Your idea will
not work. This article tells you why.
- [So You Want to Abolish Time Zones](https://qntm.org/abolish) – Abolishing
timezones may sound like a good idea, but there are quite a few complications
that make it not quite so.
- [The Problem with Time & Timezones](https://www.youtube.com/watch?v=-5wpm-gesOY) -
A video about why you should never, ever deal with timezones if you can help
it.
- [$26,000 Overcollection by Labor
Department](http://digital.vpr.net/post/rounding-error-computer-code-leads-26000-overcollection-labor-department) -
The consequence of wrong calendar accounting.


## Emails

- [I Knew How to Validate an Email Address Until I Read the
RFC](https://haacked.com/archive/2007/08/21/i-knew-how-to-validate-an-email-address-until-i.aspx/) -
Provides intricate examples that are unsuspected valid email addresses
according the RFC-822.


## Geography

- [Falsehoods About
Geography](http://wiesmann.codiferes.net/wordpress/?p=15187) - Takes on places,
their names and locations.
- [Falsehoods About
Maps](http://www.atlefren.net/post/2014/09/falsehoods-programmers-believe-about-maps/) -
Covers coordinates, projection and GIS.


## Human Identity

- [Falsehoods About
Names](https://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/) -
The article that started it all.
- [Falsehoods About
Gender](https://gist.github.com/garbados/f82604ea639e0e47bf44) - Gender is part
of human identity and has its own subtleties.
- [Gay Marriage: The Database Engineering Perspective](https://qntm.org/gay) -
How to store a marriage in a database while addressing most of the falsehoods
about gender, naming and relationships.
- [Falsehoods Programmers Believe About
Families](https://shkspr.mobi/blog/2017/03/falsehoods-programmers-believe-about-families/) -
You can't really define a family with strict rules.
- [Personal Names Around the
World](https://www.w3.org/International/questions/qa-personal-names) - How do
people's names differ around the world, and what are the implications for the
Web?
- [XKCD #327: Exploits of a
Mom](https://xkcd.com/327/) - Funny take on how implementation of a falsehood
might lead to security holes.
- [Hello, I’m Mr. Null. My Name Makes Me Invisible to
Computers](https://www.wired.com/2015/11/null/) - Real-life example on how
implemented falsehood has negative impact on someone's life.
- [HL7 v3
RIM](https://www.hl7.org/implement/standards/product_brief.cfm?product_id=186) -
A flexible data model for representing human names.
- [Apple iOS
`NSPersonNameComponentsFormatter`](https://developer.apple.com/library/ios/documentation/Miscellaneous/Reference/NSPersonNameComponentsFormatter_Class/index.html) -
Localized representations of the components of a person’s name.
- [Falsehoods About Me](https://skylarmacdonald.com/falsehoods/) - Issues at the 
intersection of names and gender and internationalisation.


## Internationalization

- [Falsehoods About
Language](http://garbled.benhamill.com/2017/04/18/falsehoods-programmers-believe-about-language/) -
Translating a software from English is not as straightforward as it seems to
be.
- [i18n Testing Data](https://github.com/patch/i18n-testing) - Real-word
international and diverse name data for unit testing and QA.
- [Internationalis(z)ing Code](https://www.youtube.com/watch?v=0j74jcxSunY) -
A video about things you need to keep in mind when internationalizing your
code.


## Multimedia

- [Falsehoods About
Video](https://haasn.xyz/posts/2016-12-25-falsehoods-programmers-believe-about-%5Bvideo-stuff%5D.html) -
Cover it all: video decoding and playback, files, image scaling, color spaces
and conversion, displays and subtitles.


## Networks

- [Falsehoods About
Networks](http://blog.erratasec.com/2012/06/falsehoods-programmers-believe-about.html) -
Covers TCP, DHCP, DNS, VLANs and IPv4/v6.
- [Fallacies of Distributed
Computing](https://en.wikipedia.org/wiki/Fallacies_of_distributed_computing) -
Assumptions that programmers new to distributed applications invariably make.


## Phone Numbers

- [Falsehoods About Phone
Numbers](https://github.com/googlei18n/libphonenumber/blob/master/FALSEHOODS.md) -
Covers phone numbers, their representation and meaning.
- [`libphonenumber`](https://github.com/googlei18n/libphonenumber) - Google's
common Java, C++ and JavaScript library for parsing, formatting, and validating
international phone numbers. Also available for
[C#](https://github.com/erezak/libphonenumber-csharp),
[Objective-C](https://github.com/iziz/libPhoneNumber-iOS),
[Python](https://github.com/daviddrysdale/python-phonenumbers),
[Ruby](https://github.com/sstephenson/global_phone) and
[PHP](https://github.com/giggsey/libphonenumber-for-php).


## Postal Addresses

- [Falsehoods About
Addresses](https://www.mjt.me.uk/posts/falsehoods-programmers-believe-about-addresses/) -
Covers streets, postal codes, buildings, cities and countries.
- [Letter Delivered Despite No Name, No
Address](https://twitter.com/loriskumo/status/735851511331356672) - Ultimate
falsehood about postal addresses: you do not need one.
- [Regex and Postal
Addresses](https://smartystreets.com/articles/regular-expressions-for-street-addresses) -
Why regular expressions and street addresses do not mix.
- [`libaddressinput`](https://github.com/googlei18n/libaddressinput) - Google's
common C++ and Java library for parsing, formatting, and validating
international postal addresses.
- [`addressing`](https://github.com/commerceguys/addressing) - A PHP 5.4+
addressing library, powered by Google's dataset.
- [`postal-address`](https://github.com/scaleway/postal-address) - Python
module to parse, normalize and render postal addresses.


## Science

- [Falsehoods About Systems of
Measurement](https://web.archive.org/web/20150222171255/https://stevemoser.org/blog/2013/08/07/falsehoods-programmers-believe-about-systems-of-measurement/) -
On working with systems of measurement and converting between them.


## Society

- [Falsehoods About Political
Appointments](https://twitter.com/oliver_dw/status/737930439575404544) -
Designing election systems has its own tricks.
- [Falsehoods About Women In
Tech](https://gist.github.com/Su-Shee/5d1a417fa9de19c15477) - Myth about women
in STEM (Science, Technology, Engineering, Math) industries.


## Software Engineering

- [Falsehoods About
Versions](https://github.com/xenoterracide/falsehoods/blob/master/versions.md) -
Attributing an identity to a software release might be harder than thought.
- [Falsehoods About Build
Systems](https://pozorvlak.livejournal.com/174763.html) - Building software is
hard. Building software that builds software is harder.
- [Myths About File
Paths](https://yakking.branchable.com/posts/falsehoods-programmers-believe-about-file-paths/) -
Diversity of file-systems and OSes makes file paths a little harder than we
might think of.
- [Falsehoods About REST
APIs](http://slinkp.com/falsehoods-programmers-believe-about-apis.html) -
Pitfalls to be mindful of when creating and documenting APIs.
- [Falsehoods About
CSVs](https://donatstudios.com/Falsehoods-Programmers-Believe-About-CSVs) -
While RFC4180 to exists, it is far from definitive and goes largely ignored.
- [Falsehoods About Package
Managers](https://meta-package-manager.readthedocs.io/en/develop/falsehoods.html) -
Covers package and their managers.
- [Big List of Naughty
Strings](https://github.com/minimaxir/big-list-of-naughty-strings) - Challenge
your assumptions about strings.


## Typography

- [Falsehoods About Fonts](https://github.com/RoelN/Font-Falsehoods) -
Assumptions about typography on the web and in desktop applications.


## Contributing

Your contributions are always welcome! Please take a look at the [contribution
guidelines](CONTRIBUTING.md) first.


## Good Candidates

Here is a non-restrictive list of items which are good candidates for inclusion
in this awesome list.

### *Falsehood* Articles

Articles following the *falsehood* scheme are prime candidates for inclusion in
this awesome list.

These articles starts with the hypothesis that developers have a naive, simple
view of the subject at hand. Then proceed to list a set of candid assumptions
that might be held by such programmers. Each one is intentionally false, and
sometimes illustrated by a counter-example.

A list of falsehood is crafted as a progression that is designed to refine
concepts. Having read the whole list of falsehood, the reader should possess a
global, if not complete, overview of the domain being targeted by the article,
including most, if not all, its pitfalls, edges-cases and inconsistencies.

In the worst case, these articles might provoke an emotional reaction and cause
flipping table. `(╯°□°)╯︵ ┻━┻`

### Libraries

When possible, we provide a list of programming libraries or modules that may
solve, or try to, the complexities and idiosyncrasies pointed by the
*falsehood* articles above.

So we can put back tables in place. `┬─┬ ノ( ゜-゜ノ)`

### Data Structures

Data models and structures generic enough to cover and address most of the
falsehoods are also welcome in this page.


## License

[![CC0](https://mirrors.creativecommons.org/presskit/buttons/88x31/svg/cc-zero.svg)](https://creativecommons.org/publicdomain/zero/1.0/)

Content of this repository is licensed under the [Creative Commons CC0
license](https://creativecommons.org/publicdomain/zero/1.0/).

To the extent possible under law, [Kevin Deldycke](https://kevin.deldycke.com)
has waived all copyright and related or neighboring rights to this work.