Style matters

Preface of C# Code Style Guide
  • 80% of the lifetime cost of a piece of software goes to maintenance.
  • Hardly any software is maintained for its whole life by the original author.
  • Code conventions improve the readability of the software, allowing engineers to understand new code more quickly and thoroughly.
  • Your source code is a product; you need to make sure it is as well-packaged and clean.

Comments

Post a Comment

Popular posts from this blog

30+ GitHub Products & Key Ecosystem Features You Should Know in 2026

Image
GitHub has grown far beyond a place to host code — today it's an entire ecosystem covering CI/CD, AI-assisted development, security, package management, and team collaboration. Whether you're new to the platform or just want a single reference point, here's an alphabetical list of GitHub's major products and features, each linked to its official page - GitHub Actions GitHub Advanced Security GitHub Apps GitHub CLI GitHub Code Review GitHub Code Security GitHub Codespaces GitHub Container Registry GitHub Copilot GitHub Copilot Business GitHub Copilot CLI GitHub Copilot Enterprise GitHub Copilot Extensions GitHub Dependabot GitHub Desktop GitHub Discussions GitHub Education GitHub Enterprise Cloud GitHub Enterprise Server GitHub Gist GitHub Importer GitHub Innovation Graph GitHub Issues GitHub Marketplace GitHub Mobile GitHub Models  (retiring July 30, 2026) GitHub Packages GitHub Pages ...
Read more

Book Review: Grokking Relational Database Design

Image
The evolution of AI is deeply intertwined with how data has been managed, structured, and ultimately harnessed for intelligence. In this context, the foundational skill of database design remains as relevant as ever although it's often seen as unglamorous due to the somewhat esoteric database jargon.  Grokking Relational Database Design , written by academicians Qiang Hao and Michail Tsikerdekis, is a beginner-friendly guide that explains complex concepts with modern references, relatable examples and helpful design diagrams. What stands out is the authors’ teaching experience, which informs their approach. The book avoids being anchored to a single RDBMS. It references widely used systems like MySQL, PostgreSQL, SQLite, SQL Server, and Oracle, encouraging learners to apply their knowledge using freely available tools like dbdiagram.io and sqliteonline.com . Years ago, when there were far fewer accessible learning resources or real-world data model samples, I often relied on...
Read more

Uncle Bob vs. Grady Booch: Rethinking Code Reviews in the Age of AI

Image
In response to a question about the feasibility of effective code reviews for large (e.g., 500-line) AI-generated PRs like those from Claude, especially when reviewers lack deep codebase familiarity in new projects or fast-paced environments, Uncle Bob Martin and Grady Booch have contrasting views Uncle Bob Martin advocates metrics-based oversight (test coverage, complexity, dependencies) and higher-level management over line-by-line AI code review, while Grady Booch stresses manual verification for vulnerabilities, dead code, and performance factors. Uncle Bob Martin : " I don’t review code written by agents . I measure things like test coverage, dependency structure, cyclomatic complexity, module sizes, mutation testing, etc.  Much can be inferred about the quality of the code from those metrics. The code itself I leave to the AI.  Humans are slow at code. To get productivity we humans need to disengage from code and manage from a higher level." Grady Booch : "Unlike B...
Read more