Skip to content

docs: AGENTS.md tray/record-button descriptions and permissions-window checklist are stale for v2.0.0 #880

Description

@EtienneLescot

Describe the bug

Three documentation spots are stale after the v2.0.0 changes, found while running the v2.0.0-rc.1 manual pass on macOS (AGENTS.md and technical-documentation/testing/manual-e2e-checklist.md @ 15f16c1b):

  1. AGENTS.md — tray description. It documents the tray right-click as "Open / Quit (Stop Recording while recording)". The v2 tray menu carries: Open, Check for Updates, Update Settings ▸, About OpenScreen, Save Diagnostics, Permissions…, Quit.

  2. AGENTS.md — record button. It still says the record button is disabled without a source, with tooltip "Please select a source to record". In v2 the button is enabled without a source, tooltip "Choose a screen or window to record", and pressing it opens Apple's picker (the checklist already describes this; AGENTS.md does not).

  3. manual-e2e-checklist.md — permissions window. The window's documented trigger is "opens at launch, until it has been closed once, while one of its rows was never asked". Observed additionally on rc.1: while a row is pending, every record press re-opens the window and the take does not start (silent non-start). Worth documenting — it is the most confusing behavior a fresh user hits (see also the separate issue on the silent non-start).

Two smaller notes:

  • The checklist's first-launch row list implies each row shows Allow; on a Mac where an earlier session already triggered a row's prompt, that row presents Open Settings from the first launch instead.
  • With no camera attached, the HUD webcam toggle does not turn on: it raises a "Camera access is blocked. Enable it in system settings" notification. Reasonable, but undocumented.

Expected behavior

Docs match v2.0.0 behavior.

Additional context

Environment for the observations: macOS 26.5 (25F71), Apple M1, CI build 2.0.0-rc.1 (dmg) from run 36336647912.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationstatus: fixed in mainWork is merged into main but may not be in a downloadable release yet.status: pending releaseMerged change is waiting for a packaged desktop release.

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions