X-Git-Url: https://git.p6c8.net/policy-templates.git/blobdiff_plain/fcb4ae5bff98369fba2209c5a6ada33d21c6ac18..695947cd0f84b4852727f274c14e2289e1bffe5e:/README.md

diff --git a/README.md b/README.md
index 2bb261e..a1e3224 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,17 @@
-**These policies are in active development and so might contain changes that do not work with current versions of Firefox.**
+# Policy templates for Firefox
 
-**You should use the [officially released versions](https://github.com/mozilla/policy-templates/releases) if you are deploying changes.**
+> [!NOTE]
+> These policies are in active development and may contain changes that do not work with current versions of Firefox.
+>
+> Use the [officially released versions](https://github.com/mozilla/policy-templates/releases) if you are deploying changes.
 
-Official policy documentation has been moved to https://mozilla.github.io/policy-templates/.
\ No newline at end of file
+The [policy reference](https://mozilla.github.io/policy-templates/) contains documentation for each policy, its intended function, the settings you can adjust, examples of valid configurations, and any platform limitations that may apply.
+
+## About policies
+
+Firefox policies allow administrators to centrally manage browser behavior, enforce security requirements, configure features, or disable certain functionality.
+
+Policies are commonly used in managed environments such as businesses, schools, and public-sector organizations.
+They can be deployed using platform-specific mechanisms, including Group Policy on Windows, configuration profiles on macOS, and JSON configuration files on all platforms.
+
+This repository contains policy templates to support deploying and managing Firefox as an enterprise browser.