Merge branch '17531-mark-changes-to-files-as-reviewed-in-merge-requests' into 'master'

Documentation for marking files as viewed

See merge request gitlab-org/gitlab!48976

changelogs/unreleased/feature-file-review-docs.yml

+---
+title: Enable local file reviews (marking files as viewed) by default and add documentation
+  for that feature
+merge_request: 48976
+author:
+type: added

config/feature_flags/development/local_file_reviews.yml

 ---
 name: local_file_reviews
-introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/48976
+introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/51513
 rollout_issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/296674
-milestone: '13.8'
+milestone: '13.9'
 type: development
 group: group::code review
-default_enabled: false
+default_enabled: true

doc/user/project/merge_requests/reviewing_and_managing_merge_requests.md

@@ -136,6 +136,46 @@ NOTE:
 You can append `?w=1` while on the diffs page of a merge request to ignore any
 whitespace changes.
 
+## Mark files as viewed
+
+> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/51513) in GitLab 13.8.
+> - It's deployed behind a feature flag, enabled by default.
+> - It's enabled on GitLab.com.
+> - It's recommended for production use.
+> - For GitLab self-managed instances, GitLab administrators can opt to [disable it](#enable-or-disable-file-views). **(CORE ONLY)**
+
+When reviewing a merge request with many files multiple times, it may be useful to the reviewer
+to focus on new changes and ignore the files that they have already reviewed and don't want to 
+see anymore unless they are changed again.
+
+To mark a file as viewed:
+
+1. Go to the merge request's **Diffs** tab.
+1. On the right-top of the file, locate the **Viewed** checkbox.
+1. Check it to mark the file as viewed.
+
+Once checked, the file will remain marked for that reviewer unless there are newly introduced 
+changes to its content or the checkbox is unchecked.
+
+### Enable or disable file views **(CORE ONLY)**
+
+The file view feature is under development but ready for production use.
+It is deployed behind a feature flag that is **enabled by default**.
+[GitLab administrators with access to the GitLab Rails console](../../../administration/feature_flags.md)
+can opt to enable it for your instance.
+
+To enable it:
+
+```ruby
+Feature.enable(:local_file_reviews)
+```
+
+To disable it:
+
+```ruby
+Feature.disable(:local_file_reviews)
+```
+
 ## Perform inline code reviews
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/13950) in GitLab 11.5.