**As** a Begin of the insertionuserEnd of the insertion Begin of the deletion \[enter role of user\]End of the deletion
**I want to** Begin of the insertionto be able to create internal comments and mentions easilyEnd of the insertion Begin of the deletion \[enter objective\]End of the deletion
**so that** Begin of the insertionI don't switch to web app to react to commentsEnd of the insertion Begin of the deletion \[enter desired result\]End of the deletion

Begin of the insertion**Background**End of the insertion Begin of the deletion **Acceptance criteria**End of the deletion

* Begin of the insertionThe API forEnd of the insertion Begin of the deletion We needEnd of the deletion internal comments Begin of the insertionwas missing but now has been merged underEnd of the insertion Begin of the deletion inEnd of the deletion the Begin of the insertionwork package <mention class="mention" data-id="64694" data-type="work_package" data-text="###64694">###64694</mention>.End of the insertion Begin of the deletion mobile app.End of the deletion

* Begin of the insertionMultiple users have reported that theEnd of the insertion Begin of the deletion TheEnd of the deletion comment field is Begin of the insertiontoEnd of the insertion Begin of the deletion veryEnd of the deletion small Begin of the insertionand the mentioning process confusing&nbsp;


**Acceptance criteria**

End of the insertion Begin of the deletion for multiple users.

End of the deletion * Begin of the insertion**Internal comments:**

* Allow the creation of internal comments including a new button on the text edit tool bar with a locker.

* Once the user selects the locker to make the comment internal, the background of theEnd of the insertion Begin of the deletion The add mentionEnd of the deletion bottom sheet Begin of the insertionuses the yellow colour of internal comments and the lock IconButtonEnd of the insertion is Begin of the insertionmarked as selected.

* Make sure that once the comment is submitted only the relevant persons can see them.

* Only users with permissions to write internal comments should see the lock icon on the toolbar.

* Users without permissions to write internal comments will see the # button instead of the lock.

* **UI improvements of the toolbar:**

* The tool bar is reduced in mobile to less actions and no longer scrolls. The visible actions are:

* Text options:

* Bold

* Italic

* List

* Other options (after a divider):

* Mention

* Lock

* More actions under a three dots menu (after a divider):

* Strike

* Attach image

* Link work package

* Add link (URL)

* Code

* Numbered list

* To-do list

* Full screen

* Undo

* Redo

* On theEnd of the insertion very Begin of the insertionright corner a send button in primary scheme.

* **UI improvements of the comment box:**

* When the full screen mode is selected the bottom sheet should expand until the top of the screen and the action on the toolbar switch to Compact view with the icon to reduce size.

* The bottom sheet no longer has a border box input field with the comment label, but rather a clean white spaceEnd of the insertion Begin of the deletion intrusive, propose something like JiraEnd of the deletion where Begin of the insertionthe user can type

* The bottom sheet should increase its size (in compact view) as soon as more lines are added to the comment. Once thereEnd of the insertion Begin of the deletion mentionEnd of the deletion is Begin of the insertionno more space in the screen the user can scroll the internal comment content.

* **Improvements on the mentioning and link work package system:**

* When the user triggers either the mentioning or the link work package from the keyboard or toolbar button that will no longer open a separate bottom sheet.

* A menu will appear just on top of the bottom sheet once the user starts typing showing the matching results.

* The text on the comment field should serve to filter the results.

* **UI improvements of long text fields:**

* All long text fields will open in a full screen modal that will no longer has a border box input field with the comment label, but rather a clean white space where the user can type.

* The button on the toolbar is not a sending icon but rather a confirm button.

* Users can always cancel the edit through the close X on the top bar.


End of the insertion Begin of the deletion inline.


End of the deletion **Technical notes**

* API work: <mention class="mention" data-id="64694" data-type="work_package" Begin of the insertiondata-text="###64694">###64694</mention> End of the insertion Begin of the deletion data-text="###64694">###64694</mention>&nbsp;End of the deletion


**Permissions and visibility considerations**

* Only users with permissions to see and write internal comments should see them.


**Out of scope**

* <br>