About text blocks

• A text block may comprise one or more sentences, paragraphs, or lines, and may include embedded elements such as tables, figures, or quotations.
• A text block is context-dependent, meaning its interpretation is influenced by surrounding content and the larger work.
• Text blocks may be assigned identifiers, labels, or positions to facilitate management, reuse, or citation.
• Text blocks may be versioned or modified independently, supporting content reuse, revision tracking, or modular publishing.

Distinction or terms from related entities

• Text block vs work item: a text block is primarily a contiguous content segment; a work item is a structural or addressable unit of a work. A work item may contain multiple text blocks.
• Text block vs quotation or paraphrase: a text block may contain quotations or paraphrases but is defined by its continuity rather than source fidelity.
• Text block vs concept or term: a text block is material content; a concept is an abstract idea and a term is a linguistic label.

Text block metadata

1. Block title: a short name for the block that is also used for the shortcut key
2. Block type (e.g., honorific, snippet, boilerplate. biography, prompt)
3. Jurisdiction: the country that the work was produced in
4. 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
5. 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')
6. Language: designate which language this concept has been added using (e.g., English)
7. Note: add any other information that is relevant (e.g., a guidance note on the use of this concept)

Relationships

1. 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
2. Collections: tags that identify what collection(s) you have used this term in
3. Documents: tags that identify what document(s) you have used this term in

Authority & Source

1. 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
2. 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 block has been added in multiple places and needs updating, you can do so by editing the record and it will automatically update all instances
• You can 'lock' a block by changing it's effective date and/or marking it as deprecated (thereby terminating its use) and create a new version for future use.

See also

• Adding a collection of terms
• Exporting a collection of terms
• Annotations / Add terms
• Style Guide / Terminology smart lists