falsehood/README.md

# Awesome Falsehood [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome)

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)
- [Good candidates](#good-candidates)
    - [*Falsehood* articles](#falsehood-articles)
    - [Libraries](#libraries)
    - [Data structures](#data-structures)
- [Meta](#meta)
- [Build systems](#build-systems)
- [Dates and time](#dates-and-time)
- [E-commerce](#e-commerce)
- [Emails](#emails)
- [Gender](#gender)
- [Geography](#geography)
- [Human names](#human-names)
- [Networks](#networks)
- [Phone numbers](#phone-numbers)
- [Prices](#prices)
- [Postal addresses](#postal-addresses)
- [Versions](#versions)
- [Contributing](#contributing)
- [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
density. They're a convenient written form to approach an unfamiliar domain by
dispelling myths, point out common pitfalls, show inconsistencies and
subtleties.

They might looks like to some as a suite of wordy unit-tests covering extensive
edge-cases provided by real-world usage.


## 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.

### 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.

### Data structures

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


## Meta

- [Awesome Falsehood](https://github.com/kdeldycke/awesome-falsehood) - A
curated list of awesome falsehoods programmers believe in.
- [Falsehoods Programmers Believe](http://spaceninja.com/2015/12/08/falsehoods-programmers-believe/) - A brief list of common falsehoods. A great overview and quick introduction into the world of falsehoods.


## Build systems

- [Falsehoods programmers believe about build systems](http://pozorvlak.livejournal.com/174763.html)


## Dates and time

- [Falsehoods programmers believe about time](http://infiniteundo.com/post/25326999628/falsehoods-programmers-believe-about-time) - Seminal article on dates and time.
- [More falsehoods programmers believe about time](http://infiniteundo.com/post/25509354022/more-falsehoods-programmers-believe-about-time) - Part. 2 of the article above.
- [Falsehoods programmers believe about time and time zones](http://www.creativedeletion.com/2015/01/28/falsehoods-programmers-date-time-zones.html) - Another takes on time-related falsehoods, with an emphasis on time zones.
- [Falsehoods Programmers Believe About Time](https://gist.github.com/thanatos/eee17100476a336a711e) - A critique of the first article with a very detailed explanation of each falsehood, adding more context and external resource to the subject.


## E-commerce

- [Falsehoods programmers believe about online shopping](http://wiesmann.codiferes.net/wordpress/?p=22201)


## Emails

- [I Knew How To Validate An Email Address Until I Read The RFC](http://haacked.com/archive/2007/08/21/i-knew-how-to-validate-an-email-address-until-i.aspx/).


## Gender

- [Falsehoods Programmers Believe About Gender](https://gist.github.com/garbados/f82604ea639e0e47bf44)


## Geography

- [Falsehoods programmers believe about geography](http://wiesmann.codiferes.net/wordpress/?p=15187).


## Human names

- [Falsehoods Programmers Believe About Names](https://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/).
- [XKCD #327: Exploits of a Mom](https://xkcd.com/327/).
- [HL7 V3 RIM](http://www.hl7.org/implement/standards/product_brief.cfm?product_id=186): a flexible data model for representing human names.
- [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.


## Networks

- [Falsehoods programmers believe about networks](http://blog.erratasec.com/2012/06/falsehoods-programmers-believe-about.html)


## Phone numbers

- [`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).


## Prices

- [Falsehoods programmers believe about prices](https://gist.github.com/rgs/6509585).


## Postal addresses

- [Falsehoods programmers believe about addresses](https://www.mjt.me.uk/posts/falsehoods-programmers-believe-about-addresses/).
- [`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.


## Versions

- [Falsehoods programmers believe about versions](https://github.com/xenoterracide/falsehoods/blob/master/versions.md)


## Contributing

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


## License

Content of this repository is licensed under the [BSD 2-Clause
License](LICENSE.md).
-												Add seminal falsehoods.
											
										
										
											2016-09-08 11:22:55 +02:00
+								# Awesome Falsehood [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome)
-												Grammar.

											
										
										
											2016-09-08 12:18:23 +02:00
+								A curated list of awesome falsehoods programmers believe in.
-												Add seminal falsehoods.
											
										
										
											2016-09-08 11:22:55 +02:00
-												Our pursuit is vain.

											
										
										
											2016-09-09 02:04:13 +02:00
+								> The logic of the world is prior to all truth and falsehood.
 								> - Ludwig Wittgenstein
-												Add seminal falsehoods.
											
										
										
											2016-09-08 11:22:55 +02:00
-												Put Toc at the top.

											
										
										
											2016-09-09 01:44:50 +02:00
+								## Contents
-												Fix link.

											
										
										
											2016-09-09 01:51:21 +02:00
+								- [Foreword](#foreword)
-												Put Toc at the top.

											
										
										
											2016-09-09 01:44:50 +02:00
+								- [Good candidates](#good-candidates)
 								    - [*Falsehood* articles](#falsehood-articles)
 								    - [Libraries](#libraries)
 								    - [Data structures](#data-structures)
 								- [Meta](#meta)
 								- [Build systems](#build-systems)
 								- [Dates and time](#dates-and-time)
 								- [E-commerce](#e-commerce)
 								- [Emails](#emails)
 								- [Gender](#gender)
 								- [Geography](#geography)
 								- [Human names](#human-names)
 								- [Networks](#networks)
 								- [Phone numbers](#phone-numbers)
 								- [Prices](#prices)
 								- [Postal addresses](#postal-addresses)
 								- [Versions](#versions)
 								- [Contributing](#contributing)
 								- [License](#license)
-												Replace bad draft by a proper introduction to the list.

											
										
										
											2016-09-09 01:11:28 +02:00
+								## Foreword
-												We need to tell why this list is great.

											
										
										
											2016-09-08 12:15:51 +02:00
-												Replace bad draft by a proper introduction to the list.

											
										
										
											2016-09-09 01:11:28 +02:00
+								*Falsehood* articles are a form of commentary on a particular subject, and are
-												Typos.

											
										
										
											2016-09-09 01:16:46 +02:00
+								appreciated by the developer community at large for their effectiveness and
-												Replace bad draft by a proper introduction to the list.

											
										
										
											2016-09-09 01:11:28 +02:00
+								density. They're a convenient written form to approach an unfamiliar domain by
 								dispelling myths, point out common pitfalls, show inconsistencies and
-												Typos.

											
										
										
											2016-09-09 01:16:46 +02:00
+								subtleties.
-												We need to tell why this list is great.

											
										
										
											2016-09-08 12:15:51 +02:00
-												Replace bad draft by a proper introduction to the list.

											
										
										
											2016-09-09 01:11:28 +02:00
+								They might looks like to some as a suite of wordy unit-tests covering extensive
 								edge-cases provided by real-world usage.
-												Update section title.

											
										
										
											2016-09-09 00:18:43 +02:00
-												Put Toc at the top.

											
										
										
											2016-09-09 01:44:50 +02:00
+								## Good candidates
 								Here is a non-restrictive list of items which are good candidates for inclusion
 								in this awesome list.
-												Update section title.

											
										
										
											2016-09-09 00:18:43 +02:00
-												Put Toc at the top.

											
										
										
											2016-09-09 01:44:50 +02:00
+								### *Falsehood* articles
-												Update section title.

											
										
										
											2016-09-09 00:18:43 +02:00
-												Replace bad draft by a proper introduction to the list.

											
										
										
											2016-09-09 01:11:28 +02:00
+								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
-												Typos.

											
										
										
											2016-09-09 01:16:46 +02:00
+								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
-												Replace bad draft by a proper introduction to the list.

											
										
										
											2016-09-09 01:11:28 +02:00
+								sometimes illustrated by a counter-example.
 								A list of falsehood is crafted as a progression that is designed to refine
-												Typos.

											
										
										
											2016-09-09 01:16:46 +02:00
+								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,
-												Replace bad draft by a proper introduction to the list.

											
										
										
											2016-09-09 01:11:28 +02:00
+								including most, if not all, its pitfalls, edges-cases and inconsistencies.
-												Put Toc at the top.

											
										
										
											2016-09-09 01:44:50 +02:00
+								### Libraries
-												Replace bad draft by a proper introduction to the list.

											
										
										
											2016-09-09 01:11:28 +02:00
 								When possible, we provide a list of programming libraries or modules that may
-												Typos.

											
										
										
											2016-09-09 01:16:46 +02:00
+								solve, or try to, the complexities and idiosyncrasies pointed by the
-												Replace bad draft by a proper introduction to the list.

											
										
										
											2016-09-09 01:11:28 +02:00
+								*falsehood* articles above.
 								### Data structures
 								Data models and structures generic enough to cover and addresses most of the
 								falsehoods are also welcome in this page.
-												Update section title.

											
										
										
											2016-09-09 00:18:43 +02:00
-												We need to tell why this list is great.

											
										
										
											2016-09-08 12:15:51 +02:00
-												Add meta section.

											
										
										
											2016-09-09 00:19:40 +02:00
+								## Meta
-												Really get meta.

											
										
										
											2016-09-09 01:51:36 +02:00
+								- [Awesome Falsehood](https://github.com/kdeldycke/awesome-falsehood) - A
 								curated list of awesome falsehoods programmers believe in.
-												Add meta section.

											
										
										
											2016-09-09 00:19:40 +02:00
+								- [Falsehoods Programmers Believe](http://spaceninja.com/2015/12/08/falsehoods-programmers-believe/) - A brief list of common falsehoods. A great overview and quick introduction into the world of falsehoods.
-												Add build systems section.

											
										
										
											2016-09-09 00:19:21 +02:00
+								## Build systems
 								- [Falsehoods programmers believe about build systems](http://pozorvlak.livejournal.com/174763.html)
-												Update section title.

											
										
										
											2016-09-09 00:18:43 +02:00
+								## Dates and time
-												Add seminal falsehoods.
											
										
										
											2016-09-08 11:22:55 +02:00
-												Add more articles regarding dates and time falsehoods.

											
										
										
											2016-09-09 01:12:06 +02:00
+								- [Falsehoods programmers believe about time](http://infiniteundo.com/post/25326999628/falsehoods-programmers-believe-about-time) - Seminal article on dates and time.
 								- [More falsehoods programmers believe about time](http://infiniteundo.com/post/25509354022/more-falsehoods-programmers-believe-about-time) - Part. 2 of the article above.
-												Typos.

											
										
										
											2016-09-09 01:16:46 +02:00
+								- [Falsehoods programmers believe about time and time zones](http://www.creativedeletion.com/2015/01/28/falsehoods-programmers-date-time-zones.html) - Another takes on time-related falsehoods, with an emphasis on time zones.
-												Add more articles regarding dates and time falsehoods.

											
										
										
											2016-09-09 01:12:06 +02:00
+								- [Falsehoods Programmers Believe About Time](https://gist.github.com/thanatos/eee17100476a336a711e) - A critique of the first article with a very detailed explanation of each falsehood, adding more context and external resource to the subject.
-												Add seminal falsehoods.
											
										
										
											2016-09-08 11:22:55 +02:00
-												Add e-commerce section.

											
										
										
											2016-09-09 01:13:57 +02:00
+								## E-commerce
 								- [Falsehoods programmers believe about online shopping](http://wiesmann.codiferes.net/wordpress/?p=22201)
-												Add Falsehood about Emails.

											
										
										
											2016-09-08 11:58:21 +02:00
+								## Emails
-												End all lines by points.

											
										
										
											2016-09-08 12:27:13 +02:00
+								- [I Knew How To Validate An Email Address Until I Read The RFC](http://haacked.com/archive/2007/08/21/i-knew-how-to-validate-an-email-address-until-i.aspx/).
-												Add Falsehood about Emails.

											
										
										
											2016-09-08 11:58:21 +02:00
-												Add gender sections.

											
										
										
											2016-09-09 00:17:17 +02:00
+								## Gender
 								- [Falsehoods Programmers Believe About Gender](https://gist.github.com/garbados/f82604ea639e0e47bf44)
-												Add Geography section.

											
										
										
											2016-09-08 12:13:07 +02:00
+								## Geography
-												Use canonical URL.

											
										
										
											2016-09-09 00:17:32 +02:00
+								- [Falsehoods programmers believe about geography](http://wiesmann.codiferes.net/wordpress/?p=15187).
-												Add Geography section.

											
										
										
											2016-09-08 12:13:07 +02:00
-												Add seminal falsehoods.
											
										
										
											2016-09-08 11:22:55 +02:00
+								## Human names
-												End all lines by points.

											
										
										
											2016-09-08 12:27:13 +02:00
+								- [Falsehoods Programmers Believe About Names](https://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/).
 								- [XKCD #327: Exploits of a Mom](https://xkcd.com/327/).
-												Add some interesting data models for person's names.

											
										
										
											2016-09-08 12:18:57 +02:00
+								- [HL7 V3 RIM](http://www.hl7.org/implement/standards/product_brief.cfm?product_id=186): a flexible data model for representing human names.
 								- [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.
-												Add seminal falsehoods.
											
										
										
											2016-09-08 11:22:55 +02:00
-												Add network section.

											
										
										
											2016-09-09 00:16:51 +02:00
+								## Networks
 								- [Falsehoods programmers believe about networks](http://blog.erratasec.com/2012/06/falsehoods-programmers-believe-about.html)
-												Add Phone number section.

											
										
										
											2016-09-08 12:22:33 +02:00
+								## Phone numbers
 								- [`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).
-												Add Price section.

											
										
										
											2016-09-08 12:14:45 +02:00
+								## Prices
-												End all lines by points.

											
										
										
											2016-09-08 12:27:13 +02:00
+								- [Falsehoods programmers believe about prices](https://gist.github.com/rgs/6509585).
-												Add Price section.

											
										
										
											2016-09-08 12:14:45 +02:00
-												Grammar.

											
										
										
											2016-09-08 11:34:02 +02:00
+								## Postal addresses
-												Add seminal falsehoods.
											
										
										
											2016-09-08 11:22:55 +02:00
-												Add postal address libraries.

											
										
										
											2016-09-08 12:28:23 +02:00
+								- [Falsehoods programmers believe about addresses](https://www.mjt.me.uk/posts/falsehoods-programmers-believe-about-addresses/).
 								- [`libaddressinput`](https://github.com/googlei18n/libaddressinput): Google's common C++ and Java library for parsing, formatting, and validating international postal addresses.
-												Add PHP library for postal addresses.

											
										
										
											2016-09-08 12:34:03 +02:00
+								- [`addressing`](https://github.com/commerceguys/addressing): A PHP 5.4+ addressing library, powered by Google's dataset.
-												Add postal address libraries.

											
										
										
											2016-09-08 12:28:23 +02:00
+								- [`postal-address`](https://github.com/scaleway/postal-address): Python module to parse, normalize and render postal addresses.
-												Add BDS 2-clause License.

											
										
										
											2016-09-08 11:33:09 +02:00
-												Add version section.

											
										
										
											2016-09-09 00:18:02 +02:00
+								## Versions
 								- [Falsehoods programmers believe about versions](https://github.com/xenoterracide/falsehoods/blob/master/versions.md)
-												Add contribution guidelines.

											
										
										
											2016-09-09 01:35:58 +02:00
+								## Contributing
 								Your contributions are always welcome! Please take a look at the [contribution
 								guidelines](CONTRIBUTING.md) first.
-												Typos.

											
										
										
											2016-09-09 01:16:46 +02:00
+								## License
-												Add BDS 2-clause License.

											
										
										
											2016-09-08 11:33:09 +02:00
-												Fix trailing linked space.

											
										
										
											2016-09-08 12:27:39 +02:00
+								Content of this repository is licensed under the [BSD 2-Clause
 								License](LICENSE.md).