{
  "standard": "Fenexity Technical Language",
  "abbreviation": "FTL",
  "version": "1.0.0",
  "generatedAt": "2026-10-05",
  "schema": "https://semantics.fenexity.com/schemas/general-language.schema.json",
  "category": "General Language",
  "description": "A small Fenexity-owned controlled vocabulary for ordinary technical English. FTL controls general vocabulary only where doing so removes demonstrated or likely ambiguity. It does not prohibit words that carry a useful semantic distinction.",
  "entries": [
    {
      "id": "start-operation",
      "meaning": "begin execution of an operation or process",
      "preferred": "start",
      "avoid_for_same_meaning": [
        "begin",
        "commence"
      ],
      "note": "Do not replace initialize or launch when those words represent distinct technical operations (initialization establishes state; launch creates or starts an application or process)."
    },
    {
      "id": "use-word",
      "meaning": "employ a resource, tool, or mechanism for a purpose",
      "preferred": "use",
      "avoid_for_same_meaning": [
        "utilize"
      ],
      "note": "Utilize adds no meaning over use in ordinary technical prose. Keep utilize only when emphasizing an unexpected or non-obvious application."
    },
    {
      "id": "approximate-value",
      "meaning": "an amount or value that is not exact",
      "preferred": "approximately",
      "avoid_for_same_meaning": [
        "roughly"
      ],
      "note": "Prefer approximately in normative or measured contexts. Roughly is acceptable in informal notes. If an exact figure exists, state it instead."
    },
    {
      "id": "perform-action",
      "meaning": "carry out an action or operation",
      "preferred": "perform",
      "avoid_for_same_meaning": [
        "do"
      ],
      "note": "Do is acceptable in runbooks and casual text; prefer perform when the action is a named operation with defined steps."
    },
    {
      "id": "ensure-condition",
      "meaning": "make certain that a condition holds",
      "preferred": "ensure",
      "avoid_for_same_meaning": [
        "make sure"
      ],
      "note": "Prefer ensure in normative and technical text. Make sure is acceptable in user guidance. Where a mechanism guarantees the condition, prefer guarantee."
    },
    {
      "id": "provide-item",
      "meaning": "make an item or capability available to someone or something",
      "preferred": "provide",
      "avoid_for_same_meaning": [
        "supply"
      ],
      "note": "Provide is the general term. Supply implies a sustained or contractual delivery and should be kept where that distinction matters (for example energy supply)."
    },
    {
      "id": "end-process",
      "meaning": "bring an operation or process to a close",
      "preferred": "end",
      "avoid_for_same_meaning": [
        "terminate"
      ],
      "note": "End is the general term. Terminate has a stronger, often abrupt connotation and is normative in domains such as OCPP session handling; keep it where abrupt or programmatic ending is intended. Finish is acceptable for user-facing prose."
    },
    {
      "id": "change-value",
      "meaning": "make a value, configuration, or behavior different",
      "preferred": "change",
      "avoid_for_same_meaning": [
        "modify"
      ],
      "note": "Change and modify are interchangeable in most contexts; prefer change as the shorter canonical form. Keep modify where a change is deliberate and scoped, for example modifying a configuration parameter."
    },
    {
      "id": "obtain-item",
      "meaning": "come into possession of an item or value",
      "preferred": "obtain",
      "avoid_for_same_meaning": [
        "get"
      ],
      "note": "Prefer obtain in technical and formal text. Get is acceptable in runbooks and casual guidance. Do not use fetch or retrieve as stylistic substitutes when those words denote specific operations (for example network retrieval)."
    },
    {
      "id": "select-option",
      "meaning": "choose one item from a set of alternatives",
      "preferred": "select",
      "avoid_for_same_meaning": [
        "choose"
      ],
      "note": "Prefer select in UI and API contexts where an option is picked from a defined set. Choose is acceptable in user guidance when the set is open-ended."
    },
    {
      "id": "additional-item",
      "meaning": "an item added to what already exists",
      "preferred": "additional",
      "avoid_for_same_meaning": [
        "extra"
      ],
      "note": "Prefer additional in technical text. Extra is acceptable in informal guidance."
    },
    {
      "id": "show-information",
      "meaning": "present information visibly or in an interface",
      "preferred": "show",
      "avoid_for_same_meaning": [
        "display"
      ],
      "note": "Show and display are interchangeable in most UI prose; prefer show as the shorter canonical form. Keep display where a dedicated display component or device is meant."
    },
    {
      "id": "occur-time",
      "meaning": "happen at a time or in a process",
      "preferred": "occur",
      "avoid_for_same_meaning": [
        "happen"
      ],
      "note": "Prefer occur in technical and formal text. Happen is acceptable in casual prose."
    },
    {
      "id": "remove-item",
      "meaning": "take an item away from a set, list, or system",
      "preferred": "remove",
      "note": "Do not treat remove and delete as interchangeable. Delete implies permanent erasure; remove can mean detaching or taking out of a list. Keep the distinction where permanence matters. Delete is therefore not listed as an avoided synonym."
    },
    {
      "id": "create-item",
      "meaning": "bring an item into existence",
      "preferred": "create",
      "avoid_for_same_meaning": [
        "generate"
      ],
      "note": "Create is the general term. Keep generate where output is produced from inputs or algorithms, for example generate a report or generate a key."
    },
    {
      "id": "make-item",
      "meaning": "produce an item by work or action",
      "preferred": "make",
      "note": "Make and create are close; prefer create for new artifacts and make for adjustments or informal construction. The boundary is subtle.",
      "review": true
    },
    {
      "id": "assist-action",
      "meaning": "help a person or process achieve a result",
      "preferred": "help",
      "avoid_for_same_meaning": [
        "assist"
      ],
      "note": "Help and assist are interchangeable; prefer help as the shorter form. Assist is acceptable where a formal support process is meant."
    },
    {
      "id": "request-action",
      "meaning": "ask for an action, item, or decision",
      "preferred": "request",
      "avoid_for_same_meaning": [
        "ask"
      ],
      "note": "Prefer request in API and procedural text where a formal exchange is described. Ask is acceptable in user-facing guidance."
    },
    {
      "id": "state-fact",
      "meaning": "express a fact, condition, or intention clearly",
      "preferred": "state",
      "avoid_for_same_meaning": [
        "indicate"
      ],
      "note": "State is the general term for expressing facts. Keep indicate where a signal or display points to a value without asserting it directly."
    },
    {
      "id": "contain-items",
      "meaning": "hold items within a container or structure",
      "preferred": "contain",
      "note": "Contain describes what is held; include can describe a non-exhaustive subset. The boundary is subtle and needs human confirmation.",
      "review": true
    },
    {
      "id": "avoid-word",
      "meaning": "keep away from a value, condition, or behavior",
      "preferred": "avoid",
      "note": "Avoid and prevent are not synonyms. Avoid means steering clear; prevent means stopping something from happening. Keep the distinction; prevent is therefore not listed as an avoided synonym."
    },
    {
      "id": "stop-action",
      "meaning": "cause an action or process to cease",
      "preferred": "stop",
      "avoid_for_same_meaning": [
        "halt"
      ],
      "note": "Stop is the general term. Halt implies an abrupt or operator-initiated stop; keep it where that connotation is intended. See also end-process for finish/terminate."
    },
    {
      "id": "complete-process",
      "meaning": "finish a process so that it is fully done",
      "preferred": "complete",
      "avoid_for_same_meaning": [
        "finalize"
      ],
      "note": "Complete describes reaching the end state. Finalize implies a decision or approval step that locks the result; keep the distinction where that step exists."
    },
    {
      "id": "compare-items",
      "meaning": "examine two or more items to identify similarities or differences",
      "preferred": "compare",
      "note": "Compare and contrast are not synonyms. Compare examines similarities and differences; contrast emphasizes differences only. Keep the distinction; contrast is therefore not listed as an avoided synonym."
    }
  ]
}
