Files
codeql/csharp/ql/src/Metrics/Files/FSelfContainedness.qhelp
2018-08-02 17:53:23 +01:00

26 lines
1.1 KiB
XML

<!DOCTYPE qhelp PUBLIC
"-//Semmle//qhelp//EN"
"qhelp.dtd">
<qhelp>
<overview>
<p>This metric measures the percentage of types on which the file depends for which the build
process built from source. The availability of source code is one of the key factors that affects
how easy a project will be to build for different versions of the .NET framework. Files with low
self-containedness are also more affected by changes to their dependencies.</p>
</overview>
<recommendation>
<p>Depending on your project, self-containedness may or may not be an issue for you. If you decide
that it should be addressed then there are a few things you can do to easily increase
self-containedness. One way of increasing self-containedness is by creating wrappers for any
external classes. If the external class is changed then only your wrapper needs to be updated. You
should also try to use libraries with source code available.</p>
</recommendation>
<references>
<li>Wikipedia. <a href="http://en.wikipedia.org/wiki/Software_portability">Software Portability</a>.</li>
</references>
</qhelp>