Skip to content

docs(host): add 48-hour maintenance window banner to maintenance pages - #958

Merged
hanran-y merged 2 commits into
mainfrom
feat/docs-6q0
Sep 29, 2026
Merged

hanran-y merged 2 commits into
mainfrom
feat/docs-6q0

Conversation

@hanran-y

@hanran-y hanran-y commented Sep 28, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Every page in the host Maintenance group (except Set a Maintenance Window itself) now opens with the same red banner:

Before you start: schedule a maintenance window at least 48 hours in advance.

You are responsible for the maintenance and any resulting interruption. Work performed outside the scheduled maintenance window may be treated as an operational failure.

If you are unsure whether this operation could cause data loss, stop here.

Changes

  • host/upgrade-kernel.mdx: banner added; intro Warning keeps the reboot facts (instances are stopped, not destroyed); its maintenance-window sentences are removed, since the banner covers them.
  • host/upgrade-docker-and-packages.mdx: banner added; step 1 Warning keeps the Docker restart and reboot facts; its maintenance-window sentences are removed. Check commands and the later "If anything is rented" Warning kept.
  • host/disable-ssh-password-login.mdx: banner added.
  • No change to host/set-maintenance-window.mdx or docs.json.

Verification

  • Banner is byte-identical on all three pages.
  • Rendered locally with mint dev: red Danger callout, link works.

- Add the same red Danger banner at the top of upgrade-kernel, upgrade-docker-and-packages and disable-ssh-password-login: schedule a maintenance window at least 48 hours in advance (links to /host/set-maintenance-window), the host is responsible, stop if unsure about data loss.
- Remove the two Warnings the banner replaces (upgrade-kernel intro, upgrade-docker-and-packages step 1).
- No change to set-maintenance-window or docs.json.

Verified: gates pass; banner byte-identical on all three pages; rendered locally with mint dev.
@mintlify

mintlify Bot commented Sep 28, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
vastai-80aa3a82 🟢 Ready View Preview Sep 29, 2026, 12:05 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

- upgrade-kernel: restore the intro Warning about the reboot stopping instances (instances are not destroyed); only the maintenance-window sentences stay removed, since the banner covers them.
- upgrade-docker-and-packages: restore the step 1 Warning about the Docker restart and reboot stopping every instance, trimmed the same way.

Verified: gates pass; restored text is verbatim from main.
@hanran-y
hanran-y marked this pull request as ready for review September 29, 2026 00:04
@hanran-y hanran-y self-assigned this Sep 29, 2026
@hanran-y
hanran-y requested review from bach-vast-ai, jacobmattern and michele-cloud and a balanced review from Copilot and removed request for Copilot September 29, 2026 00:07

@jacobmattern jacobmattern left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 👍

@hanran-y
hanran-y merged commit 8eadf37 into main Sep 29, 2026
2 checks passed
@hanran-y
hanran-y deleted the feat/docs-6q0 branch September 29, 2026 00:16

This branch was successfully deployed

1 active deployment
staging — 7650e969 Deployed Sep 29, 2026 by mintlify[bot]
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