{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-declarative-configuration",
  "id": "declarative-configuration",
  "kind": "principle",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-declarative-core",
    "json": "https://banes-lab.com/json/records/layer/declarative-core",
    "label": "Declarative Core",
    "markdown": "https://banes-lab.com/records/layer/declarative-core.md",
    "ref": "layer:declarative-core"
  },
  "name": "Declarative Configuration",
  "ref": "architecture:declarative-configuration",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-schema-validation",
          "json": "https://banes-lab.com/json/records/architecture/schema-validation",
          "label": "Schema Validation",
          "markdown": "https://banes-lab.com/records/architecture/schema-validation.md",
          "ref": "architecture:schema-validation"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-explicit-semantics",
          "json": "https://banes-lab.com/json/records/lexicon/explicit-semantics",
          "label": "Explicit Semantics",
          "markdown": "https://banes-lab.com/records/lexicon/explicit-semantics.md",
          "ref": "lexicon:explicit-semantics"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-predictability",
          "json": "https://banes-lab.com/json/records/architecture/predictability",
          "label": "Predictability",
          "markdown": "https://banes-lab.com/records/architecture/predictability.md",
          "ref": "architecture:predictability"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-infrastructure-as-code",
          "json": "https://banes-lab.com/json/records/architecture/infrastructure-as-code",
          "label": "Infrastructure as Code",
          "markdown": "https://banes-lab.com/records/architecture/infrastructure-as-code.md",
          "ref": "architecture:infrastructure-as-code"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-runtime-configuration-without-code-change",
          "json": "https://banes-lab.com/json/records/lexicon/runtime-configuration-without-code-change",
          "label": "Runtime Configuration without Code Change",
          "markdown": "https://banes-lab.com/records/lexicon/runtime-configuration-without-code-change.md",
          "ref": "lexicon:runtime-configuration-without-code-change"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-hardcoded-configuration",
          "json": "https://banes-lab.com/json/records/architecture/hardcoded-configuration",
          "label": "Hardcoded Configuration",
          "markdown": "https://banes-lab.com/records/architecture/hardcoded-configuration.md",
          "ref": "architecture:hardcoded-configuration"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-dynamic-complexity",
          "json": "https://banes-lab.com/json/records/lexicon/dynamic-complexity",
          "label": "Dynamic Complexity",
          "markdown": "https://banes-lab.com/records/lexicon/dynamic-complexity.md",
          "ref": "lexicon:dynamic-complexity"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-declarative-configuration-dynamic-complexity",
          "json": "https://banes-lab.com/json/records/tension/declarative-configuration-dynamic-complexity",
          "label": "Declarative Configuration / Dynamic Complexity",
          "markdown": "https://banes-lab.com/records/tension/declarative-configuration-dynamic-complexity.md",
          "ref": "tension:declarative-configuration-dynamic-complexity"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/algorithms#algorithms-declarative-core",
          "json": "https://banes-lab.com/json/records/algorithms/declarative-core",
          "label": "Declarative Core",
          "markdown": "https://banes-lab.com/records/algorithms/declarative-core.md",
          "ref": "algorithms:declarative-core"
        }
      ],
      "relation": "contracts"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-hardcoded-behavior",
          "json": "https://banes-lab.com/json/records/lexicon/hardcoded-behavior",
          "label": "Hardcoded Behavior",
          "markdown": "https://banes-lab.com/records/lexicon/hardcoded-behavior.md",
          "ref": "lexicon:hardcoded-behavior"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-externalize-configuration",
          "json": "https://banes-lab.com/json/records/lexicon/externalize-configuration",
          "label": "Externalize Configuration",
          "markdown": "https://banes-lab.com/records/lexicon/externalize-configuration.md",
          "ref": "lexicon:externalize-configuration"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-configuration-schema",
          "json": "https://banes-lab.com/json/records/lexicon/configuration-schema",
          "label": "Configuration Schema",
          "markdown": "https://banes-lab.com/records/lexicon/configuration-schema.md",
          "ref": "lexicon:configuration-schema"
        }
      ],
      "relation": "refactored-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-recommended",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-recommended",
          "label": "recommended",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-recommended.md",
          "ref": "vocabulary:severity-recommended"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-metadata-self-description-declarative-systems",
          "json": "https://banes-lab.com/json/records/architecture-category/metadata-self-description-declarative-systems",
          "label": "Metadata / Self-Description / Declarative Systems",
          "markdown": "https://banes-lab.com/records/architecture-category/metadata-self-description-declarative-systems.md",
          "ref": "architecture-category:metadata-self-description-declarative-systems"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-metadata-driven-design",
          "json": "https://banes-lab.com/json/records/architecture/metadata-driven-design",
          "label": "Metadata-Driven Design",
          "markdown": "https://banes-lab.com/records/architecture/metadata-driven-design.md",
          "ref": "architecture:metadata-driven-design"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-domain-specific-language",
          "json": "https://banes-lab.com/json/records/architecture/domain-specific-language",
          "label": "Domain-Specific Language",
          "markdown": "https://banes-lab.com/records/architecture/domain-specific-language.md",
          "ref": "architecture:domain-specific-language"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-registry-held-order",
          "json": "https://banes-lab.com/json/records/architecture/registry-held-order",
          "label": "Registry-Held Order",
          "markdown": "https://banes-lab.com/records/architecture/registry-held-order.md",
          "ref": "architecture:registry-held-order"
        }
      ],
      "relation": "reinforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/pag/orchestration#declared-structure",
          "json": "https://banes-lab.com/json/pag/orchestration/declared-structure",
          "label": "Orchestration as declared structure",
          "markdown": "https://banes-lab.com/pag/orchestration/declared-structure.md",
          "ref": "chapter:/pag/orchestration#declared-structure"
        },
        {
          "href": "https://banes-lab.com/software-architecture#definitions-own-what",
          "json": "https://banes-lab.com/json/software-architecture/model/definitions-own-what",
          "label": "Definitions own what, code owns how",
          "markdown": "https://banes-lab.com/software-architecture/model/definitions-own-what.md",
          "ref": "chapter:/software-architecture#definitions-own-what"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-anti-patterns",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-anti-patterns",
          "label": "Anti-patterns",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-anti-patterns.md",
          "ref": "chapter:/ontology#architecture-category-anti-patterns"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-correctness-determinism-verification",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-correctness-determinism-verification",
          "label": "Correctness / Determinism / Verification",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-correctness-determinism-verification.md",
          "ref": "chapter:/ontology#architecture-category-correctness-determinism-verification"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-portability-infrastructure-deployment",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-portability-infrastructure-deployment",
          "label": "Portability / Infrastructure / Deployment",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-portability-infrastructure-deployment.md",
          "ref": "chapter:/ontology#architecture-category-portability-infrastructure-deployment"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-metadata-self-description-declarative-systems",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-metadata-self-description-declarative-systems",
          "label": "Metadata / Self-Description / Declarative Systems",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-metadata-self-description-declarative-systems.md",
          "ref": "chapter:/ontology#architecture-category-metadata-self-description-declarative-systems"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-metaprogramming-language-oriented-architecture",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-metaprogramming-language-oriented-architecture",
          "label": "Metaprogramming / Language-Oriented Architecture",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-metaprogramming-language-oriented-architecture.md",
          "ref": "chapter:/ontology#architecture-category-metaprogramming-language-oriented-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-schema-canonical-data-semantics",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-schema-canonical-data-semantics",
          "label": "Schema / Canonical Data / Semantics",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-schema-canonical-data-semantics.md",
          "ref": "chapter:/ontology#architecture-category-schema-canonical-data-semantics"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-taxonomy-classification-naming",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-taxonomy-classification-naming",
          "label": "Taxonomy / Classification / Naming",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-taxonomy-classification-naming.md",
          "ref": "chapter:/ontology#architecture-category-taxonomy-classification-naming"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-control-coordination-centralization",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-control-coordination-centralization",
          "label": "Control / Coordination / Centralization",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-control-coordination-centralization.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-control-coordination-centralization"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-metadata-self-description-declarative-systems",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-metadata-self-description-declarative-systems",
          "label": "Metadata / Self-Description / Declarative Systems",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-metadata-self-description-declarative-systems.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-metadata-self-description-declarative-systems"
        },
        {
          "href": "https://banes-lab.com/ontology/algorithms#algorithms-domain-architectural-clusters",
          "json": "https://banes-lab.com/json/ontology/algorithms/algorithms-domain-architectural-clusters",
          "label": "Architectural Clusters",
          "markdown": "https://banes-lab.com/ontology/algorithms/algorithms-domain-architectural-clusters.md",
          "ref": "chapter:/ontology/algorithms#algorithms-domain-architectural-clusters"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/anatomy/tree#folder-configuration-constants",
          "json": "https://banes-lab.com/json/anatomy/tree/folder-configuration-constants",
          "label": "configuration/constants",
          "markdown": "https://banes-lab.com/anatomy/tree/folder-configuration-constants.md",
          "ref": "chapter:/anatomy/tree#folder-configuration-constants"
        },
        {
          "href": "https://banes-lab.com/anatomy/tree#folder-configuration-icons",
          "json": "https://banes-lab.com/json/anatomy/tree/folder-configuration-icons",
          "label": "configuration/icons",
          "markdown": "https://banes-lab.com/anatomy/tree/folder-configuration-icons.md",
          "ref": "chapter:/anatomy/tree#folder-configuration-icons"
        }
      ],
      "relation": "evidence"
    }
  ],
  "summary": "A design rule that a system's settings are declared as validated data, and the system configures itself from that data.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-convention-over-configuration",
      "json": "https://banes-lab.com/json/records/architecture/convention-over-configuration",
      "label": "Convention over Configuration",
      "markdown": "https://banes-lab.com/records/architecture/convention-over-configuration.md",
      "ref": "architecture:convention-over-configuration"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-metadata-driven-design",
      "json": "https://banes-lab.com/json/records/architecture/metadata-driven-design",
      "label": "Metadata-Driven Design",
      "markdown": "https://banes-lab.com/records/architecture/metadata-driven-design.md",
      "ref": "architecture:metadata-driven-design"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [],
  "exemplar": {
    "after": "const config = defineFooConfig({\n  cache: { enabled: true },\n  retries: 3,\n  plugins: [\"bar\"],\n});\nconst app = FooApp.fromConfig(config);",
    "before": "const app = new FooApp();\napp.enableCache();\napp.setRetries(3);\napp.register(new BarPlugin());",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "configuration",
    "infrastructure",
    "runtime"
  ],
  "severity": "recommended"
}