Skip to content

docs: add a scheduled whitebox scans guide - #110

Merged
zeyu2001 merged 2 commits into
mainfrom
docs/scheduled-whitebox-scans
Nov 7, 2026
Merged

zeyu2001 merged 2 commits into
mainfrom
docs/scheduled-whitebox-scans

Conversation

@zeyu2001

@zeyu2001 zeyu2001 commented Nov 7, 2026 •

Copy link
Copy Markdown
Member

Adds a dedicated Scheduled whitebox scans guide beside Remediation in the Automations navigation. The Automations overview introduces scheduling and links its trigger, scan action, environment scan settings, execution history, and related-docs card to the full guide. The guide links back to the overview.

The guide covers daily, weekly, monthly, and custom cron schedules, timezones, per-environment scan settings, login checks, enabling schedules, credit limits, skipped runs, and execution history. Whitebox quickstart, billing, and automation-credit links point directly to it. The overview keeps a short #scheduled-whitebox-scans section for existing links.

Content comes from landing #225 at 4f71ed506ce32ed74ea67029a0e89ce0b681cddb, with Mintlify components and docs-site routes. Product labels and key schedule, credit, and concurrency behavior were checked against web 1296a5739. Five light/dark product-shots captures are reused across the overview and guide. They show the actual frontend with sanitized mock data.

Validation: pnpm lint, pnpm exec mintlify broken-links, pnpm exec mintlify validate --telemetry false, git diff --check, and the normal GitGuardian commit hook.

Browser evidence: Chrome at 1440×1100 and 390×844; the new sidebar entry is active and sits between Remediation and Automation credits; three setup steps and two tables render on the new page; the correct screenshot loads in each theme; the mobile document width equals its 390px viewport. All nine overview links to the guide resolve, including setup/history anchors. Clicking Start whitebox scan opens the guide. Quickstart, billing, and automation-credit references return HTTP 200 and point to the new route. The run-history anchor lands below the fixed header, and the guide links back to the overview.

These checks cover rendered documentation. They do not launch product scans.


Note

Low Risk
Documentation and navigation only; no application or billing logic changes.

Overview
Adds scheduled whitebox scans to the docs site: a new platform/automations/scheduled-whitebox-scans page (ported from landing), linked from Automations nav in docs.json.

The Automations overview is expanded so automations can trigger on New vulnerability found (Apply Remediation) or On a schedule (Start whitebox scan), with updated step-by-step UI copy, settings tables, light/dark screenshots, and run-history notes for scheduled runs.

Automation credits now states remediation uses automation credits while scheduled scans draw Whitebox Scan credits. Whitebox billing and quickstart link scheduled scans and describe per-run estimates, credit caps, and Needs attention when a run can't start.

Reviewed by Cursor Bugbot for commit 018b04b. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Nov 7, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
hacktronai 🟢 Ready View Preview Nov 7, 2026, 1:18 AM

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

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 7, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-07T01:15:25.493656Z c00f7d2 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c00f7d282b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread platform/automations/overview.mdx Outdated
Comment on lines +125 to +126
<Step title="Set up the scan for each environment">
On the **Environments** tab, each environment now has **Set up scan** in place of the branch picker. Select it to open the environment's scan settings. They reuse the steps of the [Whitebox Scans wizard](/white-box-pentest/quickstart), with **Scan options** in place of the cost calculation and checkout:

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Show the scheduled scan-settings workflow

When a reader follows the newly documented scheduled flow, this step introduces Set up scan, six wizard pages, Save scan settings, and the required per-environment state, but none of the added images shows that UI; the only Environments image above shows the branch picker used for finding-triggered automations. Add a current screenshot, or a capture-blocked caveat, for this configuration path so readers do not have to guess through the central new workflow.

AGENTS.md reference: AGENTS.md:L6-L8

Useful? React with 👍 / 👎.

@zeyu2001 zeyu2001 changed the title docs: document scheduled whitebox scans docs: add a scheduled whitebox scans guide Nov 7, 2026
@zeyu2001
zeyu2001 merged commit 885e4ef into main Nov 7, 2026
8 checks passed

This branch was successfully deployed

1 active deployment
staging — 018b04b9 Deployed Nov 7, 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.

1 participant