Falsehoods
A curated list of falsehoods programmers believe in, covering topics from names and dates to networks and geography.
What is Falsehoods?
Awesome Falsehoods is a curated GitHub repository that collects articles and resources documenting common false assumptions—"falsehoods"—that programmers believe about various topics. It addresses misconceptions in areas like names, dates, addresses, and networks, which can lead to software bugs when implemented. The project helps developers recognize edge cases and build more robust, inclusive applications.
Software developers, engineers, and technical leads who design or implement systems handling real-world data like user input, internationalization, or domain-specific logic. It's particularly valuable for those building applications with global reach or complex validation requirements.
Developers choose Awesome Falsehoods because it provides a centralized, community-vetted resource to anticipate and avoid common pitfalls that aren't covered in standard documentation. Its curated format saves research time and helps teams proactively design for edge cases rather than fixing bugs later.
Overview
😱 Falsehoods Programmers Believe in
Use Cases
Best For
- Designing validation logic for user input like names, emails, or phone numbers
- Implementing internationalization (i18n) and localization (l10n) features
- Building systems that handle dates, times, and time zones correctly
- Writing parsers for formats like addresses, CSV files, or URLs
- Developing APIs or data models that need to accommodate global diversity
- Learning about edge cases in software engineering through real-world examples
Not Ideal For
- Teams needing immediate, production-ready code snippets for validation or parsing
- Projects with narrow, well-documented scopes that don't require handling diverse global data
- Developers seeking interactive, hands-on tutorials or structured courses for quick learning
Pros & Cons
Pros
Organizes falsehoods across 20+ categories like Dates and Time, Human Identity, and Networks, providing a comprehensive overview of edge cases in software development, as detailed in the README's table of contents.
Links to articles with specific, practical edge cases, such as emails with multiple @ symbols or names with special characters, helping developers see the direct impact of false assumptions on their code.
Accepts contributions via GitHub, allowing the list to grow and stay current with new falsehoods, ensuring it reflects evolving best practices and real-world issues.
Covers both technical topics (e.g., software engineering) and non-technical ones (e.g., business, society), offering a holistic view that aids in building inclusive and robust systems.
Cons
Focuses on theoretical falsehoods without providing ready-to-use code snippets or libraries, forcing developers to seek additional resources for practical implementation, which can slow down development.
The extensive list of articles and categories can be overwhelming to navigate, making it difficult for users to quickly find relevant information for specific, urgent problems.
As a static collection of links, it lacks interactive elements or structured learning paths, which may reduce engagement and effectiveness for developers who prefer hands-on or guided educational approaches.
Frequently Asked Questions
Related Projects
Big List of Naughty StringsThe Big List of Naughty Strings is a list of strings which have a high probability of causing issues when used as user-input data.
Unicode:joy: :ok_hand: A curated list of delightful Unicode tidbits, packages and resources.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.