| CONTRIBUTING.md | ||
| LICENSE.md | ||
| README.md | ||
Awesome Falsehood 
A curated list of awesome falsehoods programmers believe in.
Contents
- Foreword
- Good candidates
- Meta
- Build systems
- Dates and time
- E-commerce
- Emails
- Gender
- Geography
- Human names
- Networks
- Phone numbers
- Prices
- Postal addresses
- Versions
- Contributing
- 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 - A curated list of awesome falsehoods programmers believe in.
- Falsehoods Programmers Believe - A brief list of common falsehoods. A great overview and quick introduction into the world of falsehoods.
Build systems
Dates and time
- Falsehoods programmers believe about time - Seminal article on dates and time.
- More falsehoods programmers believe about time - Part. 2 of the article above.
- Falsehoods programmers believe about time and time zones - Another takes on time-related falsehoods, with an emphasis on time zones.
- Falsehoods Programmers Believe About Time - 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
Emails
Gender
Geography
Human names
- Falsehoods Programmers Believe About Names.
- XKCD #327: Exploits of a Mom.
- HL7 V3 RIM: a flexible data model for representing human names.
- iOS NSPersonNameComponentsFormatter: localized representations of the components of a person’s name.
Networks
Phone numbers
libphonenumber: Google's common Java, C++ and JavaScript library for parsing, formatting, and validating international phone numbers. Also available for C#, Objective-C, Python, Ruby and PHP.
Prices
Postal addresses
- Falsehoods programmers believe about addresses.
libaddressinput: Google's common C++ and Java library for parsing, formatting, and validating international postal addresses.addressing: A PHP 5.4+ addressing library, powered by Google's dataset.postal-address: Python module to parse, normalize and render postal addresses.
Versions
Contributing
Your contributions are always welcome! Please take a look at the contribution guidelines first.
License
Content of this repository is licensed under the BSD 2-Clause License.