Skip to content

docs(doc-review): daily review 2026-11-10 — trading calendars & half trading days, team dispatch targets, service-calendar limit - #1178

Open
flashduty[bot] wants to merge 1 commit into
mainfrom
doc-review/2026-11-10T081140Z
Open

flashduty[bot] wants to merge 1 commit into
mainfrom
doc-review/2026-11-10T081140Z

Conversation

@flashduty

@flashduty flashduty Bot commented Nov 10, 2026 •

Copy link
Copy Markdown

Doc Review — 2026-11-10

Mode: diff (since 2026-11-09T09:20:05Z, ≈23h → 2026-11-10T08:11Z)
Findings: 9 total — 0 high, 7 medium, 2 low (7 applied in this PR, 1 cross-repo follow-up, 1 held for a human)

Changes

Finding Type Module Doc Action
f001 config_drift on-call `zh en/on-call/configuration/service-calendar.mdx`
f002 missing_coverage on-call `zh en/on-call/configuration/service-calendar.mdx`
f003 feature_drift on-call `zh en/on-call/channel/escalation-rule.mdx`
f004 feature_drift on-call `zh en/on-call/channel/noise-reduction.mdx`
f005 stale_content on-call `zh en/on-call/incident/escalate-dispatch-incident.mdx`
f006 stale_content on-call `zh en/on-call/incident/what-is-incident.mdx`
f007 missing_coverage derivative (docs changelog) `zh en/changelog/changelog.mdx`
f008 missing_coverage derivative (website changelog) — Not applied here: target_repo: flashduty-website, see Cross-repo follow-ups
f009 missing_coverage derivative (comparison page) — Held: the row needs verified competitor cells, which cannot be derived from code

Review checklist

  • Verify config field names and defaults match current code — every number in this PR comes from source: 20 (maxCalInOneAccount, MAX_PERSONAL_CALENDARS), 20 teams / 100 people (AssignedTo.TeamIDs binding lte=20, scopeAssignTargets), HK 12:00 + US 13:00 half-day closes and the 09:30-15:00 / 09:30-16:00 sessions (TimeRange.tsx, exchangecal/hk.go)
  • Check that feature descriptions accurately reflect user-facing behavior — console labels were read from the shipped i18n JSON (pages/ServiceCalendar/locales/*, pages/Channel/locales/*), not invented
  • Ensure tone and style match the rest of the docs
  • Confirm the half-day rule reads well on the page that owns it (service-calendar.mdx) while the two policy pages only link to it
  • Decide whether "交易日历" as a separate bullet in 生效时间 should instead be folded into the 服务日历 bullet — it is a separate option in the picker today, but the console groups both under one calendar selector

Cross-repo follow-ups (flashduty-website)

  • f008 — website changelog. Surface: content/changelog/. Feature: exchange trading calendars (A-share / HK / US) usable as a service-calendar link or as an escalation/silence time condition, plus half trading days and the service-calendar limit 5 → 20. Action: add a dated .mdx + .zh.mdx pair. The newest existing pair is 2026-11-08-341213.*, so nothing covers this release (calendars seeded 2026-11-05, console work landed 2026-11-09/10).

Mapping warnings

  • fc-pgy: the service-calendar backend (cmd/server/controller/calendar, logic/calendar, structs/calendar.go, deploy/holiday.sql) is not in mapping.yaml at all — this whole PR's evidence lives outside the mapping. Suggest adding it under the on-call module.
  • fc-event: cmd/server/controller/incident and cmd/engine/controller/alert are unmapped although they changed this window. This round scanned them manually (the team-assignment changes are in logic/incident/assign.go, which is mapped).
  • flashduty-docs: derivative_surfaces.comparison_page points at zh|en/on-call/quickstart/comparison.mdx, which does not exist; the real files are zh|en/on-call/comparison/vs-pagerduty.mdx and vs-opsgenie.mdx.
  • fc-foundation-app: submodule src/Packages/ai-kit declares git@github.com:flashcatcloud/ai-kit.git, which has no remote (git clone fails, recorded in repos_skipped).

Skipped

Validation

  • mint broken-links → success no broken links found (exit 0), run with the branch working tree after all edits.
  • jq empty docs.json → clean. No pages were created, renamed or moved, so no docs.json navigation or redirect changes were needed.
  • Changed-file list vs not-checked list (comm -12) → empty intersection; all 12 changed files were read against source.
  • Diff size: 12 files changed, 60 insertions(+), 10 deletions(-) (6 zh + 6 en, all authored zh-first then derived).

…rading days, team dispatch, calendar limit

- service calendars: limit 5 -> 20 and drop the 'contact support' remedy
- service calendars: document half trading days (HK 12:00, US 13:00, A-shares none)
- escalation rules / silence rules: trading calendar as a direct time condition,
  交易日/休市日 labels, pre-filled exchange session, half-day post-close counts as rest
- incidents: teams are a direct-assign / responder target (snapshot expansion,
  max 20 teams, max 100 people after expansion)
- changelog: entry for trading calendars and the raised service-calendar limit

This branch has not been deployed

No deployments
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.

0 participants