From 1383250ee5d09b4de272322429ceaa2591927dc2 Mon Sep 17 00:00:00 2001 From: Giorgio Ughini Date: Thu, 30 Jul 2026 10:00:16 +0200 Subject: [PATCH 1/3] docs: add experimental disclaimer and fill in SUPPORT.md Add a Disclaimer section to the README stating the project is an experimental research project rather than an officially supported Microsoft product, and that generated skills should be reviewed before use. Replace the unedited Microsoft SUPPORT.md template (which still carried TODO and 'INSERT INSTRUCTIONS HERE' placeholders) with real guidance: GitHub Issues as the support channel, docs to check before filing, a bug report checklist, a privacy warning about debug bundles containing raw capture data, and a pointer to SECURITY.md for vulnerabilities. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 447d5f10-26b3-4001-8e65-81a10f613005 --- README.md | 6 ++++++ SUPPORT.md | 51 +++++++++++++++++++++++++++++++++++---------------- 2 files changed, 41 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index c023382..5c15edf 100644 --- a/README.md +++ b/README.md @@ -217,6 +217,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. +## Disclaimer + +This project is an experimental research project, not an officially supported Microsoft +product. Always review and validate generated skills before using those — AI-generated +output may contain errors or unsupported patterns. + ## Trademarks This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft diff --git a/SUPPORT.md b/SUPPORT.md index eaf439a..ca9e0f6 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -1,25 +1,44 @@ -# TODO: The maintainer of this repo has not yet edited this file +# Support -**REPO OWNER**: Do you want Customer Service & Support (CSS) support for this product/project? +## How to file issues and get help -- **No CSS support:** Fill out this template with information about how to file issues and get help. -- **Yes CSS support:** Fill out an intake form at [aka.ms/onboardsupport](https://aka.ms/onboardsupport). CSS will work with/help you to determine next steps. -- **Not sure?** Fill out an intake as though the answer were "Yes". CSS will help you decide. +Skill Recorder is an experimental research project, not an officially supported Microsoft +product — see the [Disclaimer](README.md#disclaimer). Support is community-based and +best-effort. -*Then remove this first heading from this SUPPORT.MD file before publishing your repo.* +This project uses [GitHub Issues](https://github.com/microsoft/skill-recorder/issues) to +track bugs and feature requests. Please search the existing issues before filing a new one +to avoid duplicates. For anything new, open an Issue. -# Support +Before filing, it's worth checking: + +- [`README.md`](README.md) — requirements, what gets captured, and how analysis works +- [`INSTALL.md`](INSTALL.md) — installation, including the Windows source installer +- [`WINDOWS-VALIDATION.md`](WINDOWS-VALIDATION.md) and + [`docs/windows-capture.md`](docs/windows-capture.md) — Windows-specific capture notes + +### What to include in a bug report + +- Your OS and version (macOS, Windows 11, or Ubuntu) and architecture +- The Skill Recorder commit you installed or built from +- Whether you're using an installer or a source checkout +- What you expected to happen versus what actually happened +- Any relevant error text from the app -## How to file issues and get help +**Debug bundles.** Each recording in the Library has a small download icon in its session +header that packages that session into a `.zip` alongside environment diagnostics. It is +deliberately complete, so it contains **your private capture data** — screenshots, screen +video, narration audio, and the analysis. Review it before sharing, and never attach one +to a public GitHub issue unless you're certain it holds nothing sensitive. A maintainer +will tell you where to send it if one is needed. -This project uses GitHub Issues to track bugs and feature requests. Please search the existing -issues before filing new issues to avoid duplicates. For new issues, file your bug or -feature request as a new Issue. +## Security issues -For help and questions about using this project, please **REPO MAINTAINER: INSERT INSTRUCTIONS HERE -FOR HOW TO ENGAGE REPO OWNERS OR COMMUNITY FOR HELP. COULD BE A STACK OVERFLOW TAG OR OTHER -CHANNEL. WHERE WILL YOU HELP PEOPLE?**. +Please do **not** report security vulnerabilities through public GitHub issues. Follow the +process in [`SECURITY.md`](SECURITY.md) instead. -## Microsoft Support Policy +## Microsoft Support Policy -Support for this **PROJECT or PRODUCT** is limited to the resources listed above. +Support for Skill Recorder is limited to the resources listed above. It is not covered by +Microsoft Customer Service & Support (CSS) or any Microsoft support program or service +level agreement. From 3a08640878ca7658e89bb45a88bafd803d181309 Mon Sep 17 00:00:00 2001 From: adilei Date: Thu, 30 Jul 2026 11:44:37 +0300 Subject: [PATCH 2/3] docs: reword disclaimer to drop "experimental research project" Reframe the README Disclaimer and SUPPORT.md intro as a community-supported, open-source project rather than an "experimental research project," and soften the debug-bundle note. Keeps all the support points (not officially supported, community best-effort, review AI-generated skills, capture-data privacy) while reading as clear and welcoming rather than a warning against use. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ebb9199f-c93c-4d63-b2f0-1b2e67e0773f --- README.md | 8 +++++--- SUPPORT.md | 16 ++++++++-------- 2 files changed, 13 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 5c15edf..5f3773f 100644 --- a/README.md +++ b/README.md @@ -219,9 +219,11 @@ contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additio ## Disclaimer -This project is an experimental research project, not an officially supported Microsoft -product. Always review and validate generated skills before using those — AI-generated -output may contain errors or unsupported patterns. +Skill Recorder is a community-supported, open-source project rather than an officially +supported Microsoft product. Help is available on a best-effort basis through +[GitHub Issues](https://github.com/microsoft/skill-recorder/issues) — see +[`SUPPORT.md`](SUPPORT.md) for details. Because skills are generated with AI, review and +validate them before you rely on them. ## Trademarks diff --git a/SUPPORT.md b/SUPPORT.md index ca9e0f6..a0d9f2a 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -2,9 +2,9 @@ ## How to file issues and get help -Skill Recorder is an experimental research project, not an officially supported Microsoft -product — see the [Disclaimer](README.md#disclaimer). Support is community-based and -best-effort. +Skill Recorder is a community-supported, open-source project rather than an officially +supported Microsoft product — see the [Disclaimer](README.md#disclaimer). Support is +community-based and best-effort, and we're happy to help where we can. This project uses [GitHub Issues](https://github.com/microsoft/skill-recorder/issues) to track bugs and feature requests. Please search the existing issues before filing a new one @@ -26,11 +26,11 @@ Before filing, it's worth checking: - Any relevant error text from the app **Debug bundles.** Each recording in the Library has a small download icon in its session -header that packages that session into a `.zip` alongside environment diagnostics. It is -deliberately complete, so it contains **your private capture data** — screenshots, screen -video, narration audio, and the analysis. Review it before sharing, and never attach one -to a public GitHub issue unless you're certain it holds nothing sensitive. A maintainer -will tell you where to send it if one is needed. +header that packages that session into a `.zip` alongside environment diagnostics. Because +it's complete, it includes your capture data — screenshots, screen video, narration audio, +and the analysis. Give it a quick review and remove anything private before sharing, and +please don't attach one to a public GitHub issue. If a maintainer needs it, they'll point +you to a private channel to send it. ## Security issues From 42c104900c4a0e128a4673455d5b552316f0a8e8 Mon Sep 17 00:00:00 2001 From: adilei Date: Thu, 30 Jul 2026 12:06:13 +0300 Subject: [PATCH 3/3] docs: restore "may contain errors" wording, trim best-effort line Address review feedback: keep the original "AI-generated output may contain errors or unsupported patterns" phrasing in the README disclaimer, and revert the SUPPORT.md support line to plain "community-based and best-effort". Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ebb9199f-c93c-4d63-b2f0-1b2e67e0773f --- README.md | 5 +++-- SUPPORT.md | 2 +- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 5f3773f..1559792 100644 --- a/README.md +++ b/README.md @@ -222,8 +222,9 @@ contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additio Skill Recorder is a community-supported, open-source project rather than an officially supported Microsoft product. Help is available on a best-effort basis through [GitHub Issues](https://github.com/microsoft/skill-recorder/issues) — see -[`SUPPORT.md`](SUPPORT.md) for details. Because skills are generated with AI, review and -validate them before you rely on them. +[`SUPPORT.md`](SUPPORT.md) for details. Because skills are generated with AI, always +review and validate them before use — AI-generated output may contain errors or +unsupported patterns. ## Trademarks diff --git a/SUPPORT.md b/SUPPORT.md index a0d9f2a..ea9fb28 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -4,7 +4,7 @@ Skill Recorder is a community-supported, open-source project rather than an officially supported Microsoft product — see the [Disclaimer](README.md#disclaimer). Support is -community-based and best-effort, and we're happy to help where we can. +community-based and best-effort. This project uses [GitHub Issues](https://github.com/microsoft/skill-recorder/issues) to track bugs and feature requests. Please search the existing issues before filing a new one