Commit graph

257 commits

Author SHA1 Message Date
Jonathan Katz
acf3c3b5c1
Require bug fixes to be manually validated in community PRs (#44689) 2026-05-04 15:29:41 -05:00
Luke Heath
a8adaa8b26
Em dash removal (#44531) 2026-04-30 16:49:14 -05:00
Luke Heath
f70a02a91b
Add Runbooks section to engineering handbook (#44408) 2026-04-30 13:46:02 -05:00
Luke Heath
f94b66f37d
Reorganize engineering handbook (#44443)
Some checks are pending
Test Puppet / test-puppet (push) Waiting to run
Go Tests / test-go-no-db (fast) (push) Waiting to run
Go Tests / test-go-no-db (scripts) (push) Waiting to run
Go Tests / test-go (mysql:8.0.44, fleetctl) (push) Waiting to run
Go Tests / test-go (mysql:8.0.44, integration-core) (push) Waiting to run
Go Tests / test-go (mysql:8.0.44, integration-enterprise) (push) Waiting to run
Go Tests / test-go (mysql:8.0.44, integration-mdm) (push) Waiting to run
Go Tests / test-go (mysql:8.0.44, main) (push) Waiting to run
Go Tests / test-go (mysql:8.0.44, mysql) (push) Waiting to run
Go Tests / test-go (mysql:8.0.44, service) (push) Waiting to run
Go Tests / test-go (mysql:8.0.44, vuln) (push) Waiting to run
Go Tests / test-go (mysql:9.5.0, fleetctl) (push) Waiting to run
Go Tests / test-go (mysql:9.5.0, integration-core) (push) Waiting to run
Go Tests / test-go (mysql:9.5.0, integration-enterprise) (push) Waiting to run
Go Tests / test-go (mysql:9.5.0, integration-mdm) (push) Waiting to run
Go Tests / test-go (mysql:9.5.0, mysql) (push) Waiting to run
Go Tests / test-go (mysql:9.5.0, service) (push) Waiting to run
Go Tests / test-go-extended-mysql (mysql:8.0.42, integration-core) (push) Waiting to run
Go Tests / test-go (mysql:9.5.0, main) (push) Waiting to run
Go Tests / test-go (mysql:9.5.0, vuln) (push) Waiting to run
Go Tests / test-go-extended-mysql (mysql:8.0.42, fleetctl) (push) Waiting to run
Go Tests / aggregate-result (push) Blocked by required conditions
JavaScript Tests / test-js (ubuntu-latest) (push) Waiting to run
JavaScript Tests / lint-js (ubuntu-latest) (push) Waiting to run
Test Mock Changes / test-mock-changes (push) Waiting to run
Test native tooling packaging / test-packaging (local, ubuntu-latest) (push) Waiting to run
Test native tooling packaging / test-packaging (remote, ubuntu-latest) (push) Waiting to run
Test packaging / test-packaging (macos-15) (push) Waiting to run
Test packaging / test-packaging (macos-26) (push) Waiting to run
Test packaging / test-packaging (ubuntu-latest) (push) Waiting to run
2026-04-30 12:56:15 -05:00
kilo-code-bot[bot]
11aa1c1a8f
Update handbook: recommend @claude review once over @claude review (#43329) 2026-04-09 10:57:00 -05:00
kilo-code-bot[bot]
c5cfc52b87
Add responsibility: Triage and address vulnerabilities in the website/ code base (#43208) 2026-04-08 09:11:40 -05:00
Carlo
a8dae187f9
Update handbook incident response sections (#43049) 2026-04-07 10:26:54 -05:00
Luke Heath
b61d2d0d81
Handbook working group process and AI tools (#43096) 2026-04-06 19:03:01 -05:00
Marcus Allen
ddd9cf6d8b
Update README.md (#42805)
Small update to the md file

<!-- Add the related story/sub-task/bug number, like Resolves #123, or
remove if NA -->
**Related issue:** Resolves #

# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [ ] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.
See [Changes
files](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/guides/committing-changes.md#changes-files)
for more information.

- [ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements), JS
inline code is prevented especially for url redirects, and untrusted
data interpolated into shell scripts/commands is validated against shell
metacharacters.
- [ ] If paths of existing endpoints are modified without backwards
compatibility, checked the frontend/CLI for any necessary changes

## Testing

- [ ] Added/updated automated tests
- [ ] Where appropriate, [automated tests simulate multiple hosts and
test for host
isolation](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/reference/patterns-backend.md#unit-testing)
(updates to one hosts's records do not affect another)

- [ ] QA'd all new/changed functionality manually

For unreleased bug fixes in a release candidate, one of:

- [ ] Confirmed that the fix is not expected to adversely impact load
test results
- [ ] Alerted the release DRI if additional load testing is needed

## Database migrations

- [ ] Checked schema for all modified table for columns that will
auto-update timestamps during migration.
- [ ] Confirmed that updating the timestamps is acceptable, and will not
cause unwanted side effects.
- [ ] Ensured the correct collation is explicitly set for character
columns (`COLLATE utf8mb4_unicode_ci`).

## New Fleet configuration settings

- [ ] Setting(s) is/are explicitly excluded from GitOps

If you didn't check the box above, follow this checklist for
GitOps-enabled settings:

- [ ] Verified that the setting is exported via `fleetctl
generate-gitops`
- [ ] Verified the setting is documented in a separate PR to [the GitOps
documentation](https://github.com/fleetdm/fleet/blob/main/docs/Configuration/yaml-files.md#L485)
- [ ] Verified that the setting is cleared on the server if it is not
supplied in a YAML file (or that it is documented as being optional)
- [ ] Verified that any relevant UI is disabled when GitOps mode is
enabled

## fleetd/orbit/Fleet Desktop

- [ ] Verified compatibility with the latest released version of Fleet
(see [Must
rule](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/workflows/fleetd-development-and-release-strategy.md))
- [ ] If the change applies to only one platform, confirmed that
`runtime.GOOS` is used as needed to isolate changes
- [ ] Verified that fleetd runs on macOS, Linux and Windows
- [ ] Verified auto-update works from the released version of component
to the new version (see [tools/tuf/test](../tools/tuf/test/README.md))
2026-04-02 13:00:48 +01:00
burakmetealtinisik35
73d9c4f85a
Typo Fix "Bug" to "Bugs" (#42460)
<!-- Add the related story/sub-task/bug number, like Resolves #123, or
remove if NA -->
**Related issue:** Resolves #

# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [ ] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.
See [Changes
files](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/guides/committing-changes.md#changes-files)
for more information.

- [ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements), JS
inline code is prevented especially for url redirects, and untrusted
data interpolated into shell scripts/commands is validated against shell
metacharacters.
- [ ] If paths of existing endpoints are modified without backwards
compatibility, checked the frontend/CLI for any necessary changes

## Testing

- [ ] Added/updated automated tests
- [ ] Where appropriate, [automated tests simulate multiple hosts and
test for host
isolation](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/reference/patterns-backend.md#unit-testing)
(updates to one hosts's records do not affect another)

- [ ] QA'd all new/changed functionality manually

For unreleased bug fixes in a release candidate, one of:

- [ ] Confirmed that the fix is not expected to adversely impact load
test results
- [ ] Alerted the release DRI if additional load testing is needed

## Database migrations

- [ ] Checked schema for all modified table for columns that will
auto-update timestamps during migration.
- [ ] Confirmed that updating the timestamps is acceptable, and will not
cause unwanted side effects.
- [ ] Ensured the correct collation is explicitly set for character
columns (`COLLATE utf8mb4_unicode_ci`).

## New Fleet configuration settings

- [ ] Setting(s) is/are explicitly excluded from GitOps

If you didn't check the box above, follow this checklist for
GitOps-enabled settings:

- [ ] Verified that the setting is exported via `fleetctl
generate-gitops`
- [ ] Verified the setting is documented in a separate PR to [the GitOps
documentation](https://github.com/fleetdm/fleet/blob/main/docs/Configuration/yaml-files.md#L485)
- [ ] Verified that the setting is cleared on the server if it is not
supplied in a YAML file (or that it is documented as being optional)
- [ ] Verified that any relevant UI is disabled when GitOps mode is
enabled

## fleetd/orbit/Fleet Desktop

- [ ] Verified compatibility with the latest released version of Fleet
(see [Must
rule](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/workflows/fleetd-development-and-release-strategy.md))
- [ ] If the change applies to only one platform, confirmed that
`runtime.GOOS` is used as needed to isolate changes
- [ ] Verified that fleetd runs on macOS, Linux and Windows
- [ ] Verified auto-update works from the released version of component
to the new version (see [tools/tuf/test](../tools/tuf/test/README.md))
2026-03-27 16:46:43 -05:00
Pierre Pucheu
cf360311b8
Fix formatting issue in QA process steps (#42391)
Update typo for "size" wording on "Participate in a QA day".

<!-- Add the related story/sub-task/bug number, like Resolves #123, or
remove if NA -->
**Related issue:** Resolves #

# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [ ] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.
See [Changes
files](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/guides/committing-changes.md#changes-files)
for more information.

- [ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements), JS
inline code is prevented especially for url redirects, and untrusted
data interpolated into shell scripts/commands is validated against shell
metacharacters.
- [ ] If paths of existing endpoints are modified without backwards
compatibility, checked the frontend/CLI for any necessary changes

## Testing

- [ ] Added/updated automated tests
- [ ] Where appropriate, [automated tests simulate multiple hosts and
test for host
isolation](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/reference/patterns-backend.md#unit-testing)
(updates to one hosts's records do not affect another)

- [ ] QA'd all new/changed functionality manually

For unreleased bug fixes in a release candidate, one of:

- [ ] Confirmed that the fix is not expected to adversely impact load
test results
- [ ] Alerted the release DRI if additional load testing is needed

## Database migrations

- [ ] Checked schema for all modified table for columns that will
auto-update timestamps during migration.
- [ ] Confirmed that updating the timestamps is acceptable, and will not
cause unwanted side effects.
- [ ] Ensured the correct collation is explicitly set for character
columns (`COLLATE utf8mb4_unicode_ci`).

## New Fleet configuration settings

- [ ] Setting(s) is/are explicitly excluded from GitOps

If you didn't check the box above, follow this checklist for
GitOps-enabled settings:

- [ ] Verified that the setting is exported via `fleetctl
generate-gitops`
- [ ] Verified the setting is documented in a separate PR to [the GitOps
documentation](https://github.com/fleetdm/fleet/blob/main/docs/Configuration/yaml-files.md#L485)
- [ ] Verified that the setting is cleared on the server if it is not
supplied in a YAML file (or that it is documented as being optional)
- [ ] Verified that any relevant UI is disabled when GitOps mode is
enabled

## fleetd/orbit/Fleet Desktop

- [ ] Verified compatibility with the latest released version of Fleet
(see [Must
rule](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/workflows/fleetd-development-and-release-strategy.md))
- [ ] If the change applies to only one platform, confirmed that
`runtime.GOOS` is used as needed to isolate changes
- [ ] Verified that fleetd runs on macOS, Linux and Windows
- [ ] Verified auto-update works from the released version of component
to the new version (see [tools/tuf/test](../tools/tuf/test/README.md))
2026-03-26 14:10:42 +00:00
Sharon Katz
5e54b86796
Improve fleetd agent release docs (#42359)
Add documentation for the full agent release process. 
Fleetd is composed of several components released through different
channels, and the handbook only linked to TUF. This adds references to
Android (Google Play), Chrome extension (Google Admin), and TUF version
tracking, with links to the relevant release guides for each.
2026-03-25 10:20:04 -04:00
George Karr
8db6768b64
Add instructions for enabling merge commits (#42313) 2026-03-24 20:14:50 -05:00
Luke Heath
0b15204914
Remove fleetd components release QA instructions (#42093) 2026-03-19 13:40:01 -05:00
Luke Heath
17a29f5485
Update release candidate creation date in README (#41681) 2026-03-13 15:55:44 -05:00
Noah Talerman
09590bc6e2
"Teams" => "fleets", "queries" => "reports" doc changes (#39585) 2026-03-11 23:41:14 -05:00
Luke Heath
27a0438cab
Update postmortem guidelines for clarity and completeness (#41392) 2026-03-10 15:04:44 -05:00
Luke Heath
466b7592ff
Handbook incident response process (#40436) 2026-02-27 17:32:43 -06:00
Victor Lyuboslavsky
d7f2c5dfd9
Add Windows OS coverage check (#40231) 2026-02-23 14:26:36 -06:00
Dale Ribeiro
0e979ee334
Fix typo in assignment instructions for incident response (#40064) 2026-02-19 10:33:28 -06:00
Luke Heath
057d2a32a1
Update incident assignment instructions in README (#40053) 2026-02-18 13:59:41 -06:00
Victor Lyuboslavsky
898dbf2b66
Updating scope of engineering-initiated stories. (#39969) 2026-02-17 15:53:54 -06:00
Noah Talerman
a79da99ad4
Engineering handbook: Remove outdated bit (#39960) 2026-02-17 15:46:51 -06:00
Noah Talerman
01e49d5a69
Eng handbook: Outdated engineering-initiated story (#39918) 2026-02-16 15:32:21 -06:00
Ian Littman
07c9f44cb0
Document QA day process (#39545)
This PR/handbook entry intentionally errs on the side of being
prescriptive on prioritization/per-ticket workflow, in case I have the
wrong idea on any part of this.
2026-02-09 12:12:06 -06:00
Noah Talerman
d5ba60db3e
Create "quick win" issue template and update handbook (#39081) 2026-02-03 13:06:51 -06:00
Luke Heath
604f04a8c3
Remove duplicate section (#38808) 2026-01-26 14:12:19 -06:00
Luke Heath
cf468cbfe3
Update on-call engineer handbook entries (#38641)
For [38235](https://github.com/fleetdm/fleet/issues/38235)

---------

Co-authored-by: Sharon Katz <121527325+sharon-fdm@users.noreply.github.com>
Co-authored-by: Ian Littman <iansltx@gmail.com>
2026-01-26 10:06:43 -06:00
Isabell Reedy
fcac359298
Handbook: org and responsibilities update (#38527)
Co-authored-by: Sam Pfluger <108141731+Sampfluger88@users.noreply.github.com>
2026-01-20 17:20:16 -07:00
Rachael Shaw
705663f826
Handbook: Small grammatical fix (#37643)
See https://github.com/fleetdm/fleet/pull/37476/changes#r2643746321

---------

Co-authored-by: Zay Hanlon <114112018+zayhanlon@users.noreply.github.com>
Co-authored-by: Ashish Kuthiala <53918208+akuthiala@users.noreply.github.com>
2026-01-15 11:00:48 -06:00
Luke Heath
76ef59ee02
Add new engineering rituals (#38136) 2026-01-13 18:21:30 -06:00
Noah Talerman
9219a30bc0
Move "Pre-sprint planning" & "Sprint kickoff review" rituals to Engineering (#38112) 2026-01-09 16:14:42 -06:00
Luke Heath
def6f29781
Updating engineering DRIs (#36987) 2025-12-09 13:49:18 -06:00
Luke Heath
9b46e4a973
Update release candidate process in README (#36811) 2025-12-05 17:40:09 -06:00
Nicolás
8a516e6155
Update README.md (#35115) 2025-11-04 11:21:53 -06:00
Noah Talerman
7aac43d24e
Engineering handbook: Notify stakeholders about pushed stories (#35131)
We first learn stories are likely to be pushed at standup, Engineering
Managers aren't at standup. Tech Leads are.
2025-11-03 17:59:44 -05:00
Noah Talerman
8d5ff92450
Engineering handhook (#34941) 2025-10-29 15:48:28 -05:00
Luke Heath
b4275ba7b2
Add guidelines for discussing release dates (#34892) 2025-10-28 15:58:28 -05:00
Luke Heath
bef0db5c8b
Revise DNS record management process (#34755) 2025-10-24 12:25:21 -05:00
Luke Heath
8fea6ac932
Update link to example finished document (#34753) 2025-10-24 12:11:13 -05:00
malomar124
14f6697c6d
Update README.md (#34538) 2025-10-20 15:03:19 -05:00
Luke Heath
dd8a81162d
Update engineering interview process (#33959) 2025-10-08 10:34:45 -05:00
Noah Talerman
3edec2d4b2
Engineering handbook: Update milestone due dates (#33933) 2025-10-07 10:14:29 -04:00
Jonathan Katz
e393c1a87c
Fix typo in README.md (#33871) 2025-10-06 11:42:35 -05:00
Noah Talerman
c435d9dce3
Engineering handbook: Conclude current milestone (#33863) 2025-10-06 09:12:56 -05:00
Noah Talerman
179aaceedb
Engineering handbook: 4 product groups (#33586) 2025-09-29 14:10:46 -05:00
Luke Heath
09ddbf9aea
Update product groups org (#33547) 2025-09-27 16:20:56 -05:00
Noah Talerman
7da144c3ba
Handbook processes: New major macOS version (#33046) 2025-09-16 18:42:23 -05:00
Janis Watts
83d90a5271
Change macOS 16 to macOS 26 (#32724)
Just changed macOS 16 to macOS 26, since macOS 16 isn't a thing
2025-09-09 10:36:01 -05:00
Magnus Jensen
4112ed1d3e
Update broken links for engineering.rituals.yml (#32059) 2025-08-21 16:34:02 -05:00