DIFF.BLOG
New Following Discover Jobs
More
Top Writers Suggest a blog Upvotes plugin
Report bug Contact About
Sign up
Topics
Follow your own topics →
Menu
New Following Discover Jobs Top Writers
More
Suggest a blog Upvotes plugin Report bug Contact About
Sign up
The home for great developer writing.
We surface the best developer writing from thousands of independent blogs, updated daily.
Join Diff.blog
TOPICS

API design note: Don’t make up multiple names for the same thing

1 · Raymond Chen · July 28, 2025, 5:12 p.m.
Old New Thing Code api-design Naming Conventions software development developer best practices
Summary
This post emphasizes the importance of consistency in naming conventions when designing APIs, arguing that using multiple names for the same entity can confuse users and lead to unnecessary complexity. It suggests that clarity in naming is crucial for effective communication and usage of APIs.
Read full post on devblogs.microsoft.com →
MORE POSTS LIKE THIS
Some failures of encapsulation
Natemeyvis · Aug 14, 2026
encapsulation sociology of software
Langgraph4rust v0.2.0 – A stateful workflow engine for Rust, inspired by Python's LangGraph
Users Rust Lang · Aug 2, 2026
Rust Workflow Engine
My Naming Philosophy
Palak Mathur · Jul 23, 2026
software-engineering computer-science
There's always a niche: rawzip and the cost of ergonomics
Nickb · Jul 18, 2026
Rust zip library
Content addressing in package managers
Andrew Nesbitt · Jul 7, 2026
package managers Security
Cooldown or Compromise: The 7-Day Rule for npm and PyPI
Research Eye · Jun 23, 2026
Tech blog npm
Discover more posts →
AUTHOR
RECENT POSTS FROM THE AUTHOR
Choose how you want to continue.
Continue with GitHub Continue with Google