You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The published site IR docs still document the old free-function task-helper API, which no longer exists in the code. After the typed-task refactor, helpers moved from src/compile/ir/tasks.rs (a single file of free functions like copy_files_step(), nuget_command_step()) to builder structs under src/compile/ir/tasks/ (one file per task, e.g. CopyFiles::new(..).into_step()).
The following site docs are stale and reference the removed API and the deleted tasks.rs file:
site/src/content/docs/guides/extending.mdx — "The full set of typed helpers lives in src/compile/ir/tasks.rs" + free-function example.
Update both .mdx files to describe the builder-struct API (Task::new(<required>) + typed chained setters + .into_step()), per the convention in src/compile/ir/tasks/mod.rs.
Replace the free-function helper table with the current builder structs, and refresh the example.
Fix references to src/compile/ir/tasks.rs -> src/compile/ir/tasks/ (directory, one file per task).
Problem
The published site IR docs still document the old free-function task-helper API, which no longer exists in the code. After the typed-task refactor, helpers moved from
src/compile/ir/tasks.rs(a single file of free functions likecopy_files_step(),nuget_command_step()) to builder structs undersrc/compile/ir/tasks/(one file per task, e.g.CopyFiles::new(..).into_step()).The following site docs are stale and reference the removed API and the deleted
tasks.rsfile:site/src/content/docs/guides/extending.mdx— "The full set of typed helpers lives insrc/compile/ir/tasks.rs" + free-function example.site/src/content/docs/reference/ir.mdx—tasks.rsbullet + the entire "Typed task helpers" table (listscopy_files_step(..),nuget_command_step(command),powershell_file_step(..), etc.).Scope
.mdxfiles to describe the builder-struct API (Task::new(<required>)+ typed chained setters +.into_step()), per the convention insrc/compile/ir/tasks/mod.rs.src/compile/ir/tasks.rs->src/compile/ir/tasks/(directory, one file per task).src/compile/ir/tasks/, including the recently-requestedPublishPipelineArtifact@1,DownloadPipelineArtifact@2, andDeleteFiles@1(the additions attempted in docs(site): add PublishPipelineArtifact@1, DownloadPipelineArtifact@2, DeleteFiles@1 to typed-helpers table #1079).Context
docs/ir.md/docs/extending.mdmarkdown sources may need the same treatment; check them alongside the site mdx (the big in-flight PR feat(ir): validate front-matter task steps against typed builders #1096 also touchesdocs/ir.md, so coordinate to avoid conflicts).