Add missing documentation (#742)

Addressed a bunch of warnings and turned `GenerateDocumentationFile` back on.

src/Directory.Build.props

@@ -1,5 +1,8 @@
 <Project>
 	<PropertyGroup>
-		<GenerateDocumentationFile>false</GenerateDocumentationFile>
+		<GenerateDocumentationFile>true</GenerateDocumentationFile>
+		<!-- Workaround for IDE0005 (Remove unnecessary usings/imports); see
+		https://github.com/dotnet/roslyn/issues/41640 -->
+		<NoWarn>EnableGenerateDocumentationFile</NoWarn>
 	</PropertyGroup>
 </Project>

src/Whim.TestUtils/Directory.Build.props

@@ -0,0 +1,5 @@
+<Project>
+	<PropertyGroup>
+		<GenerateDocumentationFile>false</GenerateDocumentationFile>
+	</PropertyGroup>
+</Project>

src/Whim.TreeLayout.Bar/ToggleDirectionCommand.cs

@@ -10,7 +10,9 @@ public class ToggleDirectionCommand : System.Windows.Input.ICommand
 	private readonly TreeLayoutEngineWidgetViewModel _viewModel;
 
 	/// <inheritdoc/>
+#pragma warning disable CS0067 // The event 'ToggleDirectionCommand.CanExecuteChanged' is never used
 	public event EventHandler? CanExecuteChanged;
+#pragma warning restore CS0067 // The event 'ToggleDirectionCommand.CanExecuteChanged' is never used
 
 	/// <summary>
 	/// Creates a new instance of <see cref="ToggleDirectionCommand"/>.

src/Whim.TreeLayout.Tests/TreeLayoutCommandsTests.cs

@@ -6,7 +6,7 @@ namespace Whim.TreeLayout.Tests;
 
 public class TreeLayoutCommandsTests
 {
-	private class Wrapper
+	private sealed class Wrapper
 	{
 		public IContext Context { get; } = Substitute.For<IContext>();
 		public IMonitor Monitor { get; } = Substitute.For<IMonitor>();

src/Whim.TreeLayout.Tests/Utils/LayoutEngineWrapper.cs

@@ -2,7 +2,7 @@
 
 namespace Whim.TreeLayout.Tests;
 
-internal class LayoutEngineWrapper
+internal sealed class LayoutEngineWrapper
 {
 	public IContext Context { get; } = Substitute.For<IContext>();
 	public ITreeLayoutPlugin Plugin { get; } = Substitute.For<ITreeLayoutPlugin>();

src/Whim.TreeLayout.Tests/Utils/SimpleTestTree.cs

@@ -26,7 +26,7 @@ namespace Whim.TreeLayout.Tests;
 /// |                      |                      |
 /// -----------------------------------------------
 /// </summary>
-internal class SimpleTestTree
+internal sealed class SimpleTestTree
 {
 	public SplitNode Root;
 	public SplitNode Top;

src/Whim.TreeLayout.Tests/Utils/TestTree.cs

@@ -48,7 +48,7 @@ namespace Whim.TreeLayout.Tests;
 /// |                                                                               |                                                                                |
 /// ------------------------------------------------------------------------------------------------------------------------------------------------------------------
 /// </summary>
-internal class TestTree
+internal sealed class TestTree
 {
 	public SplitNode Root;
 	public WindowNode Left;

src/Whim.TreeLayout/ITreeLayoutPlugin.cs

@@ -3,8 +3,8 @@
 namespace Whim.TreeLayout;
 
 /// <summary>
-/// TreeLayoutPlugin provides commands and functionality for the <see cref="TreeLayoutEngine"/>.
-/// TreeLayoutPlugin does not load the <see cref="TreeLayoutEngine"/> - that is done when creating
+/// <see cref="TreeLayoutPlugin"/> provides commands and functionality for the <see cref="TreeLayoutEngine"/>.
+/// <see cref="TreeLayoutPlugin"/> does not load the <see cref="TreeLayoutEngine"/> - that is done when creating
 /// a workspace via <see cref="IWorkspaceManager.Add"/>.
 /// </summary>
 public interface ITreeLayoutPlugin : IPlugin

src/Whim.TreeLayout/TreeLayoutEngine.cs

@@ -685,5 +685,6 @@ WindowNode bNode
 		return new TreeLayoutEngine(this, currentNode, newWindows);
 	}
 
+	/// <inheritdoc />
 	public ILayoutEngine PerformCustomAction<T>(LayoutEngineCustomAction<T> action) => this;
 }

src/Whim.Updater.Tests/Directory.Build.props

@@ -0,0 +1,5 @@
+<Project>
+	<PropertyGroup>
+		<GenerateDocumentationFile>false</GenerateDocumentationFile>
+	</PropertyGroup>
+</Project>

src/Whim/Layout/ColumnLayoutEngine.cs

@@ -236,5 +236,6 @@ private static int GetDelta(bool leftToRight, Direction direction)
 		}
 	}
 
+	/// <inheritdoc/>
 	public ILayoutEngine PerformCustomAction<T>(LayoutEngineCustomAction<T> action) => this;
 }

src/Whim/Workspace/IWorkspace.cs

@@ -170,7 +170,7 @@ public interface IWorkspace : IDisposable
 	/// For more, see <see cref="ILayoutEngine.PerformCustomAction{T}" />.
 	/// </remarks>
 	/// <typeparam name="T">
-	/// The type of <paramref name="args" />'s payload.
+	/// The type of <paramref name="action" />'s payload.
 	/// </typeparam>
 	/// <param name="action">
 	/// Metadata about the action to perform, and the payload to perform it with.