Skip to content

docs: Update incremental build skill - #1689

Open
RandomByte wants to merge 2 commits into
mainfrom
docs/incremental-build-descriptor-api
Open

RandomByte wants to merge 2 commits into
mainfrom
docs/incremental-build-descriptor-api

Conversation

@RandomByte

Copy link
Copy Markdown
Member
  • docs(project): Correct task descriptor factory API in incremental-build reference
  • docs(project): Document build-tag scoping to the executing project

…ld reference

The task factory now returns a descriptor `(options) => descriptor`, but three
spots in architecture.md still described it returning a bare `Step[]`: the
section opener, the DSL intro, and the DSL example's `return steps`. Align them
with the descriptor model and return `{requiresDependencies: true, steps}`,
matching the generateThemeDesignerResources reference task.

Also list `requiresDependencies` (the boolean enabling the dependencies reader)
and `determineExpectedOutput` in the descriptor paragraph, which previously named
only the determineRequiredDependencies / determineBuildSignature callbacks.
Build tags are routed to the executing project's ProjectResources, not the
resource owner, so a task tagging a dependency's resource keeps the build tag
in its own stage cache. Record this in the Tag Types section: scope decides
which project's collection stores a tag, and ProjectBuildContext classifies via
acceptsProjectTag before picking the owner or the executing project.
@RandomByte RandomByte changed the title docs/incremental build descriptor api docs: Update incremental build skill Oct 30, 2026
@RandomByte
RandomByte requested a review from devtomtom October 30, 2026 14:58

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.

1 participant