Commit Graph

132 Commits

Author SHA1 Message Date
Luke Heath
fa8d1fcb00
Update engineering handbook to reflect new bug branch strategy (#17986) 2024-04-01 15:36:46 -05:00
George Karr
c739ed2472
Update Releasing-Fleet.md (#16725)
Updating broken link

---------

Co-authored-by: Sam Pfluger <108141731+Sampfluger88@users.noreply.github.com>
2024-03-26 12:02:09 -05:00
Luke Heath
d2b6d579a2
Update engineering handbook to adjust patch release process (#17571)
This outlines a new patch branching strategy to avoid the conflicts
we've been running into recently.

This will introduce more friction in the form of two PRs for released
bug fixes during patch weeks. The benefit is that we won't have to deal
with merge conflicts when we're cherry-picking commits into the patch
branch, which sometimes becomes a big distraction for the team.

We also found ourselves in a situation with 4.46.3 where we couldn't
release a fix without rewriting it because it had been built on top of
feature code that was not included in the patch. That was the motivation
to make this change.

---------

Co-authored-by: George Karr <georgekarrv@users.noreply.github.com>
Co-authored-by: Sam Pfluger <108141731+Sampfluger88@users.noreply.github.com>
2024-03-18 15:17:08 -05:00
Eric
224a5f89bd
Handbook: Fix broken links in handbook. (#17643)
Changes:
- Fixed two broken links on the digital experience handbook page
- Updated link text and removed a broken link on the engineering
handbook page.
2024-03-14 17:02:00 -05:00
Noah Talerman
3ba6bb50c4
Update Engineering handbook (#17628) 2024-03-14 11:29:04 -05:00
Sam Pfluger
7e4964385c
DRIs (#17614)
...
2024-03-14 10:24:53 -05:00
Luke Heath
bb7da24ea1
Add open QA Engineer position (#17561) 2024-03-12 15:07:36 -05:00
Luke Heath
c1a274f76d
Move critical bug notification process to product groups page (#17299)
Also updated the language in the notification process slightly so that
we only notify impacted customers and the community if community
features are impacted.
2024-03-01 16:29:02 -06:00
Luke Heath
8d7e3472e7
Add priority rating labels to product groups handbook (#17103) 2024-02-28 11:17:31 -06:00
Eric
fa6d6cbf2b
Handbook: update rituals (#17090)
Changes:
- Removed Markdown links from ritual descriptions (and added them to the
moreInfoUrl value of the rituals)
- Updated the "Generate merged schema" ritual to be weekly, and added a
`moreInfoUrl` value.
- Fixed the ritual table on the sales handbook page.

---------

Co-authored-by: Sam Pfluger <108141731+Sampfluger88@users.noreply.github.com>
2024-02-22 14:12:47 -06:00
Luke Heath
e5a376fb05
Update freeze ritual notes (#17050) 2024-02-21 16:09:57 -06:00
Sam Pfluger
9d03b952b2
Update communications.md (#16978)
...
2024-02-20 00:32:49 -06:00
Sam Pfluger
1f5a31d853
Merge website content to digital experience (#16975)
...
2024-02-19 18:26:22 -06:00
Sarah Gillespie
64b85f87f7
Restructure "Scaling Fleet" handbook page for ease of reference (#16850)
This PR consolidates various subheadings into one list that appears
"above the fold" to make it easier for contributors to find the info
they are looking for on the page. As it was previously, important info
was getting buried under the "Connect to Dogfood" instructions, which
gave the wrong impression about the scope of the page content.
2024-02-15 22:24:03 -06:00
Luke Heath
4eb477b4a1
Fix broken link (#16799)
...

---------

Co-authored-by: Sam Pfluger <108141731+Sampfluger88@users.noreply.github.com>
2024-02-14 01:45:19 -06:00
Luke Heath
b51c42009f
Add new responsibilities to engineering handbook (#16755) 2024-02-13 13:12:09 -06:00
Luke Heath
d65b910103
Clarify exception process for release freeze (#16607) 2024-02-06 15:31:53 -06:00
George Karr
af354863d6
Update engineering handbook README.md with deep freeze (#16550)
...

---------

Co-authored-by: Luke Heath <luke@fleetdm.com>
2024-02-01 22:24:28 -06:00
Sam Pfluger
46334d1bf5
#g-ceo to g#digital-experience (#16445)
...

---------

Co-authored-by: Eric <eashaw@sailsjs.com>
2024-01-30 16:58:09 -06:00
Eric
43f21baa86
Website: Update script to create GH issues for rituals in YAML files. (#15752)
Closes: #14246

Changes: 
- Added a new key to the rituals YAML configuration: `autoIssue.repo`.
This value should be a string that is the name of the GH repo that
issues for the ritual should be created in.
- Updated ritual validation in `build-static-content`.
- Added support for the "monthly" ritual frequency for rituals with an
`autoIssue` value.
- Updated the `create-issues-for-todays-rituals` script to create GitHub
issues for rituals.

---------

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
Co-authored-by: Sam Pfluger <108141731+Sampfluger88@users.noreply.github.com>
2024-01-15 12:53:53 -06:00
Sam Pfluger
112c2d0f43
Handbook: remove bugs board link from "Contact us" section (#16058)
Removed "🪲 Bugs board" link from "Contact us" section and added links to
product group kanban boards.
2024-01-12 10:12:21 -06:00
Luke Heath
57aa09521c
Update postmortem documentation (#16033)
We will begin conducting postmortems for critical bugs in addition to
outages.

1. How was the bug introduced?
2. What is the gap in our testing process that we didn't find the bug
before it was released?
3. How are we going to change our testing (both manual and automated) so
that we will catch a similar bug in the future?

Why? We want to start evaluating the three questions above for every
critical bug so that we can learn and improve our processes.
2024-01-10 20:15:42 -06:00
Noah Talerman
5f38355169
Merge fleetd doc page to enroll hosts page (#15907)
- Move relevant content from "Fleetd" doc page to "Enroll hosts" page
- Remove "Fleetd" docs page
2024-01-10 14:35:18 -05:00
Sam Pfluger
b2899c402e
Handbook/company/leadership#structure-of-departmental-handbook-pages (#14811)
- Add Isabell to team table
- reorder contact-us in leadership page
- Standardize "Contact us" on all departmental pages
- Convert all responsibilities to imperative mood verb phrase
- Untangle and deduplicate Engineering <> Product groups <> Product

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-11-21 13:55:46 -06:00
Luke Heath
d5885a4706
Update engineering handbook page (#15149)
Updating title to match the rest of the org.
2023-11-14 15:47:43 -06:00
Eric
ab71a272ae
Handbook: Add ritual for checking osquery Slack invitation link. (#15091)
Related issue: https://github.com/fleetdm/fleet/issues/15089

Changes:
- Added a new engineering ritual to check the Slack invitation linked to
from Fleet and the Fleet website. (Slack invitations expire after 400
people have accepted the invitation)
2023-11-10 13:27:51 -06:00
Luke Heath
91db043094
Use go variable to set version in workflows (#14890) 2023-11-03 09:42:27 -05:00
fredjohnsen
f5d5c91959
Fixed grammatical error (#14910)
...
2023-11-02 21:20:46 -05:00
Sampfluger88
0c30bc2b0b
Create customer-success.md (#14697)
...

---------

Co-authored-by: Zay Hanlon <114112018+zayhanlon@users.noreply.github.com>
Co-authored-by: Luke Heath <luke@fleetdm.com>
Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-11-02 11:06:30 -05:00
Luke Heath
59d002caae
Update freeze ritual and release readiness (#14868) 2023-11-01 15:25:02 -05:00
Noah Talerman
b72badccce
Update product DRIs and rituals (#14690)
- "Head of Product" => "Head of Product Design"
- #help-product => #help-product-design
- "Sprint kickoff review" is now one ritual that includes both MDM and
Endpoint ops teams
- "Pre-sprint prioritization" ritual is now one ritual that includes
both MDM and Endpoint ops teams
- Remove "Sprint release notes kickoff" ritual. Plan is to inform
#g-demand of new features asynchronously. Any discussion that needs to
happen live will happen at product office hours
- Remove "Report number of estimated stories (Endpoint ops))" and
"Report number of estimated stories (MDM)" rituals. One person (Head of
Product Design) is both reporting and tracking product KPIs
- Remove "Bug de-prioritization" ritual. Trying this instead: ~~CEO,~~
Head of Product Design, and Head of Product Development align on next
steps for which bugs to schedule into the next sprint and which can be
de-prioritized during the "Churned bug review" ritual. Less meetings.

---------

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-10-23 13:45:30 -05:00
Mike McNeil
bae8e9a600
Handbook: Clarify mdmctl (#14702) 2023-10-23 13:37:21 -05:00
Eric
4a6bf0d447
2023-10-24 Website: Update /try-fleet (#14638)
Closes: https://github.com/fleetdm/confidential/issues/4015

Changes:
- Changed the url for `/fleetctl-preview` to
`/try-fleet/fleetctl-preview`
- Updated the controller for the `/fleetctl-preview` page to redirect
non-logged-in users to `/try-fleet/login`
- Removed the route for `/try-fleet/sandbox-expired`, and added a
redirect going to `/try-fleet/fleetctl-preview`.
- Updated the controller for `/try-fleet/sandbox` to redirect the users
without a non-expired Sandbox instance to `/try-fleet/fleetctl-preview`.
- Updated `signup.js` to not provision Fleet sandbox instances for
users.
- Updated the `User` model to support a third `signupReason`: "Try
Fleet"
- Updated `/try-fleet/register` to submit "Try Fleet" as a
`signupReason` when users sign up.
- Renamed the files for the `/fleetctl-preview` page (`get-started` »
`fleetctl-preview`)
- Updated/removed Fleet Sandbox related handbook sections.
- Replaced the "Fleet vs Fleet Sandbox" section in the deploying
documentation with a note about `fleetctl preview`.
- Updated links to Fleet Sandbox in articles.

---------

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2023-10-20 13:59:18 -05:00
Lucas Manuel Rodriguez
99d131e96e
Fix not found link in the handbook (#14650)
...
2023-10-19 12:19:46 -05:00
Luke Heath
52f84d2233
Update engineering rituals (#14629)
...
2023-10-18 20:58:25 -05:00
Mike McNeil
8efac8b648
2023-10-17 Handbook: Product groups: Endpoint ops (#14589)
- Rename CX team => Endpoint ops
2023-10-18 15:56:53 -04:00
George Karr
c360d75c06
Add engineering specific Hiring process that was previously undocumented. (#14511) 2023-10-16 18:15:50 -05:00
George Karr
a8b790c617
2023-10-13 Add Certificate renewal steps to engineering handbook (#14501)
Adding the annual ritual to make sure our Cert is always valid for new
customers to generate Push certificates. ...

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-10-16 17:16:16 -05:00
Luke Heath
db93da95a8
Update sprint demos description (#14532)
I want to highlight: 

1. That we only demo features, improvements, and bug fixes. (not all
accomplishments might be unrelated to the release)

2. Specify that we want the content of the presentations to be
accessible to everyone and not too technical.

---------

Co-authored-by: George Karr <georgekarrv@users.noreply.github.com>
2023-10-14 16:57:43 -05:00
Luke Heath
eaa0fdda24
Update oncall engineer expectations (#14457)
.
2023-10-11 23:15:27 -05:00
Luke Heath
1511354766
Typo fix (#14421) 2023-10-10 13:47:37 -05:00
Sampfluger88
f108e997ba
Handbook: Engineering (update to new structure) (#14369)
Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-10-09 21:42:45 -05:00
Isabell Reedy
1555d09f57
2023-10-05 Handbook: add process for inter-team assistance on bugs (#14235)
1. Process to formalize how we prioritize bugs across teams, recognize a
bug's origin, and indicate the team who is currently working on it.
2. Formalize that this coordination will happen at a joint sprint
kick-off review (there are currently separate sprint kick-off reviews
for each team).

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-10-07 10:18:00 -05:00
Luke Heath
cd34763c43
Fix broken link (#14332) 2023-10-05 14:59:49 -05:00
Martin Angers
a223cbc5c2
Update scaling-fleet.md (#14285)
Fix link to the list of tables referencing the hosts table (for manual
cleanup).
2023-10-04 22:35:18 -05:00
Luke Heath
1e1e28791f
Document milestone release ritual (#13932) 2023-09-25 14:35:36 -05:00
George Karr
0d95528378
Add policy for PRs to engineering handbook (#13898) 2023-09-13 10:26:49 -05:00
Luke Heath
4f82684198
Update oncall rotation documentation (#13888) 2023-09-12 14:18:01 -05:00
Luke Heath
d260817437
Update Eng Leadership (#13881) 2023-09-12 12:57:05 -05:00
Mike McNeil
b436fc71e2
2023-09-08: Handbook: Engineering: Bug states (#13818) 2023-09-12 10:20:38 -05:00