2090311 - [macOS] Stop documenting files inside the app bundle in the in-tree distribution and update server docs

Status: ASSIGNED

(Toolkit :: Application Update, task)

Description

[Stephen A Pohl [:spohl]]

Adding files to Firefox.app breaks its code signature (codesign --verify --deep --strict fails). The admin docs were updated for this in bug 2089906, but other docs still tell people to put files into the bundle on macOS:

• browser/docs/DistributionIni.md gives Firefox.app/Contents/Resources/distribution/distribution.ini as the macOS location, and says the same directory can hold add-ons and policies.json.
• toolkit/mozapps/update/docs/SettingUpAnUpdateServer.md puts policies.json into Contents/Resources/distribution to point Firefox at a local update server.
• docs/index.md in the mozilla/policy-templates GitHub repository says that on Mac, policies.json goes into Firefox.app/Contents/Resources/distribution.

These should warn that this breaks the code signature, and point to a configuration profile or /Library/Preferences/org.mozilla.firefox.plist where that works.

Comment 1

[Stephen A Pohl [:spohl]]

Attachment: Bug 2090311: Stop documenting files inside the macOS app bundle in the distribution.ini and update server docs. r?mkaply,yjuglaret!