Terrain

Change, Discuss and Retire a Term

Propose a change to an agreed Terrain dictionary term, agree or turn it down, ask questions on a term, watch it, move it under another parent, and retire or delete it.

Propose a change

  1. Open the agreed term and click Propose A Change. The editor opens with a note that your edit becomes a proposed change.
  2. Make the edit.
  3. In Why This Should Change, say why. The owner sees it next to the change. It is required unless you are the owner and only changing ownership.
  4. Click Propose Change.

The term keeps its agreed text. A Proposed change banner shows your reason, who proposed it, and a table of each changed part with Agreed now and Proposed side by side. Only one change can wait on a term at a time: editing the term again opens the waiting change, and saving revises it.

Agree or turn down a change

The owner sees the change in Waiting on you as Review change.

  • Agree Change applies it and saves the next version to History.
  • Turn Down discards it and leaves the agreed text unchanged.
  • The person who proposed it can click Withdraw instead.

Ask a question

  1. Under Discussion, write your post.
  2. Tick This is a question for the owner. If you are the owner, choose who the question is for.
  3. Click Post.

A question waits in that person's Waiting on you list until it is settled. To settle it, enter what was decided in the box under the question and click Settle. The person asked, the person who asked, or the owner can settle it.

Watch a term

Click Tell me when this changes. The button changes to Watching this term, and proposed changes to the term appear in your Waiting on you list. Click it again to stop watching.

Move a term

Use Move in the Ownership panel to put a term under a different parent, or make a variant a term of its own.

  1. Click Move and pick where it goes in Move to. The dialog previews what the term will inherit.
  2. Enter Why. It is required for an agreed term and recorded in its history.
  3. Click Move Term.

Rules: only the owner can move an agreed term; a term with variants of its own cannot become a variant; a term with a change waiting cannot be moved until the change is agreed or turned down; an agreed term can only move under an agreed parent.

Retire or delete

  • Retire (agreed terms, owner only): enter why it is being retired and, optionally, the term that replaces it, then click Retire Term. The term stays readable with a "This term has been retired" note and a link to its replacement, and can no longer be edited.
  • Delete (terms that were never agreed): available to the owner or the person who added it. Delete a term's variants first.

Troubleshooting

MessageCause
Nothing differs from the agreed version, so there is nothing to propose.Your edit matches the agreed text
A retired term cannot be edited.Add a new term instead
An agreed term cannot be deleted, because reports may already depend on it. Retire it instead.Use Retire
A change to this term is waiting to be agreed.Agree or turn down the change before moving the term