Skip to content

docs(blog): polish serverless agent runtimes article - #4841

Open
Astro-Han wants to merge 1 commit into
apache:mainfrom
Astro-Han:docs/polish-serverless-blog
Open

docs(blog): polish serverless agent runtimes article#4841
Astro-Han wants to merge 1 commit into
apache:mainfrom
Astro-Han:docs/polish-serverless-blog

Conversation

@Astro-Han

Copy link
Copy Markdown
Contributor

Summary

Follow-up polish for the Serverless Agent Runtime blog (#4838):

  • Strictly retain the original technical definitions, systems boundaries, and architectural comparisons across OpenSandbox, CubeSandbox, and Agent Substrate.
  • Refine prose style across both docs/blogs/serverless-agent-runtime.zh-CN.md and docs/blogs/serverless-agent-runtime.md:
    • Replace repetitive formulaic "不是……而是……" / "not X, but Y" negation-first contrasts with direct, authoritative systems descriptions.
    • Remove informal phrasing and rhetorical filler while preserving every qualifying note and citation.
    • Maintain 0 em-dashes across both Chinese and English prose.
  • Preserve 100% line-by-line mirror parity (367 lines in each file) and exact footnote references.

Refs #4838

Verification

  • git diff --check origin/main...HEAD (clean)
  • npm run check:asf-headers (clean)
  • Verified 0 em-dashes and 0 formulaic contrast patterns across both markdown documents.
  • Automated tests were not run because this is a documentation-only wording refinement.

AI use

Select exactly one:

  • No generative tool made a substantive contribution
  • Generative tooling made a substantive contribution

Tool(s) and scope:

  • Gemini: Assisted with editorial polish, style check verification, and bilingual line parity alignment.

Checklist

  • Tests cover the change and fail without it
  • Lint, format, typecheck and the affected suites pass locally

Does this PR entail a change in behavior?

  • Yes — described under Summary above
  • No

@github-actions github-actions Bot added the effort/M Under 500 readable lines label Sep 5, 2026

@Astro-Han Astro-Han left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Reviewed current head 4dd45963ab4b7d08471e8478b4383b17599655f3 (OPEN, MERGEABLE/BLOCKED awaiting human review). One P2 plus two P3s below, no P0/P1. Docs-only public content (the .md plus its .zh-CN.md, parallel changes both sides); checks green on this head.

P2 — the "this article does not rank the three projects" neutrality statement was deleted, in both languages

Before: "This article does not attempt to rank the three projects. Instead, it uses them to examine how Agent Runtimes are reshaping Serverless." / "本文不打算给三个项目打分,而是借它们理解 Agent Runtime 正在怎样改写 Serverless." After: "This essay analyzes how these three architectures navigate systems trade-offs and reframe the design boundaries of Serverless for Agent Runtimes." The explicit neutrality stance is gone in both files (searched: no rank/打分/排名/优劣 anywhere after) — a consistent, deliberate deletion, not an omission. Why a human should decide: the article publicly names three real third-party projects (OpenSandbox, CubeSandbox, Agent Substrate). That sentence was a posture statement — "we are not ranking". Without it, the piece reads from "using three examples to explain principles" as "analyzing three architectures' trade-offs", and readers are likelier to read the comparisons as evaluations. No disparaging language appears, so this is not a content problem — it is a public-positioning question, beyond what a reviewer should decide for the author. If deliberately cut, fine — flagged so it is seen; if lost in the rewrite, consider restoring.

P3s (non-blocking)

  • One rewrite changes meaning, in the core definition paragraph: "when the work is done, the caller no longer owns that machine" → "when demand ceases, the caller releases the underlying machine". "No longer owns" is passive/platform-driven; "releases" implies the caller performs a release action — while the whole point of Serverless is that the caller does nothing. Same paragraph shortens resource execution contract to resource contract, dropping a meaningful qualifier (it governs execution-time binding, not resources in general).
  • Overall terminology density rose noticeably (e.g. multi-tenant scheduling → multi-tenant bin-packing). Whether that counts as "polish" is a human call.

What I could not judge

The 84 changed Chinese lines were structurally checked only, not line-by-line against the English — the P3s above rest on the English version; whether the Chinese carries matching drift needs a dedicated pass.


Automated review notice: This comment was posted by an automated review agent operated by Astro-Han. It is not an independent human review and does not replace one.

简体中文

本条结论全部来自 @Opus-Qronos-AstroHan 的审查。我自己没有读这份 diff;我核的是当前 head 有没有漂移。当前 head 是 4dd4596,未关闭。纯文档润色,一条 P2:删掉的"不打分"中立声明该由人定夺不该代定,另有两条小的措辞提醒。等人类拍板。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

effort/M Under 500 readable lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant