About work items
A work item is a discrete, identifiable unit of content that is part of a larger work and is treated as an addressable component for reference, management, or reuse.
- A work item may represent structural divisions (e.g., chapter, section, clause, article) or logical units (e.g., provision, paragraph, figure, table).
- A work item is context-dependent; its meaning and interpretation derive from its position within the parent work.
- A work item may be associated with identifiers (e.g., numbering, labels), sequence or hierarchy, and version or temporal validity.
- A work item may contain or be linked to textual content, quotations, definitions, or references.
This definition aligns with ISO 704 and ISO 1087-1 terminology principles and with structural models used in legal drafting, publishing, and document management systems.
Distinction or terms from related entities
- Work item vs work: a work is the complete intellectual creation; a work item is a component of that work.
- Work item vs concept: a work item is a content unit; a concept is an abstract unit of knowledge.
- Work item vs event: a work item is a static content component; an event occurs in time.
Work item metadata
- Item type (e.g., clause, paragraph, standard, section)
- Item locator: where the item can be found within the larger work (e.g., cl 5, s 8, ch 9)
- Description of item (e.g., sub-heading where the item is found; or a short description of its content)
- Domain: or discipline this item belongs to or is associated with
- Jurisdiction: the country that the larger work was produced in
- Role: Select how you intend to use this concept:
- Preferred: primarily the one to use
- Admitted: a variety of this same terms
- Deprecated: this concept is no long er in use
- Status: Identify the status of adding this concept
- Draft: needs more info
- Under review: by another person
- Approved for use but not yet published
- Published and available
- There is a wide variety of status stages (see also 'Terminology workflow')
- Language: designate which language this concept has been added using (e.g., English)
- Note: add any other information that is relevant (e.g., a guidance note on the use of this concept)
Relationships
Work items can have a range of relationships with other records:
- Relationships with specific records (e.g., concepts, terms, or organization names):
- Select the relationships type and use a shortcut key to tag another term to link them together
- Collections: tags that identify what collection(s) you have used this term in
- Documents: tags that identify what document you have used this term in
Authority & Source
- Authority refers to an organization of group that provided evidence for the use of this term (e.g., judicial, government, published)
- Authority type: select the type of entity that provided authority for this term to exist
- Add the description of the authority or use the shortcut key to select the an existing person or oganization from your terminology data
- Source refers to the external documentary evidence you used for compiling this record
- The title of the reference work that contains this evidence (the work should be in your reference library)
- Use the backslash key and enter the title to link the reference record
- Open the library record for this source by clicking the library icon
- Add a new reference record to your library by clicking the + icon
Tips
- Create different collections for easy maintenance, exporting, or sharing
- We do not produce a list of work items, quotes, paraphrase, text blocks or websites as these are generally not required when writing documents.
- You can export any collection in full directly from the collection record
- If an abbreviation has been added in multiple places and needs updating, you can do so by editing the form and it will automatically update all instances
See also
- Adding a collection of terms
- Exporting a collection of terms
- Annotations / Add terms
- Style Guide / Terminology smart lists