# Recommended workflow and typical cases

The component currently translates content (articles and categories) automatically whenever content is saved in the source language or explicitly assigned to it.

The detection runs on menu item and category level. This means that only menu items that are assigned to the source language, or saved within that language, will be added to the translation queue and will be translated automatically.

The same applies to categories and articles: translations are only triggered for categories assigned to the source language, or for articles that belong to a category assigned to the source language.

Our goal is to create the most sensefull and reliable result possible for translations, category relationships, and menu assignments.

### Recommended workflow

{% hint style="success" %}
To achieve the best possible workflow, all categories should first be created in the source language or assigned to it and therefore translations should be created.
{% endhint %}

This is especially important for existing single-language Joomla setups that are being converted into multilingual websites.

If an article is assigned to the source language, but its category is not assigned to the source language, no translation process will be triggered.

### Typical cases and behavior

| Scenario                                                                                                                     | Result                                                                                                                                           |
| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Category is assigned to the source language                                                                                  | Category translation is created correctly                                                                                                        |
| Article is assigned to the source language and category is also assigned to the source language                              | Article translation is created correctly                                                                                                         |
| Article is assigned to the source language but category is not assigned to the source language                               | No translation is triggered                                                                                                                      |
| Menu item (assigned to source language) type **Category Blog / Category List** with category not assigned to source language | New menu item is created in target menu, but keeps the original category assignment                                                              |
| Menu item (assigned to source language) type **Category Blog / Category List** with category assigned to source language     | New menu item is created in target language with correct translated category assignment (as the associated category has already been translated) |
| Menu item type **Single Article** with article in source language but category language set to **All**                       | Target menu item may still point to the untranslated source language article, causing incorrect assignments                                      |

### Category Blog / Category List with correct source language category

If a menu item of type **Category Blog** or **Category List** is connected to a category that is assigned to the source language, the system can create a proper translation relationship.

A new menu item will be created in the target language and automatically create an assignment to the corresponding translated category.

This is the recommended and expected setup.

### Category Blog / Category List menu items with assigned category missing language assignment

If a menu item of type **Category Blog** or **Category List** is connected to a category that is not assigned to the source language, the menu item will still be translated.

A new menu item will be created in the target menu, but it will keep the exact same category assignment as the source language version.

This means the translated menu item may still point to the original category instead of the translated one.

### Single Article menu items

If a menu item of type **Single Article** points to an article in the source language, but the article belongs to a category with language set to **All**, the translated menu item may be created incorrectly.

In this case, the target language menu item may still point to the untranslated source language article.

{% hint style="danger" %}
Attention: This leads to broken language assignments and should be avoided.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://joomtastic.gitbook.io/joomtastic-docs/translate-content/recommended-workflow-and-typical-cases.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.