feat: Add values section for reference docs [d]

src/content/docs/reference/policies/DefaultBrowserSettingEnabled.mdx

@@ -22,6 +22,11 @@ To suppress the startup check without removing the controls from browser prefere
 
 <PolicyExample policy="DefaultBrowserSettingEnabled" />
 
+## Values
+
+- Set to `true` to check whether Firefox is the default browser at startup, and lock the setting.
+- Set to `false` to stop the check, remove the option to make Firefox the default browser, and lock the setting.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DefaultDownloadDirectory.mdx

@@ -19,6 +19,13 @@ You can use `${home}` for the native home directory.
 
 <PolicyExample policy="DefaultDownloadDirectory" />
 
+## Values
+
+`DefaultDownloadDirectory` expects a path to the directory downloads are saved to, such as `/Users/username/Documents`.
+The user can still change it.
+
+- `${home}` expands to the user's home directory, so `${home}/Downloads` works across profiles and platforms.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableAccounts.mdx

@@ -17,6 +17,11 @@ Disable account-based services, including sync.
 
 <PolicyExample policy="DisableAccounts" />
 
+## Values
+
+- Set to `true` to disable account-based services, including sync, and block signing in.
+- Set to `false` to leave account-based services available. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableAppUpdate.mdx

@@ -17,6 +17,11 @@ Turn off application updates within Firefox.
 
 <PolicyExample policy="DisableAppUpdate" />
 
+## Values
+
+- Set to `true` to stop Firefox updating itself.
+- Set to `false` to leave updates enabled. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx

@@ -21,6 +21,13 @@ Disable the built in PDF viewer. PDF files are downloaded and sent externally.
 
 <PolicyExample policy="DisableBuiltinPDFViewer" />
 
+## Values
+
+- Set to `true` to hand PDF files to the operating system's default PDF handler.
+- Set to `false` to open PDF files in Firefox. Unlike most policies, this actively sets the handler back to the built-in viewer rather than doing nothing.
+
+If the [`Handlers`](/reference/policies/handlers/) policy already configures `application/pdf` or the `pdf` extension, that policy wins and `DisableBuiltinPDFViewer` is ignored.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx

@@ -23,6 +23,11 @@ Windows only.
 
 <PolicyExample policy="DisableDefaultBrowserAgent" />
 
+## Values
+
+- Set to `true` to stop the Windows default browser agent running.
+- Set to `false` to leave the agent running. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableDeveloperTools.mdx

@@ -17,6 +17,11 @@ Remove access to all developer tools.
 
 <PolicyExample policy="DisableDeveloperTools" />
 
+## Values
+
+- Set to `true` to disable the developer tools and block `about:debugging`, `about:devtools-toolbox` and `about:profiling`.
+- Set to `false` to leave the developer tools available. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableEncryptedClientHello.mdx

@@ -18,6 +18,11 @@ Note that TLS Client Hellos will still contain an ECH extension, but this extens
 
 <PolicyExample policy="DisableEncryptedClientHello" />
 
+## Values
+
+- Set to `true` to disable Encrypted Client Hello (ECH) for both DNS and HTTP/3.
+- Set to `false` to leave ECH enabled. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableFeedbackCommands.mdx

@@ -17,6 +17,11 @@ Disable the menus for reporting sites (Submit Feedback, Report Deceptive Site).
 
 <PolicyExample policy="DisableFeedbackCommands" />
 
+## Values
+
+- Set to `true` to remove the Submit Feedback and Report Deceptive Site items from the Help menu.
+- Set to `false` to leave the menu items in place. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableFirefoxAccounts.mdx

@@ -17,6 +17,13 @@ Disable Firefox Accounts integration (Sync).
 
 <PolicyExample policy="DisableFirefoxAccounts" />
 
