build: Add vale configuration and demonstrate usage

.changeset/blue-eels-invite.md

@@ -1,9 +1,7 @@
 ---
 "fluid-framework": minor
 "@fluidframework/tree": minor
----
----
-"section": tree
+"__section": tree
 ---
 
 Better type errors for invalid recursive schema

.changeset/cuddly-donuts-guess.md

@@ -1,30 +1,8 @@
 ---
 "@fluidframework/core-utils": minor
----
----
-"section": feature
+"__section": feature
 ---
 
 New alpha `onAssertionFailure` API
 
-A new `@alpha` API is added called `onAssertionFailure` which can be used to get a callback when an assertion fails indicating a bug in the Fluid Framework.
-This callback is invoked before the exception is thrown, reducing the chances of the exception being lost or replaced with a different exception before making it to a catch block which reports it.
-It can also be used to break into the debugger when the assertion occurs to aid in debugging the cause.
-
-```ts
-import { onAssertionFailure } from "fluid-framework/alpha";
-
-let firstAssertion: Error | undefined;
-
-onAssertionFailure((error: Error) => {
-	const priorErrorNote =
-		firstAssertion === undefined
-			? "Please report this bug."
-			: `Might be caused due to prior error ${JSON.stringify(firstAssertion.message)} which should be investigated first.`;
-	const message = `Encountered Bug in Fluid Framework: ${error.message}\n${priorErrorNote}\n${error.stack}`;
-	console.error(message);
-
-	debugger;
-	firstAssertion ??= error;
-});
-```
+A new `@alpha`

.changeset/empty-wasps-smile.md

@@ -1,9 +1,7 @@
 ---
 "fluid-framework": minor
 "@fluidframework/tree": minor
----
----
-"section": tree
+"__section": tree
 ---
 
 Improved type checking for recursive object schema Fields
@@ -52,4 +50,4 @@ This change will also result in much nicer IntelliSense and type errors while fi
 
 There are still several cases which compile but violate this policy regarding recursive schema and can cause issues when exporting schema;
 these should be migrated to the above pattern as well.
-It is still valid to use non-recursive structurally named array and map schema inline; this change does not impact them.
+It is still valid to use non-recursive structurally named array and map schema inline. This change does not impact them.

.changeset/fancy-gifts-jam.md

@@ -1,12 +1,10 @@
 ---
 "@fluidframework/tree": minor
 "fluid-framework": minor
----
----
-"section": tree
+"__section": tree
 ---
 
-Performance enhancements in SharedTree branch-related ops processing
+Performance enhancements in Shared Tree branch-related ops processing
 
 SharedTree leverages the "op bunching" feature where contiguous ops in a grouped batch are bunched and processed together
 to asymptotically improve the performance of processing ops.

.changeset/petite-bags-cheer.md

@@ -1,11 +1,9 @@
 ---
 "@fluidframework/tree": minor
----
----
-"section": tree
+"__section": tree
 ---
 
-Improve tree shaking for code which imports `SharedTreeAttributes`
+Improve Tree Shaking For Code Which Imports `SharedTreeAttributes`
 
 Bundling code that imports `SharedTreeAttributes` from `@fluidframework/tree/legacy` should now better prune out the rest of the tree package's code.
 This change reduced the dependency on webpack's

.changeset/plenty-olives-speak.md

@@ -1,9 +1,7 @@
 ---
 "fluid-framework": minor
 "@fluidframework/tree": minor
----
----
-"section": tree
+"__section": tree
 ---
 
 `TreeAlpha.exportConcise` now supports `undefined`

.changeset/strong-dragons-build.md

@@ -1,9 +1,7 @@
 ---
 "fluid-framework": minor
 "@fluidframework/tree": minor
----
----
-"section": tree
+"__section": tree
 ---
 
 Improvements to typing of object node schema

.changeset/stuffed-bears-relax.md

@@ -1,8 +1,6 @@
 ---
 "@fluid-experimental/tree-react-api": minor
----
----
-"section": other
+"__section": other
 ---
 
 Simplify experimental tree data object implementation

.changeset/vast-paths-begin.md

@@ -1,10 +1,8 @@
 ---
 "@fluidframework/datastore": minor
 "@fluidframework/test-runtime-utils": minor
----
----
-"section": legacy
-includeInReleaseNotes: false
+"__section": legacy
+"__includeInReleaseNotes": false
 ---
 
 New ILayerCompatDetails property on FluidDataStoreRuntime, MockFluidDataStoreContext and MockFluidDataStoreRuntime
@@ -15,4 +13,4 @@ A new optional property, `ILayerCompatDetails`, has been added to `FluidDataStor
 `ILayerCompatDetails` has also been added to `MockFluidDataStoreRuntime` and `MockFluidDataStoreContext` which are used for
 testing.
 
-Important: this property is intended for use by Fluid Framework code only. No code outside the Fluid Framework should use or depend on this property in any way.
+Important: this property is intended for use by fluid Framework code only. No code outside the FluidFramework should use or depend on this property in any way.

.gitignore

@@ -7,6 +7,15 @@ nyc
 *.log
 .DS_Store
 
+.vale/*
+!.vale/config/
+
+.vale/config/*
+!.vale/config/vocabularies/
+
+.vale/config/vocabularies/*
+!.vale/config/vocabularies/fluid/
+
 # Generated Node10 module resolution compatibility files
 alpha.d.ts
 beta.d.ts

.vale.ini

@@ -0,0 +1,21 @@
+StylesPath = .vale
+
+MinAlertLevel = suggestion
+
+Packages = Microsoft, MDX, proselint
+
+Vocab = fluid
+
+[*README.md]
+Microsoft.We = NO
+
+[*.{md}]
+BasedOnStyles = Vale, Microsoft, proselint
+
+Vale.Spelling = NO
+
+Microsoft.Contractions = NO
+Microsoft.Passive = NO
+Microsoft.Semicolon = warning
+Microsoft.Terms = suggestion
+Microsoft.Vocab = NO

.vale/config/vocabularies/fluid/accept.txt

@@ -0,0 +1,5 @@
+Fluid Framework
+FluidFramework
+JavaScript
+SharedTree
+TypeScript

.vale/config/vocabularies/fluid/reject.txt

@@ -0,0 +1 @@
+shared tree

package.json

@@ -171,6 +171,7 @@
 		"@fluidframework/test-tools": "^1.0.195075",
 		"@microsoft/api-documenter": "^7.21.6",
 		"@microsoft/api-extractor": "7.50.1",
+		"@vvago/vale": "^3.10.0",
 		"auto-changelog": "^2.4.0",
 		"c8": "^8.0.1",
 		"changesets-format-with-issue-links": "^0.3.0",