Write usage guide for the scheduled maintenance feature

[lukeheath]

Goal

User story
As a Fleet admin that wants to use the scheduled maintenance feature,
I want to read a usage guide that explains Fleet's best practice usage
so that I understand how the feature is expected to work.

Instructions for writing a usage guide are here: https://github.com/fleetdm/fleet/pull/20668/files

Context

• Requestor(s): @lukeheath

Related tickets

• This ticket is to create an official guide
• Scheduled maintenance announcement is out-of-date #20416 is to fix any text copy changes on the announcement that are out of date
• Update maintenance window graphic on fleetdm.com #20680 is to fix any image changes that are out of date

[lukeheath]

@sharon-fdm I realized we don't have a guide for the scheduled maintenance feature. We'll need to write and publish one before we release 4.55, so I'm creating this P2 release blocker to track the request. Please estimate this and assign out. We have a specific process for writing these using a template. Instructions for writing a usage guide are here: https://github.com/fleetdm/fleet/pull/20668/files. Will be in the engineering handbook soon. Thanks!

[RachelElysia]

@sharon-fdm - Said he'll talk to @lukeheath about updating the reference AND/OR creating a guide as described above

[RachelElysia]

@getvictor recording 7/31 incoming

[sharon-fdm]

@RachelElysia, as agreed, we will do both a Guide and update the ref doc.

[sharon-fdm]

@getvictor please review the document when you can.

[noahtalerman]

Hey @lukeheath! I'm going over issues in confirm and celebrate column and I noticed that we decided to hold the guide: #20974 (comment)

What do you think we should do with this issue? We could leave it in confirm and celebrate until we're ready to ship the guide.

I think we could also ship the guide. I'm not sure why we want to wait for OS updates improvement. We don't mention OS updates in the guide: https://github.com/fleetdm/fleet/pull/20974/files

[lukeheath]

@noahtalerman I think we have to hold it in confirm and celebrate so we don't forget to come back and publish it. Mike asked us to remove all scheduled maintenance content until we're confident in the OS upgrade workflow.