Skip to Content
LanguageGeneral Language

General Language

FTL controls general vocabulary only where doing so removes demonstrated or likely ambiguity. It does not prohibit words that carry a useful semantic distinction. This page is the human-readable view of the machine-readable vocabulary at /api/latest/general-language.json.

Each entry records one preferred general word and the words that should not be used when the same meaning is intended. If two words carry a real technical distinction, the note explains it instead of prohibiting one.

The general-language vocabulary is intentionally small. It does not replace the domain terminology on the Terminology pages, and it is not a complete English dictionary.

24 entries in total. Entries marked for review are candidates that still require human semantic confirmation.

Controlled vocabulary

Controlled vocabulary

start

Meaningbegin execution of an operation or process

Avoid for the same meaningbegincommence

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).

use

Meaningemploy a resource, tool, or mechanism for a purpose

Avoid for the same meaningutilize

Note: Utilize adds no meaning over use in ordinary technical prose. Keep utilize only when emphasizing an unexpected or non-obvious application.

approximately

Meaningan amount or value that is not exact

Avoid for the same meaningroughly

Note: Prefer approximately in normative or measured contexts. Roughly is acceptable in informal notes. If an exact figure exists, state it instead.

perform

Meaningcarry out an action or operation

Avoid for the same meaningdo

Note: Do is acceptable in runbooks and casual text; prefer perform when the action is a named operation with defined steps.

ensure

Meaningmake certain that a condition holds

Avoid for the same meaningmake sure

Note: Prefer ensure in normative and technical text. Make sure is acceptable in user guidance. Where a mechanism guarantees the condition, prefer guarantee.

provide

Meaningmake an item or capability available to someone or something

Avoid for the same meaningsupply

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).

end

Meaningbring an operation or process to a close

Avoid for the same meaningterminate

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.

change

Meaningmake a value, configuration, or behavior different

Avoid for the same meaningmodify

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.

obtain

Meaningcome into possession of an item or value

Avoid for the same meaningget

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).

select

Meaningchoose one item from a set of alternatives

Avoid for the same meaningchoose

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.

additional

Meaningan item added to what already exists

Avoid for the same meaningextra

Note: Prefer additional in technical text. Extra is acceptable in informal guidance.

show

Meaningpresent information visibly or in an interface

Avoid for the same meaningdisplay

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.

occur

Meaninghappen at a time or in a process

Avoid for the same meaninghappen

Note: Prefer occur in technical and formal text. Happen is acceptable in casual prose.

remove

Meaningtake an item away from a set, list, or system

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.

create

Meaningbring an item into existence

Avoid for the same meaninggenerate

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.

help

Meaninghelp a person or process achieve a result

Avoid for the same meaningassist

Note: Help and assist are interchangeable; prefer help as the shorter form. Assist is acceptable where a formal support process is meant.

request

Meaningask for an action, item, or decision

Avoid for the same meaningask

Note: Prefer request in API and procedural text where a formal exchange is described. Ask is acceptable in user-facing guidance.

state

Meaningexpress a fact, condition, or intention clearly

Avoid for the same meaningindicate

Note: State is the general term for expressing facts. Keep indicate where a signal or display points to a value without asserting it directly.

avoid

Meaningkeep away from a value, condition, or behavior

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.

stop

Meaningcause an action or process to cease

Avoid for the same meaninghalt

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.

complete

Meaningfinish a process so that it is fully done

Avoid for the same meaningfinalize

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.

compare

Meaningexamine two or more items to identify similarities or differences

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.

Review

Candidates for human review

make

Review

Meaningproduce an item by work or action

Note: Make and create are close; prefer create for new artifacts and make for adjustments or informal construction. The boundary is subtle.

contain

Review

Meaninghold items within a container or structure

Note: Contain describes what is held; include can describe a non-exhaustive subset. The boundary is subtle and needs human confirmation.

Last updated on