Document experimental video calls in DMs (Calls v1.12.0)

[bgardner8008]

Summary

Calls plugin v1.12.0 introduces experimental video support, gated behind a new Enable video calls in DMs (Experimental) plugin setting (EnableVideo, default off). This makes the existing end-user FAQ — which states video is not supported — inaccurate. This PR updates the docs accordingly.

This was flagged by the docs-impact-review bot on the server version-bump PR (mattermost/mattermost#37077).

Changes

• End User Guide → Make calls (make-calls.rst): Rewrote the "Is video supported?" FAQ to describe experimental video in DM calls (desktop/web), with limitations:
  • Available in DM calls only
  • Not available on mobile (received video calls behave as audio + screen share; mobile users can't start video calls)
  • Call recordings capture voice and screen sharing only — video isn't recorded
• System Console settings reference (plugins-configuration-settings.rst): Added an "Enable video calls in DMs (Experimental)" entry (config.json enablevideo, env var MM_CALLS_ENABLE_VIDEO), cross-linked from the FAQ.

Ticket

https://mattermost.atlassian.net/browse/MM-68811

Related PRs

• Server prepackaged plugin bump: update Calls to v1.12.0 mattermost#37077

Checklist

• Built docs locally with Sphinx; build succeeds with no new warnings
• Verified both :ref: cross-references resolve in the rendered HTML

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 5846c589-228f-4edc-8f1a-1f4c4e84e74a

📥 Commits

Reviewing files that changed from the base of the PR and between 940b724 and 36e415e.

📒 Files selected for processing (2)

• source/administration-guide/configure/plugins-configuration-settings.rst
• source/end-user-guide/collaborate/make-calls.rst

---

📝 Walkthrough

Walkthrough

Two documentation files are updated to cover the experimental "Enable video calls in DMs" plugin setting. The admin configuration reference gains a new setting block with its config path, environment variable, and behavioural details. The end-user FAQ expands the video support answer to describe the feature, how to enable it, and its limitations.

Changes

Experimental DM Video Calls Docs

Layer / File(s)

Summary

Admin config setting and end-user FAQ for DM video calls source/administration-guide/configure/plugins-configuration-settings.rst, source/end-user-guide/collaborate/make-calls.rst

The admin guide adds the "Enable video calls in DMs (Experimental)" block with its config.json path, environment variable (MM_CALLS_ENABLE_DM_VIDEO), true/false semantics, and an experimental-status note. The end-user FAQ expands the "Is video supported?" answer to document the experimental DM video feature, the System Console setting admins use to enable it, and limitations: DM-only, unavailable on mobile (behaves as audio), and recordings do not capture video.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: documenting experimental video calls in DMs with the specific plugin version.
Description check	✅ Passed	The description clearly relates to the changeset, providing context about the new feature, specific changes made, and verification steps.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch MM-68811-docs-calls-video-1.12.0

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

Newest code from mattermost has been published to preview environment for Git SHA 36e415e

[amyblais]

Thank you Bill, I've updated to the 11.9-documentation branch and requested Editor reviews.