From 42c789d1efaa6d2f9c3ddbc6abdb399196039d08 Mon Sep 17 00:00:00 2001 From: "Yousef Iskander (yousefi)" Date: Mon, 26 Oct 2026 20:54:17 -0400 Subject: [PATCH 1/2] Link and language fixes for RHEL, community, support and security. --- README.md | 4 +++- SUPPORT.md | 2 +- docs/discovery-app/install.md | 23 ++++++++++++++--------- 3 files changed, 18 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index be69c19e..dcc9f5de 100644 --- a/README.md +++ b/README.md @@ -165,7 +165,9 @@ discovery/ │ └── Dockerfile ├── starter-kits/ │ └── / ← flat catalog: one folder per kit -│ └── kit.json ← Starter-kit manifest (required, the only file allowed in the folder) +│ └── kit.json ← Starter-kit manifest (required) +│ └── README.md ← Optional, but recommended +│ └── media/ ← Required only if images are used in Markdown files ├── .auto-registry/ ← Auto-generated catalog registries; do not edit by hand │ ├── agent-registry.json ← Aggregated agent metadata from agents/*/ │ └── starter-kit-registry.json ← Aggregated starter-kit metadata from starter-kits/*/ diff --git a/SUPPORT.md b/SUPPORT.md index 4c257867..a43b41db 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -15,7 +15,7 @@ Before opening a new discussion, please search existing posts — the answer or ## Reporting security vulnerabilities -**Do not** open a public GitHub Discussion or issue for security vulnerabilities. Instead, follow the private reporting process documented in [`SECURITY.md`](SECURITY.md). +**Do not** open a public TechCommunity Discussion security vulnerabilities. Instead, follow the reporting process documented in [`SECURITY.md`](SECURITY.md). ## Microsoft Discovery app and Microsoft Discovery services diff --git a/docs/discovery-app/install.md b/docs/discovery-app/install.md index 9294c818..2742f658 100644 --- a/docs/discovery-app/install.md +++ b/docs/discovery-app/install.md @@ -2,14 +2,14 @@ This guide walks through installing the Microsoft Discovery app. For the conceptual tour, see the [Quick Start](quickstart.md). -The Microsoft Discovery app is a self-contained application available for Windows x64, Windows Arm64, and MacOS Arm. The installer bundles everything it needs to run; you don't have to install an SDK, an IDE, or a runtime. +The Microsoft Discovery app is a self-contained application available for Windows x64, Windows Arm64, macOS ARM, and Red Hat (Enterprise Linux) x64. The installer bundles everything it needs to run; you don't have to separately install an SDK, an IDE, or a runtime. ## Prerequisites | Requirement | Notes | | --- | --- | -| **Operating system** | Windows 11 and macOS currently supported. Linux isn't currently supported. | -| **GitHub account** | Required to download releases from this repository. | +| **Operating systems** | Windows 11, macOS, and RHEL currently supported. | +| **GitHub account** | Optional. Required only to make contributions to agents and starter-kits. | | **GitHub Copilot subscription** | Required. Microsoft Discovery drives Copilot to power its conversational and agent capabilities. | | **Disk space** | ~3 GB free for the install plus additional space for your bookshelves. | | **Network access at install time** | The installer fetches signed components from Microsoft endpoints. Microsoft Discovery runs locally after install; only specific Agent Plugins call out to the internet. | @@ -23,17 +23,19 @@ The Microsoft Discovery app is a self-contained application available for Window ## Step 1 — Download 1. Open the [Discovery download landing page](/README.md) on this repository. -1. Select your platform amongst the **User Installer** options (**x64**, **Arm64**, or **macOS**). Optionally, you can get one previous version from the table below the download options. +1. Select your platform amongst the **User Installer** options (**x64**, **Arm64**, **macOS**, **RHEL**). You can optionally get one previous version from the table below the download options. ## Step 2 — Install -1. Right-click the downloaded installer for your platform. Select **Run as administrator** to cleanly install. +1. Start the installer that you just downloaded. Windows and Linux require that you have the rights to elevate to Administrator or `sudo`. For Windows, it's recommended that you right-click the downloaded installer and select **Run as administrator** to cleanly install. For Linux, extract the tar.gz file contents and run the `install-discovery-app --rpm `. + 1. Follow the installer prompts. Defaults are recommended. -1. Launch the application when the installer finishes. On Windows, find it in the Start menu under *Microsoft Discovery*; on Mac in the App Launcher. +1. Launch the application when the installer finishes. On Windows, find it in the Start menu under *Microsoft Discovery*; on Mac in the App Launcher, or on Red Hat from the menu or type `discovery-app --mode science` or `discovery-app --mode developer`. + +1. Sign in with your **GitHub account** when prompted. Microsoft Discovery uses this to drive your GitHub Copilot subscription. ## Step 3 — Verify (Optional) -1. Sign in with your **GitHub account** when prompted. Microsoft Discovery uses this to drive your GitHub Copilot subscription. 1. Open a terminal and verify the CLI is available: ```powershell @@ -51,8 +53,8 @@ Continue with the [Quick Start](quickstart.md) to build your first Bookshelf and New builds are delivered as releases on this repository. To upgrade: -1. Download the latest `Discovery-app-x.y.z-release-platform-arch.exe`. -1. Close Microsoft Discovery. +1. Download the latest installer. +1. Close any running Microsoft Discovery instance. 1. Run the new installer. It updates components in place; your `.discovery/` workspace state is preserved. 1. Re-open Microsoft Discovery and verify with `dx --version`. @@ -70,6 +72,9 @@ New builds are delivered as releases on this repository. To upgrade: 1. Find the **Discovery** application and select. 1. Drag to **Trash** icon on the desktop or in **Finder**. +### Red Hat +1. Enter `sudo dnf autoremove -y discovery-app` + ## Troubleshooting | Symptom | What to try | From 01b64f8cd08f20474cd2451e5b031f843819431c Mon Sep 17 00:00:00 2001 From: "Yousef Iskander (yousefi)" Date: Tue, 27 Oct 2026 18:08:10 -0400 Subject: [PATCH 2/2] Modify links for discovery-toolbox --- utilities/discovery-toolbox/PRIVACY.md | 3 +-- utilities/discovery-toolbox/README.md | 2 +- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/utilities/discovery-toolbox/PRIVACY.md b/utilities/discovery-toolbox/PRIVACY.md index bf4807e6..5a28b85c 100644 --- a/utilities/discovery-toolbox/PRIVACY.md +++ b/utilities/discovery-toolbox/PRIVACY.md @@ -171,8 +171,7 @@ rm -rf ~/.md-toolbox ## 9. Reporting privacy concerns If you spot a behavior of this extension that contradicts anything in -this document, please open an issue on the public release repository -at [`microsoft/discovery`](https://github.com/microsoft/discovery/issues/new?labels=feedback&title=%5BPrivacy%5D%20) +this document, please open an issue on the [TechCommunity forums](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions) or contact the maintainers. The "Send Feedback" entry in the Discovery Toolbox sidebar is hidden diff --git a/utilities/discovery-toolbox/README.md b/utilities/discovery-toolbox/README.md index 83dfb8a6..a41a6b53 100644 --- a/utilities/discovery-toolbox/README.md +++ b/utilities/discovery-toolbox/README.md @@ -110,7 +110,7 @@ The sidebar's breadth is set by a single **View Level** (`mdToolbox.viewLevel`): ## Feedback -Found a bug, want a feature, or have general feedback? Open an issue on the [microsoft/discovery](https://github.com/microsoft/discovery/issues/new) repo and include the page you were on plus your toolbox version (Help → About inside the extension). +Found a bug, want a feature, or have general feedback? Open an issue on the [Microsoft Discovery TechWeb Community](https://techcommunity.microsoft.com/category/azure/discussions/microsoft-discovery-discussions) repo and include the page you were on plus your toolbox version (Help → About inside the extension). ---