@@ -7,7 +7,7 @@ organization.
77## Table of content
88
99- [ What is a Prebuilt] ( #what-is-a-prebuilt )
10- - [ Elimitating pre-builts] ( #eliminating-pre-builts )
10+ - [ Eliminating pre-builts] ( #eliminating-pre-builts )
1111- [ Allowed exceptions] ( #allowed-exceptions )
1212- [ Contacts] ( #contacts )
1313
@@ -28,7 +28,7 @@ When onboarding a repository to source-build or adding a new dependency to a
2828source-buildable one, the contributor runs the risk of introducing a new
2929pre-built to the product. To protect against this and catch any new pre-builts
3030as soon as possible, Arcade source-build infrastructure provides _ pre-built
31- detection_ - MSBuild logic responsible for veryfing that no used dependency is a
31+ detection_ - MSBuild logic responsible for verifying that no used dependency is a
3232pre-built. In case one is discovered (for example, during a PR pipeline), the
3333build will fail with an appropriate message somewhat similar to the following:
3434
@@ -48,12 +48,12 @@ from pre-built detection will be flagged as pre-builts.
4848
4949## Eliminating pre-builts
5050
51- When altering the dependecy tree of a repository, specifically adding or
52- updating dependencies, there is a posibility that a new pre-built is introduced,
51+ When altering the dependency tree of a repository, specifically adding or
52+ updating dependencies, there is a possibility that a new pre-built is introduced,
5353failing the build and blocking any merge. This can be resolved by identifying
54- what exactly is the pre-built and following the approriate steps listed below.
54+ what exactly is the pre-built and following the appropriate steps listed below.
5555
56- To check if new pre-builts were introduce , the repository needs to be
56+ To check if new pre-builts were introduced , the repository needs to be
5757source-built first. This can be done through the following command:
5858
5959``` sh
@@ -75,7 +75,7 @@ pre-built.
7575
7676### Pre-built through a transitive dependency
7777
78- During a project dependency updated , a new pre-built might be introduced by a
78+ During a project dependency update , a new pre-built might be introduced by a
7979new or updated transitive dependency. While the Arcade tooling will highlight
8080the name and version of the pre-built in the build exception as well as the
8181project that restored the dependency in question, it will not point out where
@@ -86,7 +86,7 @@ dependency, it might be hard to identify the relationship that is bringing in
8686the pre-built into the project, especially if the developer has limited
8787knowledge of the project or code-base in general.
8888
89- Arcade source-build infrastructure helps accomplish this this by pointing out
89+ Arcade source-build infrastructure helps accomplish this by pointing out
9090the ` project.assets.json ` file that is referencing the pre-built in the
9191` ./artifacts/source-build/self/prebuild-report/prebuild-usage.xml ` report file.
9292A ` project.assets.json ` file is a NuGet restore process artifact that contains a
@@ -145,12 +145,12 @@ dependency causing the `System.Text.Json` pre-built.
145145The list of permitted pre-builts can be found in the ` ./eng/SourceBuildPrebuiltBaseline.xml ` file in the root of the repository.
146146It contains package information of pre-builts that for one reason or another are allowed in the source-build of the repository.
147147
148- Any new addition to the pre-built exception list must be signed-off by a member of the ` @dotnet/source-build ` team.
148+ Any new additions to the pre-built exception list must be signed-off by a member of the ` @dotnet/source-build ` team.
149149
150150In cases where a specific package needs to be excluded from pre-built detection
151151(for example, to not block the introduction of changes until a source-build
152152acceptable solution for the pre-built is provided), the developer can directly
153- specify the name / version of the depedency :
153+ specify the name / version of the dependency :
154154
155155``` xml
156156<UsageData >
0 commit comments