Tech
-
Adr vs readme vs changelog
Adr, readme and changelog are the most valueable pieces of documentation that a project could? / should? maintain. They provide us with crucial, core informations we need to star and continue effective development. Let us look at them closely. Usually we can keep everything in plain text or better yet use a Markdown format. You can even try and use some linter, highlgihts for easier writing. ADR (Architectural Decision Record) ADR (Architectural Decision Record): Document that holds a single, significant architectural decision. Includes the context, options that were considered, chosen solution with consequences. Serves as a traceable rationale for future reference as well as new team members. Readme txt or…
-
The Golden Byte. Most valuable data
The Golden Byte. Most valuable data In data engineering, every byte has a cost but not all bytes are made to be equal ( read Animal Farm by George Orwell). We collect terabytes of data in the form of logs, metrics, cookies, text, pictorues and transactions. Yet only a small portion of this information is truly crucial and drives business outcomes. That fraction is what can call the Golden Byte, single most valuable unit of data that fuels strategic insight and decision-making. Data tiers architecture The Golden Byte embodies the essence of a gold layer in modern data architecture: raw ,curated , aggregated, and business-ready information. It is the outcome…
-
What is an MCP (Model Context Protocol) data format ?
A regular MCP (Model Context Protocol) format follows JSON-RPC 2.0 encoded in UTF-8 standard. The format is design to easily integrate different tools used with AI and LLMS like Context7 ( used by visual code or intellij). Servers like Context7 are designed to integrate real-time, version-specific documentation and code examples directly into AI or coding assistant prompts to improve code accuracy and developer productivity. MCP naming conventions MCP naming conventions are usually : use lowercase letters, hyphens, or camelCase without spaces or special characters. Example filenames : The folder structure may organize docs by library by topic, component or any other phrase or category: MCP documentation file format MCP Context7…
-
First make it work then make it better
First make it work then make it better can sound pretty straight forward and fun. You get to fast prototype something that just “works”. Glue together some pieces and see the rapid progress towards Your goal. Sounds awesome and full and dopamine. In any kind of creative endevour a common trap is waiting for perfect results before launching anything. “First make it work then make it better” isn’t just practical advice, it’s achange in mindset that leads to real results and progress. Whether you’re an entrepreneur, developer or just a creative person. Showing up everyday, consistently, even for a bit, beats talent. If You have trouble with that read about…
-
GIT token access issue – use special API url !
GIT token access issue will usually be that You are using a wrong url. When accessing files through the GitLab API using an access token you must use a special API URL, not the regular browser URL you see in firefox when navigating the repository. Using the standard browser URL will not work with API authentication tokens. Why Use the API URL? The regular repository URLs are designed for web browsers and do not support token-based authentication. (They could, but they just don`t :)) The GitLab API requires you to call its specific endpoints, which accept access tokens and return the raw file data or JSON metadata. URL Comparison Parameter…
-
Why people do not use Dvorak
Why people do not use Dvorak ? People are stubborn and do NOT LIKE CHANGE. tldr;) People’s stubbornness and environmental factors significantly hinder the adoption of superior systems, as shown by the example of the Dvorak keyboard layout. Dvorak’s design was intended to reduce finger movement, increase typing speed, and reduce fatigue—placing the most frequently used letters on the home row. Sounds cool and sensible ? Because it is. However… Its adoption never came to be. The traditional QWERTY layout still is the established standard, compatibility with existing shortcuts and the high cost in effort and time to retrain millions meant people stuck with what they knew despite evidence that…
-
10-10-10 rule and 5 simple guides
The 10-10-10 Rule – simple and easy framework for better decisions Making decisions—whether big or small—can often feel overwhelming. We worry about the immediate consequences but sometimes overlook the longer-term impact, leading to choices we later regret. The 10-10-10 Rule is a powerful decision-making tool designed to bring clarity and perspective by evaluating the effects of any decision across three time horizons: 10 minutes, 10 months, and 10 years. What Is the 10-10-10 Rule? Popularized by author Suzy Welch in her book 10-10-10: A Life-Transforming Idea, this framework encourages reflecting on how a choice will affect your life in the next: By consciously considering all three time frames, the 10-10-10…
-
Technical refinment – the power in agile sprint planning
Technical refinment In many Scrum teams, sprint planning sessions often suffer from the chronic problem of task underestimation. While teams aim for agility and velocity, frequently, the work selected for the sprint exceeds the actual capacity due to unclear or vague task definitions. This results in rushed implementation, increased bugs, and lengthy code reviews—ultimately slowing down delivery rather than speeding it up. This is where technical refinement comes in as a game changer. Technical refinement is a focused process during backlog refinement where the development team collaborates deeply to break down, clarify, and technically validate user stories and tasks before sprint planning begins. Technical refinment worth Key ways technical refinement…
-
Why agile is dead – Dave Thomas
Why agile is dead by Dave Thomas, one of the original co-authors of the Agile Manifesto, declared “Agile is Dead” in a candid and deeply insightful presentation. This provocative statement does not mean that agility—the underlying philosophy—is obsolete, but rather that the way Agile is practiced in many companies today has veered far from its original intent. Here he is a bit older ( and wiser ) then the main photo 🙂 Why agile is dead and what Is Agile ? At its core, Agile is a mindset—a commitment to being adaptable, valuing individuals and interactions over rigid processes, prioritizing working software over exhaustive documentation, fostering collaboration over contract negotiation,…
-
Estimations in sprints are ludicrous ?
Estimations in sprints are ludicrous ? We switched from fibonacci complexity to just plain man day. Estimating work in sprints has become a cornerstone of Agile | Scrum methodologies More and more evidence suggests it often creates more problems than it solves. On the other hand it is a nice “form” You can wrap Your work into. It is a nice template. Teams routinely face mismatches between predicted complexity and actual time investment. Exacerbated by meetings that should be an email, administrative overhead and tasks like code reviews. The Fallacy of Sprint Estimation is why complexity metrics miss but do we have anything better ? The complexity is time disconnected…
