* Administration: there are new role permissions:

* View Begin of the insertioninternalEnd of the insertion comments Begin of the deletion with restricted visibilityEnd of the deletion

* Write Begin of the insertioninternalEnd of the insertion comments Begin of the deletion with restricted visibilityEnd of the deletion

* Edit own Begin of the insertioninternalEnd of the insertion comments Begin of the deletion with restricted visibilityEnd of the deletion

* Edit others' Begin of the insertioninternalEnd of the insertion comments Begin of the deletion with restricted visibilityEnd of the deletion (for moderation)

* When I write a comment, I can choose to Begin of the insertionmake it internalEnd of the insertion Begin of the deletion restrict its visibilityEnd of the deletion

* There is a checkbox to enable this

* There is a "More info" button that takes the user to the documentation of the feature.

* The background colour of the comment box will change the to same colour as top info line of Begin of the insertionInternalEnd of the insertion Begin of the deletion restricted-visibilityEnd of the deletion comments in the Activity stream to reassure the user that this mode is indeed active with a clear visual signal.

* [Primer colours](https://primer.style/foundations/color/base-scales) to use:

* **Background info line:** `display-brown-bgColor-muted`

* **Background body**: `bgColor-default`

* **Text:** `fgColor-default`

* **Outline:** `display-brown-borderColor-emphasis`

* These colours will automatically adjust to dark mode (Primer feature)

* If a comment is Begin of the insertioninternal,End of the insertion Begin of the deletion restricted-visibility,End of the deletion it is easily distinguishable from other comments (that are public) so I can be reassured that they can't be publicly visible.

* Begin of the insertionInternalEnd of the insertion Begin of the deletion Restricted-visibilityEnd of the deletion comments appear in a different colour scheme (defined above)

* There is a lock icon on the top right corner to the left of the More icon.

* There is an alt text: "Only visible to a limited group of members."

* _This will eventually show a Primer tooltip and lead to the Members page on click. See out of scope._

* If there is also an unread badge, this will appear to the _left_ of the lock icon

* Normal (public) comments with _not_ have an unlocked icon

* Quoting is possible. However, when quoting a Begin of the insertioninternal comment,End of the insertion Begin of the deletion comment with restricted visibility,End of the deletion that comment must also be confidential by default

* The Begin of the insertion'Internal comment'End of the insertion Begin of the deletion 'Restrict visibility'End of the deletion checkbox is checked

* _Risk: the user inadvertently some how unchecks this but leaks the comment. But they could just also well copy/paste a Begin of the insertioninternalEnd of the insertion Begin of the deletion restrictedEnd of the deletion comment._

* This is to limit the risk of accidental/inadvertent leaking of the comment.

* Notifications: Begin of the insertioninternalEnd of the insertion Begin of the deletion restricted visibilityEnd of the deletion comments will also appear in the notification center just like comments if I have access to them

* Same with email notifications

* It should not be possible to _@mention_ users who will not be able to view Begin of the insertionthe internal commentEnd of the insertion Begin of the deletion the comment with restricted visibiltyEnd of the deletion (i.e, the drop-down needs to exclude users without the requisite permissions)

* If a user who does not have the permissions to view Begin of the insertionInternalEnd of the insertion Begin of the deletion restricted-visibilityEnd of the deletion comments is mentioned in a regular comment and the Begin of the insertion'Internal comment'End of the insertion Begin of the deletion 'Restrict visibility'End of the deletion checkbox is _then_ checked, the @mention is turned into plain text.

* Unchecking the Begin of the insertion"Internal comment"End of the insertion Begin of the deletion "Restrict visibility"End of the deletion checkbox will _not_ re-convert previously stripped @mentions back to links.

* If were part of a role that afforded you the ability to view Begin of the insertioninternalEnd of the insertion Begin of the deletion restricted visibilityEnd of the deletion comments and you are subsequently removed from this role such that you no longer have this permission:

* You can no longer view or post such comments in the Activity tab

* The Notification centre should not break (because it can no longer find the missing notification)

* The notifications will stop, but for unread and past notifications:

* Begin of the insertionInternal commentsEnd of the insertion Begin of the deletion Restricted visibilty commentsEnd of the deletion are now hidden

* No other changes (to # of notifications, badges...)

* _Risk: Any email notification sent cannot obviously be retracted._

* There is no visible numbering of activity comments anymore for all comments Begin of the insertion(internal orEnd of the insertion Begin of the deletion (restricted visibilty orEnd of the deletion otherwise),

* Ideally, old links with `#activity-<comment-number>` still work.

* Copying the URL of a comment will have a new URL scheme including a real, persistent ID and not a generated number anymore so that it stays the same even when other comments are added or removed from the activity, e.g. #comment-&lt;journal-id&gt;

* When that URL is opened the browser will auto-scroll to have the comment in the visible viewport.

* When there is not Enterprise token, or the token does not allow this feature:

* We still show the permissions in the role administration and leave them editable.

* We don&#39;t show the toggle/checkbox to make a new comment a Begin of the insertioninternalEnd of the insertion Begin of the deletion restrictedEnd of the deletion comment.

* We show a banner at the project setting for enabling the feature.

* Begin of the insertioninternalEnd of the insertion Begin of the deletion Restricted visibilityEnd of the deletion comments can be enabed/disabled at a project level

* There will be in a new tab called &#39;Activity&#39; in the new consolidated &#39;Work packages&#39; page in Project settings.

* In this tab, there is a single checkbox with:

* Label: &quot;Enable Begin of the insertioninternalEnd of the insertion Begin of the deletion restricted visibilityEnd of the deletion comments&quot;

* Caption: Begin of the insertion&quot;internalEnd of the insertion Begin of the deletion &quot;RestrictedEnd of the deletion comments allow an internal team to communicate amongst themselves privately. These are only visible to select roles that have the necessary permissions and will not be visible publicly. Read more.&quot;

* The &quot;Read more&quot; is a link that links to the documentation for this feature. Begin of the insertion


<br>


End of the insertion Begin of the deletion


End of the deletion **Mobile specificities**

* On narrow screens, Begin of the insertioninternal comments onEnd of the insertion Begin of the deletion comments with restricted onEnd of the deletion the timeline are displayed the same way as the mobile rendering of normal comments, but with the additional elements:

* Different background colours

* The lock icon

* When writing a comment, the Begin of the insertion&quot;Internal comment&quot;End of the insertion Begin of the deletion &quot;Restrict visibilty&quot;End of the deletion action uses the same string, but the &#39;Reed more&#39; link is hidden


**Permissions and visibility considerations**

* The &#39;Last updated&#39; field will be updated when Begin of the insertionan internal commentEnd of the insertion Begin of the deletion a restricted-visibility commentEnd of the deletion is posted; even users who do _not_ have the permissions to view them will see that something has changed, but will be unable to see what that is.

* Relevant: ##62473

* It is important the visibility of Begin of the insertionInternalEnd of the insertion Begin of the deletion restricted-visibilityEnd of the deletion comments is also permission-controlled in other places where Activity is reported:

* Project activity

* User activity


**Translation considerations**

* Action: Begin of the insertion&quot;Internal comment&quot;End of the insertion Begin of the deletion &quot;Restrict visibility&quot;End of the deletion

* DE: Begin of the insertion&quot;&quot;End of the insertion Begin of the deletion &quot;Sichtbarkeit einschränken&quot;End of the deletion

* FR: Begin of the insertion&quot;Commentaire interne&quot;End of the insertion Begin of the deletion &quot;Restreindre la visibilité&quot;End of the deletion

* ES: Begin of the insertion&quot;&quot;End of the insertion Begin of the deletion &quot;Restringir visibilidad&quot;End of the deletion

* Feature name: Begin of the insertion&quot;InternalEnd of the insertion Begin of the deletion &quot;Restricted-visibilityEnd of the deletion comments&quot;

* DE: Begin of the insertion&quot;&quot;End of the insertion Begin of the deletion &quot;Restricted-visibility comments&quot;End of the deletion

* FR: &quot;Commentaires Begin of the insertioninternes&quot;End of the insertion Begin of the deletion à visibilité restreinte&quot;End of the deletion

* ES: Begin of the insertion&quot;&quot;End of the insertion Begin of the deletion &quot;Comentarios con visibilidad restringida&quot;End of the deletion

* Permission: &quot;View Begin of the insertioninternal comments&quot;End of the insertion Begin of the deletion comments with restricted visibility&quot;End of the deletion

* DE: Begin of the insertion&quot;&quot;End of the insertion Begin of the deletion ?End of the deletion

* FR: &quot;Lire des commentaires Begin of the insertioninternes&quot;End of the insertion Begin of the deletion à visibilité restreinte&quot;End of the deletion

* ES: Begin of the insertion&quot;&quot;End of the insertion Begin of the deletion &quot;Vista de los comentarios con visibilidad restringida&quot;End of the deletion