fleet/docs/Contributing
Raiven 42a847d076
docs: Update Adding-new-endpoints.md (#28377)
# Checklist for submitter

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

<!-- Note that API documentation changes are now addressed by the
product design team. -->

- [ ] 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/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)
- [ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.
- [ ] If paths of existing endpoints are modified without backwards
compatibility, checked the frontend/CLI for any necessary changes
- [ ] If database migrations are included, checked table schema to
confirm autoupdate
- For 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`).
- [ ] Added/updated automated tests
- [ ] A detailed QA plan exists on the associated ticket (if it isn't
there, work with the product group's QA engineer to add it)
- [ ] Manual QA for all new/changed functionality
- For Orbit and Fleet Desktop changes:
- [ ] Make sure fleetd is compatible with the latest released version of
Fleet (see [Must
rule](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/fleetd-development-and-release-strategy.md)).
- [ ] Orbit runs on macOS, Linux and Windows. Check if the orbit
feature/bugfix should only apply to one platform (`runtime.GOOS`).
- [ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.
- [ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).
- [ ] For unreleased bug fixes in a release candidate, confirmed that
the fix is not expected to adversely impact load test results or alerted
the release DRI if additional load testing is needed.
2025-04-21 10:11:02 -05:00
..
assets SCIM integration tests (#27750) 2025-04-04 11:00:46 -05:00
research/mdm Docs v4.58.0 (#22769) 2024-10-17 17:51:52 -05:00
responsibilities/mdm Create certs.md (#27013) 2025-04-03 14:19:00 -05:00
Adding-new-endpoints.md docs: Update Adding-new-endpoints.md (#28377) 2025-04-21 10:11:02 -05:00
API-for-contributors.md Puppet module: remove guide and update docs (#28335) 2025-04-18 16:47:11 -04:00
API-Versioning.md Update API-Versioning.md (#27855) 2025-04-04 10:34:27 -05:00
Audit-logs.md Add host id to fleet enrolled activity (#28068) 2025-04-10 13:50:14 -07:00
Automatically-generating-UI-component-boilerplate.md Website: Add meta descriptions to Fleet documentation. (#12586) 2023-07-13 11:57:17 -05:00
Building-Fleet.md Bump Node version to 20.18.1 (#25591) 2025-01-20 15:50:28 -06:00
Committing-Changes.md Website: Add meta descriptions to Fleet documentation. (#12586) 2023-07-13 11:57:17 -05:00
Configuration-for-contributors.md Add detail_query_overrides to contributor docs (#24589) 2024-12-10 15:46:59 -05:00
Deploying-chrome-test-ext.md Enroll hosts docs improvements (#14862) 2023-11-20 19:39:41 +01:00
design-qa-considerations.md Create design-qa-considerations.md (#26774) 2025-03-07 15:32:41 -06:00
Enroll-hosts-with-plain-osquery.md Enroll hosts docs improvements (#14862) 2023-11-20 19:39:41 +01:00
FAQ.md List paths used by Fleet desktop (#23891) 2024-12-13 17:47:50 -06:00
File-carving.md Add docs for --dev default MinIO buckets (#21721) 2024-08-30 16:12:43 -05:00
Fleet-UI-Testing.md Website: Add meta descriptions to Fleet documentation. (#12586) 2023-07-13 11:57:17 -05:00
fleetctl-apply.md Agent configuration reference docs (#26999) 2025-03-10 13:36:44 -05:00
fleetd-development-and-release-strategy.md Docs: Replace Orbit with Fleetd (#12443) 2023-07-21 19:33:31 -05:00
high-level-architecture.md Tweaks to high level Fleet diagram. (#27749) 2025-04-02 11:34:51 -05:00
Infrastructure.md Handbook/company/leadership#structure-of-departmental-handbook-pages (#14811) 2023-11-21 13:55:46 -06:00
MDM-Android.md Update MDM-Android.md -- improve class diagram display (#27538) 2025-03-26 13:09:49 -05:00
MDM-custom-configuration-web-url Add page to contributor docs for custom configuration web URL (#17081) 2024-02-27 09:06:35 -05:00
MDM-Custom-SCEP-Integration.md Updating DigiCert/SCEP contributor docs. (#27625) 2025-03-31 13:50:05 -05:00
MDM-DigiCert-Integration.md Updating DigiCert/SCEP contributor docs. (#27625) 2025-03-31 13:50:05 -05:00
MDM-end-user-authentication.md SCIM integration tests (#27750) 2025-04-04 11:00:46 -05:00
MDM.md Puppet module: remove guide and update docs (#28335) 2025-04-18 16:47:11 -04:00
Migrations.md Website: Add meta descriptions to Fleet documentation. (#12586) 2023-07-13 11:57:17 -05:00
Patterns-backend.md Move backend patterns.md to docs/Contributing (#28243) 2025-04-16 13:36:14 -05:00
README.md Add docs for upgrading Go (#27693) 2025-04-02 15:30:32 -05:00
Releasing-Fleet.md Terraform cleanup (#26379) 2025-02-24 17:35:50 -05:00
Run-Locally-Built-Fleetd.md Docs: add syntax highlighting keywords to code blocks (#13963) 2023-09-22 16:57:40 -05:00
SCIM-integration.md SCIM + host integration (#27880) 2025-04-08 09:35:06 -05:00
Seeding-Data.md Docs: add syntax highlighting keywords to code blocks (#13963) 2023-09-22 16:57:40 -05:00
set-up-custom-end-user-email.md add internal docs to set end user email (#16573) 2024-02-02 18:13:07 -03:00
Simulate-slow-network.md Remove unused toxiproxy service (#21554) 2024-08-26 13:28:51 -03:00
Teams.md Add contributor docs to document the teams/no team conventions (#24569) 2024-12-10 10:19:28 -05:00
Testing-and-local-development.md Puppet module: remove guide and update docs (#28335) 2025-04-18 16:47:11 -04:00
Troubleshooting-live-queries.md Move "Troubleshooting live queries" page to contributors docs (#16775) 2024-02-19 16:39:12 +01:00
Understanding-host-vitals.md fix: change how macOS software names are calculated to avoid erroneous duplicates (#28037) 2025-04-11 19:19:07 -04:00
Upcoming-activities.md Cancel upcoming activities: create past canceled activities (#27956) 2025-04-09 16:08:51 -04:00
Upgrading-go-version.md Add docs for upgrading Go (#27693) 2025-04-02 15:30:32 -05:00
Vulnerability-processing.md Update vulnerability processing docs to reference goval-dictionary (#21536) 2024-08-26 21:38:03 -05:00
windows-mdm-glossary-and-protocol.md Windows MDM Fix Manual Detection (#17721) 2024-03-21 15:09:05 -04:00

Contributing

Building Fleet

Learn about building the code, development infrastructure, and database migrations.

Build and run Fleetd from local code

Building and running your modified code.

Testing

Look at Fleet's full test suite and integration tests.

Migrations

Learn about creating and updating database migrations.

Committing changes

Learn how to merge changes into the codebase.

Releasing Fleet

Learn the process for how to release Fleet.

Seeding data

Learn how to add fake data to your development instance.

API for contributors

Get to grips with Fleet API routes. This documentation is helpful for developing or contributing to Fleet.

Deploying ChromeOS test extensions

Learn how to deploy a test version of the fleetd Chrome extension for debug purposes.

Upgrading the Go version

Learn how to update the version of Go used to build Fleet.

FAQ

Find commonly asked questions and answers about contributing to Fleet as part of our community.