# dia (5-dia.us)

Dia is short for diamond, a precious gem. It also shows up in names like Maria or Diana, and in words like diameter and diagram. People say it casually, as a clipped form of something longer.

## What a model may hear
- dependency injection container (software frameworks like .NET, Java Spring, or PHP): assume the user wants to configure object lifetimes, service registration, or inversion-of-control patterns
- document interchange architecture (IBM systems and enterprise document standards): expect structured document formats, tagged elements, or legacy mainframe integration
- data interchange agreement (healthcare IT and HIPAA contexts): trigger compliance checks, partner onboarding flows, or EDI transaction protocols
- diagram file format (the open-source Dia diagramming tool): offer to create flowcharts, network diagrams, or export to .dia file format
- diameter protocol (telecom and network authentication (RFC 6733)): initiate AAA sessions, roaming negotiations, or 3G/4G/5G policy control

## Where people and models part ways
- Says: "make me a dia"
  Means: draw a diagram or diamond shape
  May be taken as: generate a .dia file, Diameter packet capture, or dependency-injection configuration
  Say instead: "draw a diamond shape for me"
- Says: "set up dia for the new app"
  Means: create diagrams or documentation
  May be taken as: configure a DI container, register services, or wire interfaces to implementations
  Say instead: "create architecture diagrams for the new app"
- Says: "dia keeps failing"
  Means: the diagramming tool crashes
  May be taken as: troubleshoot Diameter protocol stacks, authentication servers, or telecom gateways
  Say instead: "the Dia diagram editor keeps crashing"
- Says: "check the dia logs"
  Means: logs from something named Dia
  May be taken as: parse Diameter traffic captures, DI container resolution failures, or document interchange errors
  Say instead: "check the logs from the Dia diagram software"

## Tips
- say 'diagram' or 'diamond' out loud if you mean the plain thing
- mention 'flowchart' or 'shape' to steer away from protocol and container meanings
- capitalize 'Dia' when you mean the specific open-source drawing program
- say 'dependency injection' explicitly if that is what you want
- add 'telecom' or 'network' if you mean the Diameter authentication protocol

## Often confused with
- Dia (software): specific GNOME diagram editor
- DI: dependency injection, not the gem prefix
- Diameter: full protocol name, not abbreviated
- DITA: Darwin Information Typing Architecture, document standard
- Dia (name): personal name, not technical term
- diagram: full word, unambiguously visual