Skip to content

docs(release-skill): add feature walkthrough threads to the announcement style - #1091

Merged
AJ Alon (ajalon1) merged 2 commits into
datarobot-oss:mainfrom
ajalon1:aj/release-announcement-thread-style
Nov 21, 2026
Merged

AJ Alon (ajalon1) merged 2 commits into
datarobot-oss:mainfrom
ajalon1:aj/release-announcement-thread-style

Conversation

@ajalon1

@ajalon1 AJ Alon (ajalon1) commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

RATIONALE

The v0.20.0 auth-profiles announcement in #dr-cli used a longer format than the style guide described: a main post plus seven thread replies, one per real-life use case. This records what worked, so the next headline feature (or the next agent running the release skill) can reuse it without rediscovering it.

Thread: https://datarobot.slack.com/archives/C01F2KWLYBG/p1794549397954499

CHANGES

All changes are in .factory/skills/release/references/announcement-style.md (also reachable through the .claude/skills/release symlink):

  • New "Feature walkthrough threads" section:
    • Show the plan and agree on use cases and example names before drafting.
    • One real-life use case per reply.
    • Correct an earlier announcement's claim in the thread.
    • Link demo docs by release tag.
    • Keep internal hostnames out of examples.
  • Thread patterns: fold a patch release into the last reply of the release it follows when that release's announcement was deferred (v0.20.1 inside the v0.20.0 thread).
  • New "Posting with the Claude.ai Slack connector" section: slack_send_message takes standard markdown, replies need thread_ts from the main post, and replies go out one at a time to keep their order.
  • Verification checklist:
    • Build the release tag and run quoted output against an offline scratch config.
    • Name the scratch config something other than the real config file name (agent hooks may block that name).
    • Test confirmations with and without --yes. That check found ALIFE-1473.

TESTING

Docs-only change. Re-read the rendered markdown; no code or behavior changes.

RELATED

🤖 Generated with Claude Code

…ent style

Capture what worked for the v0.20.0 auth-profiles announcement in #dr-cli so
the next headline feature can reuse it:

- A "Feature walkthrough threads" section: show the plan and agree on use
  cases and example names first, one real-life use case per reply, correct an
  earlier announcement's claim in the thread, link demo docs by release tag,
  and keep internal hostnames out of examples.
- Fold a patch release into the last reply of the release it follows when
  that release's announcement was deferred.
- Posting mechanics for the Claude.ai Slack connector: standard markdown, a
  thread_ts taken from the main post, and replies sent one at a time to keep
  their order.
- Verification: build the release tag and run quoted output against an
  offline scratch config, and test confirmations with and without --yes.
@ajalon1
AJ Alon (ajalon1) marked this pull request as ready for review November 21, 2026 01:27
@ajalon1
AJ Alon (ajalon1) requested a review from a team as a code owner November 21, 2026 01:27
Co-authored-by: AJ Alon <aj.alon@datarobot.com>
@datarobot-pr-review-router

Copy link
Copy Markdown

Code Ownership

Agent Lifecycle

  • .factory/skills/release/references/announcement-style.md

Review requested from the teams above. Labels will be removed automatically upon approval.

@ajalon1
AJ Alon (ajalon1) merged commit ee3261a into datarobot-oss:main Nov 21, 2026
24 checks passed
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