Rules, Principles, Guidelines

Here the principles rules and guidelines we use to create our software services.

Short ones

Key words for use in RFCs to Indicate Requirement Levels (RFC 2119). We use it internal requierements and specifications.

Twelve Factors app guide give general advices and principles to build a SaaS

Enterprise Architecture on a Page. The big poster provides a great overview of all the concepts of Entreprise Architecture.

Government Design Principles The UK government's design principles and examples of how they've been used. This principles are just inspiring at any level.

Semantic Versionning. How to write and explain a software or software component version number.



[Architecting systems that uses third party systems][3ps] short article to introduce the high level concepts of integration.

3ps: https://shekhargulati.com/2022/02/16/factors-to-consider-when-architecting-systems-on-top-of-third-party-systems/

Two Techniques for solving unreproducible (random) bugs. Gets back on system design and then defines way to explore or to amplify to reproduce a problem.

rnd: https://hindenbug.io/two-techniques-for-solving-unreproducible-random-bugs-97e03ac02eb9

The heavy lifters

ITIL (formerly Information Technology Infrastructure Library) which provides process, procedures, taks, checklists, and forms. We sink in it when dealing with design, transition and operations.


This is not the core rules, principles or guidelines we use. Yet we frequently interact with them

GMP (Good Manufacturing Practices).

The article influence.


I remember my first visit to Vietnam like yesterday. I was in awe of the beauty of the place. I was also scared whenever I had to cross a busy street. The cars and moto and bikes, were acting like a swarm. Usually, people get to ask in a taxi if there is any driving rule.

The driver would reply we have guidelines, but we don't follow.