Skip to content

Commit 74c0216

Browse files
committed
Add item for best practices
1 parent f3d6350 commit 74c0216

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

docs/msbuild/msbuild-best-practices.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,9 @@ We recommend the following best practices for writing MSBuild scripts:
2323
</MyProperty>
2424
```
2525

26-
- Avoid wildcards when you select items. Instead, specify files explicitly. This makes it easier to track down errors that may occur when you add or delete files.
26+
- Any custom `.props` files should be simple and single-purpose, and `.props` files should not include other `.props` files.
27+
28+
The only exception to this is *Directory.Build.props*. Because property values can be overridden, the value at any time in the process depends on the order in which MSBuild processes a script. It can be difficult to trace why property values have the values they do at various stages in the build process, and this practice helps you more easily diagnose such issues.
2729

2830
## See also
2931
- [Advanced concepts](../msbuild/msbuild-advanced-concepts.md)

0 commit comments

Comments
 (0)