# Feature FND-298 - Document multiple categories for admins, users and API clients

Project: Stream workspace foundations
Status: new
URL: https://community.openproject.org/work_packages/FND-298

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 18.1.0 |
| Sprint |  |
| Backlog bucket |  |
| Votes |  |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

_No work packages_

## Bugs and other work packages

_No work packages_

## Technical Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Feature Flag |  |
| Requires doc change | No |
| Enterprise plan |  |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Feature Lead |  |
| Developers |  |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

Write the documentation for the change from "Category" to "Categories".

\*\*Acceptance criteria\*\*

\*   The API documentation describes \`\_links.categories\`. It explains that \`\_links.category\` works only until the admin switch, and that a request with \`category\` fails with an error after the switch. It has a migration section for API clients.  
\*   The system admin guide describes the switch on \_Versions and categories\_, the one-way behavior and the environment variable.  
\*   The user guide describes the multi-select field, the filter, grouping, bulk edit, the default assignee rule, the CSV import and the incoming e-mail syntax.  
\*   The "More information" link on the admin page points to the new documentation (\`config/static\_links.yml\`).

\*\*Technical notes\*\*

*   Analog: <mention class="mention" data-id="COMMS-906" data-type="work_package" data-text="#COMMS-906">#COMMS-906</mention>, <mention class="mention" data-id="COMMS-951" data-type="work_package" data-text="#COMMS-951">#COMMS-951</mention>.