+## Values
+
+- Set to `true` to disable Firefox accounts and sync.
+- Set to `false` to leave Firefox accounts available. This is the same as not setting the policy.
+
+If [`DisableAccounts`](/reference/policies/disableaccounts/) is also set, it takes precedence and `DisableFirefoxAccounts` is ignored.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx

@@ -17,6 +17,11 @@ Remove access to Firefox Screenshots.
 
 <PolicyExample policy="DisableFirefoxScreenshots" />
 
+## Values
+
+- Set to `true` to remove Firefox Screenshots.
+- Set to `false` to leave Firefox Screenshots available. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableFirefoxStudies.mdx

@@ -17,6 +17,11 @@ Disable Firefox studies (Shield).
 
 <PolicyExample policy="DisableFirefoxStudies" />
 
+## Values
+
+- Set to `true` to stop Firefox running studies, and turn off add-on and feature recommendations.
+- Set to `false` to leave studies enabled. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableForgetButton.mdx

@@ -17,6 +17,11 @@ Disable the "Forget" button.
 
 <PolicyExample policy="DisableForgetButton" />
 
+## Values
+
+- Set to `true` to remove the Forget button.
+- Set to `false` to leave the Forget button available. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableFormHistory.mdx

@@ -17,6 +17,11 @@ Turn off saving information on web forms and the search bar.
 
 <PolicyExample policy="DisableFormHistory" />
 
+## Values
+
+- Set to `true` to stop Firefox remembering form and search history.
+- Set to `false` to leave form and search history enabled. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableLaunchOnLogin.mdx

@@ -25,6 +25,11 @@ Windows and macOS only; Windows in Firefox 155, and macOS in Firefox 156.
 
 <PolicyExample policy="DisableLaunchOnLogin" />
 
+## Values
+
+- Set to `true` to remove the option to launch Firefox on login, and turn the setting off if it is already on.
+- Set to `false` to leave the option available. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableLocalPolicies.mdx

@@ -16,3 +16,8 @@ Disable reading policies from local policy sources.
 :::caution[Limitation]
 The policy cannot be applied by policies.json, Windows GPO or macOS plist.
 :::
+
+## Values
+
+- Set to `true` to stop Firefox reading policies from local policy sources.
+- Set to `false` to read local policy sources. This is the same as not setting the policy.

src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx

