Page 21 - Monthly Archives: July 2025

A year after a type decision, nobody on the team usually remembers why a specific generic constraint or a discriminated union was modeled exactly that way. A short Architecture Decision Record captures the reason, the alternatives and the consequences, so type decisions stay traceable instead of being re-guessed at every refactoring.

Anyone who works with Git daily through the command line types certain command combinations dozens of times a day, often with the same options and formatting flags. Git aliases bundle such recurring commands into a single, short command, saving not only keystrokes but also mental overhead, since complex standard workflows no longer need to be reassembled every time. This article covers how simple and advanced aliases work, which ones have proven themselves in practice, and how to distribute them across a team.

Class names originating from a headless CMS field, an MDX file, or an npm component library often sit outside the reach of the Tailwind scanner. Anyone who does not understand why content scanning fails right there loses time chasing mysteriously missing CSS, even though the class is visibly sitting in the markup.

Anyone who forks a separate theme for every brand pays twice with every Hyvä update. A well thought out multi-store theme strategy instead uses Magento's fallback hierarchy of theme, website, and store view to run one shared Hyvä theme for multiple stores in a way that stays consistent, maintainable, and update-safe.

Anyone running a Symfony REST API without documentation leaves the tedious reverse engineering work to consumers and QA teams. NelmioApiDocBundle generates a complete OpenAPI 3.1 specification from PHP attributes and YAML configuration, including Swagger UI, JWT security schemes, and response schemas straight from the code.

Most web applications read from the database far more often than they write to it, which turns the primary server into a bottleneck even though writes make up only a small share of the load. Read replicas distribute read traffic across additional server copies and take noticeable pressure off the primary.

Screen reader users lose no information when a purely decorative image is missing, but they lose important context when an informative image has no alt text. This article shows a practical test for telling the two apart, correct techniques like empty alt, CSS background images and aria-hidden, and common mistakes when handling icons and decorative graphics in Magento and Hyvä stores.

Running ten Magento shops with ten identical pipeline files is technical debt in its purest form. Every change to the deploy process has to be made ten times. GitLab templates with include and extends solve this problem: one central build standard, individually extensible per project.

HTTP status codes and global response times say little about GraphQL APIs. Resolver latency, error classes, field usage and N+1 detection are the metrics that make real production problems visible.

A Magento rollback is more than flipping a symlink. The database, queue messages, static content, and Elasticsearch indexes each follow their own rules. Anyone who rolls back only the files risks inconsistencies that are harder to fix than the original problem.