Skip to content

[deep-report] Auto-start docs server in docs-noob-tester workflow setup #33791

@github-actions

Description

@github-actions

Context

The 2026-05-21 docs-noob-tester report (discussion #33700) flagged a critical, blocking issue at step zero:

The server was not running when I started the task. I had to manually start it using the lifecycle management instructions.
Impact: Complete blocker — cannot test documentation without a running server.

The instructions say "the documentation server is already running at ..." — but it isn't. Every new-user pass spends turns getting unstuck before they can even evaluate docs quality.

Quick-win task

  1. Add an explicit Start docs server step at the top of docs-noob-tester.md (and any peer that consumes the local docs site) that runs the project's make docs-serve (or equivalent) in the background.
  2. Add a wait-for-port readiness probe before the agent step kicks off.
  3. Update the agent prompt so the assumption ("server is running") matches reality.

Success criteria

  • Next docs-noob-tester run reports no "docs server not running" critical issue.
  • The agent's narrative starts with content evaluation, not infra recovery.

References

Generated by 🔬 DeepReport - Intelligence Gathering Agent · ● 17.9M ·

  • expires on May 23, 2026, 4:03 PM UTC

Metadata

Metadata

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions