From b851e50509e759f6af799af2d62d81e3534478ed Mon Sep 17 00:00:00 2001 From: Sergei Vorobev Date: Fri, 15 Jul 2016 17:30:59 -0700 Subject: [PATCH] Add Start-PSBuild -Clean in FAQ.md This came out few times in the past few days. --- docs/FAQ.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/docs/FAQ.md b/docs/FAQ.md index cf783cb14c..e9abe54cbd 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -43,13 +43,31 @@ more information. [error]: https://blogs.msdn.microsoft.com/kebab/2013/06/09/an-introduction-to-error-handling-in-powershell/ -I just pulled master, why did my build fail? +Why did my build fail? ============================================ +There are few common issues with the build. +The easiest way to resolve most issues with the build is to run `Start-PSBuild -Clean`. + +### Dependency changed + If package dependencies were changed in any `project.json`, you need to manually run `dotnet restore` to update your local dependency graphs. `Start-PSBuild -Restore` can automatically do this. +### Resource changed + +`Start-PSBuild` automatically calls `Start-ResGen` on the very first run. +On subsequent runs, you may need to explicitly use `Start-PSBuild -ResGen` command. + +Try it, when you see compilation error about *strings. + +[More details](workflow/resources.md) about resource. + +### TypeGen + +Similar to `-ResGen` parameter, there is `-TypeGen` parameter that trigger re-generation of type catalog. + Why did `Start-PSBuild` tell me to update `dotnet`? ===================================================