Skip to content

Renaming: Update reference docs#41423

Closed
noahtalerman wants to merge 2 commits intomainfrom
rename-reference
Closed

Renaming: Update reference docs#41423
noahtalerman wants to merge 2 commits intomainfrom
rename-reference

Conversation

@noahtalerman
Copy link
Copy Markdown
Member

@noahtalerman noahtalerman commented Mar 10, 2026

Summary

Systematically updates all reference documentation in docs/ to reflect the "teams → fleets" and "queries → reports" rename that was implemented in code across PRs #39847, #39572, #39873, #40364, #40548, and #40920.

Changes across 49 files:

  • API endpoint paths: /fleet/teams/fleet/fleets, /fleet/queries/fleet/reports
  • JSON field names: team_idfleet_id, query_idreport_id, team_namefleet_name, query_namereport_name, and all related fields
  • YAML/GitOps configuration keys: team_settingssettings, queriesreports, teams/fleets/
  • Server configuration flags: live_query_disabledlive_reporting_disabled, query_reports_disableddiscard_reports_data, query_report_capreport_cap
  • CLI commands and flags: fleetctl queryfleetctl report, --team--fleet, get teamsget fleets
  • Environment variables: FLEET_JIT_USER_ROLE_TEAM_*FLEET_JIT_USER_ROLE_FLEET_*
  • Audit log activity types: created_teamcreated_fleet, live_querylive_report, etc.
  • Descriptive text throughout all reference documentation

Carefully preserved:

  • "Fleet" as the product name
  • osquery SQL query references and query: YAML fields containing SQL
  • kind: query and kind: team YAML values (not renamed per code)
  • Database column names in architecture docs
  • Human team references ("engineering team", etc.)

Built for ntalerman by Kilo for Slack

fleet-release
fleet-release previously approved these changes Mar 10, 2026
Systematically update all documentation in docs/ to reflect the rename:

- teams → fleets (organizational grouping concept)
- queries → reports (Fleet query/report concept)

Changes include:
- API endpoint paths (/fleet/teams → /fleet/fleets, /fleet/queries → /fleet/reports)
- JSON field names (team_id → fleet_id, query_id → report_id, etc.)
- YAML/GitOps configuration keys (team_settings → settings, queries → reports)
- Server configuration flags (live_query_disabled → live_reporting_disabled, etc.)
- CLI commands and flags (fleetctl query → fleetctl report, --team → --fleet)
- Environment variables (FLEET_JIT_USER_ROLE_TEAM → FLEET_JIT_USER_ROLE_FLEET)
- Activity type names in audit logs
- Descriptive text throughout all reference documentation

Carefully preserved:
- 'Fleet' as the product name (not renamed)
- osquery SQL 'query' references
- kind: query and kind: team YAML values
- Database column names in architecture docs
- Human team references (engineering team, etc.)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants