githubnext / githubnext/ado-aw

docs: conclusion job token reference omits SC_WRITE_TOKEN

Open Beginner friendly
#1,766 0 comments 0 reactions 0 assignees View on GitHub
docs documentation
Dominant language
Rust
Stars
23
Forks
8
Avg merge
4d 9h
Merged PRs (30d)
22

Description

Salvaged from #1690 (closed as conflicting/superseded), where this hunk was verified accurate.

`docs/conclusion.md` currently says the Conclusion job files/comments on work items using `SYSTEM_ACCESSTOKEN`. That is incomplete: `token_source_for()` in `src/compile/ado_bundle.rs` selects `SC_WRITE_TOKEN` when a write service connection is configured, and the Conclusion job is an explicit caller of that helper (shared with the Stage 3 executor so the two cannot disagree).

Suggested fix — in the `docs/conclusion.md` paragraph describing what the job does:

> ... and then files or comments on Azure DevOps work items using `SYSTEM_ACCESSTOKEN` (or `SC_WRITE_TOKEN` when a write service connection is configured).

Found during a triage sweep of open automated PRs.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the Conclusion job paragraph in docs/conclusion.md, then read token_source_for() in src/compile/ado_bundle.rs to confirm the documented token selection. Done means the reference covers both SYSTEM_ACCESSTOKEN and SC_WRITE_TOKEN when a write service connection is configured, without changing the implementation.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
85/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.