Architecture diagrams

The Unified Modeling Language (UML) is a graphical language for visualizing, specifying, constructing, and documenting the artifacts of a software-intensive system.

This diagram neatly summarizes the 14 UML diagram types defined in UML 2

Talk about a picture speaking a thousand words!

Comments

Post a Comment

Popular posts from this blog

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

GitHub Markdown Keyboard Shortcuts

Image
GitHub's web editor (used in issues, pull requests, comments, Markdown files, etc.) has built-in keyboard shortcuts that work in the standard Markdown editing mode - Keyboard Shortcut Description Ctrl + B Inserts Markdown formatting for bold text Ctrl + I Inserts Markdown formatting for italic text Ctrl + E Inserts Markdown formatting for inline code (one-liner) Ctrl + K Inserts Markdown formatting for a link Ctrl + Shift + 7 Inserts Markdown formatting for an ordered (numbered) list Ctrl + Shift + 8 Inserts Markdown formatting for an unordered (bullet) list Ctrl + Shift + . Inserts Markdown formatting for a blockquote Ctrl + Shift + P Toggles between Write and Preview tabs (in comments, issues, PRs, or file editor) Ctrl + Enter Submits the comment/form (in issue/PR/comment fields) Ctrl + V (with text selected) ...
Read more

This Week I Learned - Week 15 2026

Image
This Week I Learned -  *  Potato Prompt  used in Custom Instructions can make AI stop being a collaborator and start being a "Devil’s Advocate" -  " Whenever I type the word 'Potato' followed by an idea or argument, I want you to ignore your 'helpful' persona. Instead, act as a Hostile Critic . Your only job is to find the 'holes' in my logic. Point out three specific ways my argument could fail, two assumptions I’m making without proof, and one counter-argument I haven't addressed. Do not be polite; be precise. " * Yann LeCun and his team have developed LeWorldModel, the first stable model built with his Joint Embedding Predictive Architecture (JEPA). Their aim is to create models that go beyond just predicting words, focusing instead on truly understanding the world and how it functions. * Distillation is a technique where an older “teacher” AI model is used to train a newer, “student,” model that replicates the capabilities of the earl...
Read more