update ai control docs

Author: abose

docs/02-control-ai.md

@@ -1,11 +1,11 @@
 ---
-title: Phoenix Code AI Control
+title: AI Control for school and work
 ---
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# Phoenix Code AI Control
+# AI Control for school and work
 
 🔐 Disable or manage AI features in Phoenix Code for educational and enterprise environments.
 
@@ -85,7 +85,7 @@ The `--managedByEmail` parameter is optional but recommended. It provides an adm
    ```
 
 :::note
-The `--managedByEmail` parameter is optional but recommended for administrative contact information.
+The `--managedByEmail` parameter is optional but recommended. It provides an administrative contact for managing access to AI and educational features in the future. This email will be linked to your institution's AI management if given.
 :::
 
 </TabItem>
@@ -110,7 +110,7 @@ The `--managedByEmail` parameter is optional but recommended for administrative
    ```
 
 :::note
-The `--managedByEmail` parameter is optional but recommended for administrative contact information.
+The `--managedByEmail` parameter is optional but recommended. It provides an administrative contact for managing access to AI and educational features in the future. This email will be linked to your institution's AI management if given.
 :::
 
 </TabItem>
@@ -122,8 +122,8 @@ All installation scripts support the same command-line options:
 
 | Option | Description |
 |--------|-------------|
-| `--help` | Display usage information and help text |
-| `--managedByEmail <email>` | Optional but recommended. Admin email who manages AI policy. Can be used in your Phoenix managed AI dashboard to selectively enable features and manage usage quotas |
+| `--help` | Display help |
+| `--managedByEmail <email>` | Optional but recommended. Admin email who manages AI policy. Can be used in your Phoenix managed AI dashboard to selectively enable features and manage usage quotas in the future.|
 | `--allowedUsers "<user1,user2,...>"` | Comma-separated list of usernames allowed to use AI even when disabled for others |
 | `--disableAI` | If present, AI will be disabled by default for all users except those specified in `allowedUsers` |
 
@@ -336,15 +336,19 @@ The browser version of Phoenix Code will automatically detect if the domain is u
 
 **Q: When will AI be enabled in Phoenix Code?**
 
-Phoenix Code AI will be rolled out after May 20, 2025. Educational institutions should configure AI controls campus-wide before this date.
+Phoenix Code AI will be rolled out after **`May 20, 2025`**. Educational institutions should configure AI controls campus-wide before this date.
 
 **Q: How do I know if AI control is working?**
 
 In both the desktop and browser versions, go to View → AI Control Status to see a detailed report.
 
-**Q: Can I allow specific users to access AI features?**
+**Q: Can I disable AI for some users but enable it for others?**
+
+Yes, use the `--disableAI` flag to disable AI globally, then use the `--allowedUsers` parameter to specify which users should still have access. Example:
 
-Yes, but only in the desktop version. Use the `--allowedUsers` parameter with a comma-separated list of usernames when running the installation script. These users will be able to access AI features even when disabled system-wide with the `--disableAI` flag.
+```bash
+sudo ./setup_phoenix_ai_control_linux.sh --disableAI --allowedUsers "teacher1,admin2"
+```
 
 **Q: Is AI control mandatory?**
 
@@ -401,23 +405,15 @@ sudo ./setup_phoenix_ai_control_linux.sh --managedByEmail [email protected]
 
 **Q: What's the difference between browser and desktop control?**
 - **Browser Version**: Only supports network-level blocking of `ai.phcode.dev` through your firewall
-- **Desktop Version**: Provides comprehensive control through configuration files with user-specific permissions
+- **Desktop Version**: Provides comprehensive control with user-specific permissions
 
 **Q: Does this completely prevent AI usage?**
 - **Desktop Version**: Yes, the control is comprehensive when properly configured using the installation scripts
 - **Browser Version**: Only if you implement network-level blocking of the `ai.phcode.dev` domain
 
 **Q: How can I verify that the firewall is properly blocking AI access?**
 
-In the browser version, use the View → AI Control Status option which will attempt to connect to the AI service and report whether it's accessible or blocked.
-
-**Q: Can I disable AI for some users but enable it for others?**
-
-Yes, use the `--disableAI` flag to disable AI globally, then use the `--allowedUsers` parameter to specify which users should still have access. Example:
-
-```bash
-sudo ./setup_phoenix_ai_control_linux.sh --disableAI --allowedUsers "teacher1,admin2"
-```
+In the browser app at https://phcode.dev, install the `Phoenix Code AI Control`extension. Use the `View → AI Control Status` option. It will report whether AI is accessible or blocked.
 
 **Q: Is there a way to monitor AI usage in my organization?**