> For the complete documentation index, see [llms.txt](https://manual-v2.firstresonance.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual-v2.firstresonance.io/production/procedures/backwards-compatibility-considerations.md).

# Backwards Compatibility Considerations

This guide outlines the steps to effectively roll out the new procedures module in the Ion Experience while ensuring compatibility and functionality.

#### Key Steps

### **1. Understanding New Functionality**

![generated-image-at-00:00:00](https://loom.com/i/e65cff2afe4246dfbf12bd1eccbf6be8?workflows_screenshot=true)

* Familiarize yourself with the new content editor features:
  * To-do lists
  * Markdown headers
  * Table functionality (colored cells, merging, adding/removing cells, borders, splitting cells)
  * Toggles for hidden content
  * Code blocks for various coding languages
  * Block quotes and callouts with emojis
  * Table of contents driven by headers
  * Date and function capabilities.

### **2. Compatibility Awareness**

![generated-image-at-00:01:11](https://loom.com/i/c3d0f2a1d34543ff9e731ef28de5be11?workflows_screenshot=true)

* Recognize that the new features are only applicable in the new Ion Experience.
* Understand that content will not render correctly in the old Ion Experience:
  * To-do lists will not appear as checklists.
  * Headers will not format correctly.
  * Tables will lack proper merging and coloring.
  * Toggles will not function.
  * Code blocks, block quotes, callouts, table of contents, dates, and equations will be absent.

### **3. Timing for Implementation**

![generated-image-at-00:01:51](https://loom.com/i/7641f6dae31848768986b2477cadc8f5?workflows_screenshot=true)

* Avoid using the new functionality until both the procedures and run modules are rolled out in the new Ion Experience.

#### Cautionary Notes

* Ensure all team members are aware of the differences between the old and new Ion Experiences to prevent confusion.
* Do not attempt to use new features in the old Ion Experience as it may lead to errors and miscommunication.

#### Tips for Efficiency

* Schedule a training session for team members to familiarize them with the new features before rollout.
* Create a checklist of new functionalities to ensure all team members are utilizing them effectively after the rollout.

{% embed url="<https://loom.com/share/9381d2caf8df4273a37f037cab2fc2cc>" %}


---

# 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://manual-v2.firstresonance.io/production/procedures/backwards-compatibility-considerations.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.