[YAML] Update script-only package formats in documentation#48113
Merged
Conversation
60 tasks
There was a problem hiding this comment.
Claude Code Review
This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.
Tip: disable this comment in your organization's Code Review settings.
rachaelshaw
approved these changes
Jun 25, 2026
1 task
cdcme
added a commit
that referenced
this pull request
Jul 13, 2026
<!-- Add the related story/sub-task/bug number, like Resolves #123, or remove if NA --> **Related issue:** Resolves #48395 (story #41470) Reconciles the `.py` script-only package reference docs against shipped behavior. The feature guide (#48116) and reference docs (#48113 YAML, #48115 REST API) are already merged to `docs-v4.90.0`; this fixes remaining `.py` inconsistencies found during the #48395 reconciliation. Docs-only PR against `docs-v4.90.0`. ## Changes - **`docs/REST API/rest-api.md`** — corrected the Add-package platform scoping: `.sh` and `.py` run on macOS and Linux, `.ps1` runs on Windows (was "Windows or Linux hosts," which omitted macOS and wrongly implied `.py` on Windows). Verified against `SoftwareInstallerPlatformFromExtension` and the Unix-like install-eligibility check in `ee/server/service/software_installers.go`. - **`docs/Configuration/yaml-files.md`** — fixed a backtick typo in the Script-only heading (`` .`py` `` → `` `.py` ``) and added `.py` to the `controls.scripts` glob note (prose + example), matching the already-merged `scripts.md` statement that `.py` scripts are supported on macOS and Linux. ## No changes needed - No new audit-log activity type — `docs/Contributing/reference/audit-logs.md` unchanged. - No new usage-statistics toggle — `articles/fleet-usage-statistics.md` unchanged. - Feature guide (`deploy-software-packages.md`, `scripts.md`, secrets doc) already merged via #48116. - `python_packages` in `rest-api.md` is the osquery inventory source for installed pip packages — unrelated to `.py` packages, left as-is. ## Note The script-only advanced-options wording (in `yaml-files.md` and `deploy-software-packages.md`) is corrected separately in the #42797 docs PR against `docs-v4.89.0`; it reaches 4.90 via the normal forward-merge. # Checklist for submitter - [x] QA'd all new/changed functionality manually (verified `.py` platform mapping and script-extension handling in `server/fleet/software_installer.go`, `server/fleet/scripts.go`, `pkg/spec/gitops.go`) <!-- Docs-only PR: no changes file, no code/tests, no migrations, no config settings, no fleetd changes. -->
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Related issue: Resolves #41470
Retargeted from #47611 to docs-v4.90.0.
Built for Mel Pike by Kilo for Slack