@@ -21,6 +21,11 @@ If both `DisableMasterPasswordCreation` and [`PrimaryPassword`](/reference/polic
 
 <PolicyExample policy="DisableMasterPasswordCreation" />
 
+## Values
+
+- Set to `true` to remove the option to create a primary password. An existing primary password can still be removed.
+- Set to `false` to leave primary password creation available. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisablePasswordReveal.mdx

@@ -17,6 +17,11 @@ Do not allow passwords to be shown in saved logins.
 
 <PolicyExample policy="DisablePasswordReveal" />
 
+## Values
+
+- Set to `true` to stop users revealing saved passwords.
+- Set to `false` to allow saved passwords to be revealed. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisablePocket.mdx

@@ -17,6 +17,11 @@ Remove Pocket in the Firefox UI. It does not remove it from the new tab page.
 
 <PolicyExample policy="DisablePocket" />
 
+## Values
+
+- Set to `true` to remove Pocket from the Firefox UI.
+- Set to `false` to leave Pocket in place. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisablePrivateBrowsing.mdx

@@ -21,6 +21,11 @@ Remove access to private browsing.
 
 <PolicyExample policy="DisablePrivateBrowsing" />
 
+## Values
+
+- Set to `true` to disable private browsing and block `about:privatebrowsing`.
+- Set to `false` to leave private browsing available. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableProfileImport.mdx

@@ -17,6 +17,11 @@ Remove the ability to import data from other browsers.
 
 <PolicyExample policy="DisableProfileImport" />
 
+## Values
+
+- Set to `true` to remove the option to import data from another browser, including the import wizard.
+- Set to `false` to leave importing available. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableProfileRefresh.mdx

@@ -17,6 +17,11 @@ Disable the Refresh Firefox button on `about:support` and `support.mozilla.org`,
 
 <PolicyExample policy="DisableProfileRefresh" />
 
+## Values
+
+- Set to `true` to remove the Refresh Firefox button from `about:support`, and stop Firefox prompting the user to refresh.
+- Set to `false` to leave the Refresh Firefox button available. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableRemoteImprovements.mdx

@@ -17,6 +17,11 @@ Prevent Firefox from applying performance, stability, and feature changes betwee
 
 <PolicyExample policy="DisableRemoteImprovements" />
 
+## Values
+
+- Set to `true` to stop Firefox applying remotely configured changes between updates.
+- Set to `false` to leave remote improvements enabled. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableRemoteSettingsAndAcceptSecurityConsequences.mdx

@@ -22,6 +22,11 @@ Remote Settings is the mechanism Firefox uses to deliver frequently updated data
 
 <PolicyExample policy="DisableRemoteSettingsAndAcceptSecurityConsequences" />
 
+## Values
+
+- Set to `true` to stop Firefox connecting to Remote Settings, including for the add-on and plugin blocklists.
+- Set to `false` to leave Remote Settings enabled. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableSafeMode.mdx

@@ -21,6 +21,11 @@ Windows and macOS only.
 
 <PolicyExample policy="DisableSafeMode" />
 
+## Values
+
+- Set to `true` to disable safe mode. On Windows, this also disables starting in safe mode from the command line.
+- Set to `false` to leave safe mode available. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableSetDesktopBackground.mdx

@@ -17,6 +17,11 @@ Remove the "Set As Desktop Background..." menuitem when right clicking on an ima
 
 <PolicyExample policy="DisableSetDesktopBackground" />
 
+## Values
+
+- Set to `true` to remove the Set as Desktop Background item from the image context menu.
+- Set to `false` to leave the menu item in place. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx

@@ -22,6 +22,11 @@ If this policy is set to `true`, Firefox does not install new system add-ons or
 
 <PolicyExample policy="DisableSystemAddonUpdate" />
 
+## Values
+
+- Set to `true` to stop Firefox installing or updating system add-ons.
+- Set to `false` to leave system add-on updates enabled. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableTelemetry.mdx

@@ -22,6 +22,11 @@ From Firefox 83 and Firefox ESR 78.5, local storage of telemetry data is also di
 
 <PolicyExample policy="DisableTelemetry" />
 
+## Values
+
+- Set to `true` to stop telemetry being collected and uploaded, and block `about:telemetry`.
+- Set to `false` to leave telemetry enabled. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx

@@ -21,6 +21,11 @@ Windows only, GPO only.
 
 <PolicyExample policy="DisableThirdPartyModuleBlocking" />
 
+## Values
+
+- Set to `true` to stop users blocking third-party modules from `about:third-party`.
+- Set to `false` to leave third-party module blocking available. This is the same as not setting the policy.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx

@@ -22,6 +22,11 @@ To remove the controls to set Firefox as the default browser, see the [`DefaultB
 
 <PolicyExample policy="DontCheckDefaultBrowser" />
 
+## Values
+
+- Set to `true` to stop Firefox checking whether it is the default browser at startup, and lock the setting.
+- Set to `false` to check at startup whether Firefox is the default browser, and lock the setting.
+
 ## Windows (GPO)
 
 ```

src/content/docs/reference/policies/DownloadDirectory.mdx

@@ -18,6 +18,13 @@ You can use `${home}` for the native home directory.
 
 <PolicyExample policy="DownloadDirectory" />
 
+## Values
+
+`DownloadDirectory` expects a path to the directory downloads are saved to, such as `/Users/username/Documents`.
+The path is locked, and the user cannot choose where each file is saved.
+
+- `${home}` expands to the user's home directory, so `${home}/Downloads` works across profiles and platforms.
+
 ## Windows (GPO)
 
 ```