Commit a30417e5 authored by Achilleas Pipinellis's avatar Achilleas Pipinellis

Merge branch 'docs-image-discussion' into 'master'

Add image discussion docs

Closes #38879

See merge request gitlab-org/gitlab-ce!14743
parents c734bd01 694fec5c
...@@ -153,6 +153,43 @@ comments in greater detail. ...@@ -153,6 +153,43 @@ comments in greater detail.
![Discussion comment](img/discussion_comment.png) ![Discussion comment](img/discussion_comment.png)
## Image discussions
> [Introduced][ce-14531] in GitLab 10.1.
Sometimes a discussion is revolved around an image. With image discussions,
you can easily target a specific coordinate of an image and start a discussion
around it. Image discussions are available in merge requests and commit detail views.
To start an image discussion, hover your mouse over the image. Your mouse pointer
should convert into an icon, indicating that the image is available for commenting.
Simply click anywhere on the image to create a new discussion.
![Start image discussion](img/start_image_discussion.gif)
After you click on the image, a comment form will be displayed that would be the start
of your discussion. Once you save your comment, you will see a new badge displayed on
top of your image. This badge represents your discussion.
>**Note:**
This discussion badge is typically associated with a number that is only used as a visual
reference for each discussion. In the merge request discussion tab,
this badge will be indicated with a comment icon since each discussion will render a new
image section.
Image discussions also work on diffs that replace an existing image. In this diff view
mode, you can toggle the different view modes and still see the discussion point badges.
| 2-up | Swipe | Onion Skin |
| :-----------: | :----------: | :----------: |
| ![2-up view](img/two_up_view.png) | ![swipe view](img/swipe_view.png) | ![onion skin view](img/onion_skin_view.png) |
Image discussions also work well with resolvable discussions. Resolved discussions
on diffs (not on the merge request discussion tab) will appear collapsed on page
load and will have a corresponding badge counter to match the counter on the image.
![Image resolved discussion](img/image_resolved_discussion.png)
## Lock discussions ## Lock discussions
> [Introduced][ce-14531] in GitLab 10.1. > [Introduced][ce-14531] in GitLab 10.1.
...@@ -163,8 +200,8 @@ in issues or merge requests in these scenarios: ...@@ -163,8 +200,8 @@ in issues or merge requests in these scenarios:
- The project maintainer has already resolved the discussion and it is not helpful - The project maintainer has already resolved the discussion and it is not helpful
for continued feedback. The project maintainer has already directed new conversation for continued feedback. The project maintainer has already directed new conversation
to newer issues or merge requests. to newer issues or merge requests.
- The people participating in the discussion are trolling, abusive, or otherwise - The people participating in the discussion are trolling, abusive, or otherwise
being unproductive. being unproductive.
In these cases, a user with Master permissions or higher in the project can lock (and unlock) In these cases, a user with Master permissions or higher in the project can lock (and unlock)
an issue or a merge request, using the "Lock" section in the sidebar: an issue or a merge request, using the "Lock" section in the sidebar:
...@@ -177,7 +214,7 @@ System notes indicate locking and unlocking. ...@@ -177,7 +214,7 @@ System notes indicate locking and unlocking.
![Discussion lock system notes](img/discussion_lock_system_notes.png) ![Discussion lock system notes](img/discussion_lock_system_notes.png)
In a locked issue or merge request, only team members can add new comments and In a locked issue or merge request, only team members can add new comments and
edit existing comments. Non-team members are restricted from adding or editing comments. edit existing comments. Non-team members are restricted from adding or editing comments.
| Team member | Non-team member | | Team member | Non-team member |
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment