> For the complete documentation index, see [llms.txt](https://docs.snomed.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-mapping-guide/map-development/6.2-authoring.md).

# Authoring

Authoring is the process of defining the relationship between concepts in the source code system and the target code systems.

Authors can assign none, one, or more target codes to a source code and assign a relationship type.

When assigning a target code, authors need to consider the map's use case and purpose, as well as the code system's structure, rules, term composition, and granularity.

## Automated mapping tools

Once data has been pre-processed, automated mapping tools may be useful.&#x20;

* **Automated mapping** is the use of computer algorithms to create mappings between code systems.&#x20;
* **Lexical mapping** is the process of comparing and analyzing the structure of words in a clinical term to determine whether they are the same, similar, or different, and is often incorporated into automatic mapping.

Maps generated by a tool need to be checked by a map specialist. Significant care must be taken with automated mapping, as severe errors can result if not done in a controlled manner.&#x20;

Automated mapping, in conjunction with human review (and manual remapping where necessary), is likely to achieve better results than automated mapping alone.

Appropriate filters or scope constraints should be applied to the tool to improve the accuracy of the automated mapping tools. A record of the tool, the scope constraint and matches should be kept to test the reproducibility of methods

## Manual/human mapping

Human mapping is the use of human knowledge and skill to author maps. Each map is built singularly. The process requires examination of each and every concept in the coding system. Informed judgments or decisions are made about the shared meaning of concepts. Electronic or computational tools may be used, but only in support of the work process.

There are some tools available to assist in this process. Manually mapping into tables without tooling support (e.g., spreadsheets) is time-consuming and error-prone because it requires copying and pasting from a browser into the table.

## Editorial guidelines

Defining firm guidelines for mappers will save time and go a long way towards ensuring higher inter-rater reliability in situations with more than one mapper. These guidelines will also be valuable for highlighting why certain target concepts were chosen over others. Editorial Guidelines are very important to map users and are a necessary step in the creation of useful, reliable, and usable maps.

Also, a map is not necessarily static; future versions of a map may require changes to decisions or rules, which need to be clearly defined and applied consistently.

{% hint style="success" %}
Organising your terms by grouping together terms of a similar nature, for example, all terms referring to fractures together, all the diabetes terms together, can make the mapping process easier and aid in the consistency of the maps. Once this is done, also consider if the source code system contains terms that might be considered “synonyms” or duplicates of other terms.
{% endhint %}

{% hint style="info" %}
It may be possible to request new content from the code system suppliers (e.g. SNOMED International) to deliver a better map
{% endhint %}

<a href="https://docs.google.com/forms/d/e/1FAIpQLScTmbZIf0UEQwYDkY27EEWBkaiYkHSbR0_9DmFrMLXoQLyL7Q/viewform?usp=pp_url&#x26;entry.1767247133=Mapping+Guide&#x26;entry.670899847=Authoring" class="button primary">Provide Feedback</a>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-mapping-guide/map-development/6.2-authoring.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
