Skip to content

Document ReqnrollGenerationTaskFactory and AssemblyTaskFactory - #1109

Draft
304NotModified with Copilot wants to merge 1 commit into
mainfrom
copilot/fix
Draft

304NotModified with Copilot wants to merge 1 commit into
mainfrom
copilot/fix

Conversation

Copilot AI commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

AssemblyTaskFactory is used by the code generation MSBuild task but was never documented, despite being key to resolving issues with nested and parallel MSBuild execution.

Documentation added (docs/installation/configuring-build.md)

  • New section explaining the ReqnrollGenerationTaskFactory build variable and its default behavior:
    • TaskHostFactory on Windows — runs the task out-of-process to avoid Visual Studio locking the task assembly and to prevent conflicts when MSBuild is invoked in a nested or parallel fashion.
    • AssemblyTaskFactory on non-Windows platforms — loads the task assembly directly in-process, since TaskHostFactory isn't supported everywhere.
  • Example showing how to override the default (e.g. forcing AssemblyTaskFactory on Windows):
<PropertyGroup>
  <ReqnrollGenerationTaskFactory>AssemblyTaskFactory</ReqnrollGenerationTaskFactory>
</PropertyGroup>

Co-authored-by: 304NotModified <5808377+304NotModified@users.noreply.github.com>
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.

<ReqnrollGenerationTaskFactory>AssemblyTaskFactory</ReqnrollGenerationTaskFactory> is undocumented

2 participants