X-Git-Url: https://git.p6c8.net/policy-templates.git/blobdiff_plain/aa3e9c4ae6c27d9e5b0ad95508cbb4e030e58a4e..16d4965a2bfa0bde809dad2db4bcf573ef8a1c1d:/README.md?ds=inline

diff --git a/README.md b/README.md
index 2bb261e..0e8d7a4 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,18 @@
-**These policies are in active development and so might contain changes that do not work with current versions of Firefox.**
+# Firefox Policy Templates
 
-**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
+This repository contains policy templates to support deploying and managing Firefox as an enterprise browser.
+
+Firefox policies allow administrators to centrally manage browser behavior, enforce security requirements, configure features, or disable certain functionality.
+Policies are commonly used in enterprise or managed environments such as businesses, schools, and public-sector organizations.
+
+## Policy documentation
+
+> [!WARNING]
+> Documentation for policy behavior and syntax is moving to [Firefox Admin Docs](https://firefox-admin-docs.mozilla.org/reference/policies/).
+
+The new docs repository is public and open to contributions, so if you want to make improvements, feel free to contribute at https://github.com/mozilla/enterprise-admin-reference.
+See the [GitHub Discussion](https://github.com/mozilla/policy-templates/discussions/1291) for more information.