fix(docs-site): links on site index should work

Author: AgentEnder

docs/core/executors/build.md

@@ -10,24 +10,24 @@ Builds an app via the `dotnet` cli command.
 
 ## Options
 
-### framework
-
-- (string): Compiles for a specific framework. The framework must be defined in the project file
-
-### version-suffix
-
-- (string): Sets the value of the $(VersionSuffix) property to use when building the project. This only works if the $(Version) property isn't set. Then, $(Version) is set to the $(VersionPrefix) combined with the $(VersionSuffix), separated by a dash.
-
-### <span class="required">configuration</span>
+### <span className="required">configuration</span>
 
 - (string): Defines the build configuration. The default for most projects is Debug, but you can override the build configuration settings in your project
 
 Default: `"Debug"`
 
+### extraParameters
+
+- (string): Extra command-line arguments that are passed verbatim to the dotnet command.
+
 ### force
 
 - (boolean): Forces all dependencies to be resolved even if the last restore was successful. Specifying this flag is the same as deleting the project.assets.json file.
 
+### framework
+
+- (string): Compiles for a specific framework. The framework must be defined in the project file
+
 ### no-dependencies
 
 - (boolean): Ignores project-to-project (P2P) references and only builds the specified root project.
@@ -54,6 +54,6 @@ Default: `"Debug"`
 
 Default: `"minimal"`
 
-### extraParameters
+### version-suffix
 
-- (string): Extra command-line arguments that are passed verbatim to the dotnet command.
+- (string): Sets the value of the $(VersionSuffix) property to use when building the project. This only works if the $(Version) property isn't set. Then, $(Version) is set to the $(VersionPrefix) combined with the $(VersionSuffix), separated by a dash.

docs/core/executors/format.md

@@ -10,56 +10,56 @@ Formats and lints a project using the dotnet-format tool
 
 ## Options
 
-### noRestore
+### binarylog
 
-- (boolean): Doesn't execute an implicit restore before formatting
+- (string): Log all project or solution load information to a binary log file.
 
-### fixWhitespace
+### check
 
-- (boolean): Run whitespace formatting. Run by default when not applying fixes.
+- (boolean): Formats files without saving changes to disk. Terminates with a non-zero exit code if any files were formatted.
 
-### fixStyle
+Default: `true`
 
-- (string): Run code style analyzers and apply fixes.
+### diagnostics
+
+- (string): A space separated list of diagnostic ids to use as a filter when fixing code style or 3rd party analyzers.
+
+- (array): A list of diagnostic ids to use as a filter when fixing code style or 3rd party analyzers.
+
+### exclude
+
+- (array): A list of relative file or folder paths to exclude from formatting.
+
+### fix
+
+- (boolean): Formats files and saves changes to disk. Equivalent to setting --check=false.
 
 ### fixAnalyzers
 
 - (string): Run 3rd party analyzers and apply fixes.
 
-### diagnostics
+### fixStyle
 
-- (string): A space separated list of diagnostic ids to use as a filter when fixing code style or 3rd party analyzers.
+- (string): Run code style analyzers and apply fixes.
 
-- (array): A list of diagnostic ids to use as a filter when fixing code style or 3rd party analyzers.
+### fixWhitespace
+
+- (boolean): Run whitespace formatting. Run by default when not applying fixes.
 
 ### include
 
 - (array): A list of relative file or folder paths to include in formatting. All files are formatted if empty
 
-### exclude
-
-- (array): A list of relative file or folder paths to exclude from formatting.
-
-### check
-
-- (boolean): Formats files without saving changes to disk. Terminates with a non-zero exit code if any files were formatted.
+### noRestore
 
-Default: `true`
+- (boolean): Doesn't execute an implicit restore before formatting
 
 ### report
 
 - (string): Accepts a file path, which if provided, will produce a json report in the given directory.
 
-### binarylog
-
-- (string): Log all project or solution load information to a binary log file.
-
 ### verbosity
 
 - (string): Set the verbosity level.
 
 Default: `"minimal"`
-
-### fix
-
-- (boolean): Formats files and saves changes to disk. Equivalent to setting --check=false.

docs/core/executors/openapi-codegen.md

@@ -10,26 +10,26 @@ Invokes `nx g @nx-dotnet/core:swagger-typescript` with the proper parameters to
 
 ## Options
 
-### useOpenApiGenerator
-
-- (boolean): Use the OpenAPI generator to generate the code
+### <span className="required">openapiJsonPath</span>
 
-### openApiGeneratorTemplate
+- (string): Path to OpenAPI spec file
 
-- (string): The template to use for the OpenAPI generator
+### <span className="required">outputProject</span>
 
-Default: `"typescript-fetch"`
+- (string): Which project should hold the generated code?
 
 ### openApiGeneratorArgs
 
 - (array): Additional arguments to pass to the OpenAPI generator
 
 Default: `["--global-property=models,apis"]`
 
-### <span class="required">openapiJsonPath</span>
+### openApiGeneratorTemplate
 
-- (string): Path to OpenAPI spec file
+- (string): The template to use for the OpenAPI generator
+
+Default: `"typescript-fetch"`
 
-### <span class="required">outputProject</span>
+### useOpenApiGenerator
 
-- (string): Which project should hold the generated code?
+- (boolean): Use the OpenAPI generator to generate the code

docs/core/executors/publish.md

@@ -16,14 +16,18 @@ Publishes an app via the `dotnet` cli command.
 
 Default: `"Debug"`
 
-### framework
+### extraParameters
 
-- (string): Publishes the application for the specified target framework. You must specify the target framework in the project file.
+- (string): Extra command-line arguments that are passed verbatim to the dotnet command.
 
 ### force
 
 - (boolean): Forces all dependencies to be resolved even if the last restore was successful. Specifying this flag is the same as deleting the project.assets.json file.
 
+### framework
+
+- (string): Publishes the application for the specified target framework. You must specify the target framework in the project file.
+
 ### noBuild
 
 - (boolean): Doesn't build the project before publishing. It also implicitly sets the --no-restore flag.
@@ -44,14 +48,18 @@ Default: `"Debug"`
 
 - (string): Specifies the path for the output directory.
 
-### selfContained
+### publishProfile
 
-- (boolean): Publishes the .NET runtime with your application so the runtime doesn't need to be installed on the target machine. Default is true if a runtime identifier is specified and the project is an executable project (not a library project).
+- (string): Specifies the name of the publish profile to use while publishing. Do not include the file path or the file extension. MSBuild by default looks in the Properties/PublishProfiles folder and assumes the pubxml file extension.
 
 ### runtime
 
 - (string): Publishes the application for a given runtime.
 
+### selfContained
+
+- (boolean): Publishes the .NET runtime with your application so the runtime doesn't need to be installed on the target machine. Default is true if a runtime identifier is specified and the project is an executable project (not a library project).
+
 ### verbosity
 
 - (string): Sets the verbosity level of the command.
@@ -61,11 +69,3 @@ Default: `"minimal"`
 ### versionSuffix
 
 - (string): Defines the version suffix to replace the asterisk (\*) in the version field of the project file.
-
-### publishProfile
-
-- (string): Specifies the name of the publish profile to use while publishing. Do not include the file path or the file extension. MSBuild by default looks in the Properties/PublishProfiles folder and assumes the pubxml file extension.
-
-### extraParameters
-
-- (string): Extra command-line arguments that are passed verbatim to the dotnet command.

docs/core/executors/serve.md

@@ -16,14 +16,14 @@ Uses `dotnet watch` to run a .NET app.
 
 Default: `"Debug"`
 
-### framework
-
-- (string): Builds and runs the app using the specified framework. The framework must be specified in the project file.
-
 ### force
 
 - (boolean): Forces all dependencies to be resolved even if the last restore was successful. Specifying this flag is the same as deleting the project.assets.json file.
 
+### framework
+
+- (string): Builds and runs the app using the specified framework. The framework must be specified in the project file.
+
 ### launch-profile
 
 - (string): The name of the launch profile (if any) to use when launching the application. Launch profiles are defined in the launchSettings.json file and are typically called Development, Staging, and Production. For more information, see Working with multiple environments.

docs/core/executors/test.md

@@ -10,10 +10,6 @@ Runs test via the dotnet cli
 
 ## Options
 
-### testAdapterPath
-
-- (string): Path to a directory to be searched for additional test adapters. Only .dll files with suffix .TestAdapter.dll are inspected. If not specified, the directory of the test .dll is searched.
-
 ### blame
 
 - (boolean): Runs the tests in blame mode. This option is helpful in isolating problematic tests that cause the test host to crash. When a crash is detected, it creates a sequence file in TestResults/<Guid>/<Guid>\_Sequence.xml that captures the order of tests that were run before the crash.
@@ -22,14 +18,14 @@ Runs test via the dotnet cli
 
 - (boolean): Runs the tests in blame mode and collects a crash dump when the test host exits unexpectedly. This option depends on the version of .NET used, the type of error, and the operating system. For exceptions in managed code, a dump will be automatically collected on .NET 5.0 and later versions. It will generate a dump for testhost or any child process that also ran on .NET 5.0 and crashed. Crashes in native code will not generate a dump. This option works on Windows, macOS, and Linux. Crash dumps in native code, or when using .NET Core 3.1 or earlier versions, can only be collected on Windows, by using Procdump. A directory that contains procdump.exe and procdump64.exe must be in the PATH or PROCDUMP_PATH environment variable. Download the tools. Implies --blame. To collect a crash dump from a native application running on .NET 5.0 or later, the usage of Procdump can be forced by setting the VSTEST_DUMP_FORCEPROCDUMP environment variable to 1.
 
-### blameCrashDumpType
-
-- (string): The type of crash dump to be collected. Implies --blame-crash.
-
 ### blameCrashCollectAlways
 
 - (boolean): Collects a crash dump on expected as well as unexpected test host exit.
 
+### blameCrashDumpType
+
+- (string): The type of crash dump to be collected. Implies --blame-crash.
+
 ### blameHang
 
 - (boolean): Run the tests in blame mode and collects a hang dump when a test exceeds the given timeout.
@@ -47,28 +43,36 @@ Runs test via the dotnet cli
   5400000ms, 5400000mil, 5400000millisecond, 5400000milliseconds
   When no unit is used (for example, 5400000), the value is assumed to be in milliseconds. When used together with data driven tests, the timeout behavior depends on the test adapter used. For xUnit and NUnit the timeout is renewed after every test case. For MSTest, the timeout is used for all test cases. This option is supported on Windows with netcoreapp2.1 and later, on Linux with netcoreapp3.1 and later, and on macOS with net5.0 or later. Implies --blame and --blame-hang.
 
-### configuration
-
-- (string): Defines the build configuration. The default value is Debug, but your project's configuration could override this default SDK setting.
-
 ### collect
 
 - (string): Enables data collector for the test run. For more information, see Monitor and analyze test run.
   To collect code coverage on any platform that is supported by .NET Core, install Coverlet and use the --collect:"XPlat Code Coverage" option.
   On Windows, you can collect code coverage by using the --collect "Code Coverage" option. This option generates a .coverage file, which can be opened in Visual Studio 2019 Enterprise. For more information, see Use code coverage and Customize code coverage analysis.
 
+### configuration
+
+- (string): Defines the build configuration. The default value is Debug, but your project's configuration could override this default SDK setting.
+
 ### diag
 
 - (string): Enables diagnostic mode for the test platform and writes diagnostic messages to the specified file and to files next to it. The process that is logging the messages determines which files are created, such as _.host\_<date>.txt for test host log, and _.datacollector\_<date>.txt for data collector log.
 
-### framework
+### extraParameters
 
-- (string): Forces the use of dotnet or .NET Framework test host for the test binaries. This option only determines which type of host to use. The actual framework version to be used is determined by the runtimeconfig.json of the test project. When not specified, the TargetFramework assembly attribute is used to determine the type of host. When that attribute is stripped from the .dll, the .NET Framework host is used.
+- (string): Extra command-line arguments that are passed verbatim to the dotnet command.
 
 ### filter
 
 - (string): Filters out tests in the current project using the given expression. For more information, see the Filter option details section. For more information and examples on how to use selective unit test filtering, see Running selective unit tests.
 
+### framework
+
+- (string): Forces the use of dotnet or .NET Framework test host for the test binaries. This option only determines which type of host to use. The actual framework version to be used is determined by the runtimeconfig.json of the test project. When not specified, the TargetFramework assembly attribute is used to determine the type of host. When that attribute is stripped from the .dll, the .NET Framework host is used.
+
+### listTests
+
+- (boolean): List the discovered tests instead of running the tests.
+
 ### logger
 
 - (string): Specifies a logger for test results. Unlike MSBuild, dotnet test doesn't accept abbreviations: instead of -l "console;v=d" use -l "console;verbosity=detailed". Specify the parameter multiple times to enable multiple loggers.
@@ -97,9 +101,9 @@ Runs test via the dotnet cli
 
 - (string): The .runsettings file to use for running the tests. The TargetPlatform element (x86|x64) has no effect for dotnet test. To run tests that target x86, install the x86 version of .NET Core. The bitness of the dotnet.exe that is on the path is what will be used for running tests. For more information, see the following resources:
 
-### listTests
+### testAdapterPath
 
-- (boolean): List the discovered tests instead of running the tests.
+- (string): Path to a directory to be searched for additional test adapters. Only .dll files with suffix .TestAdapter.dll are inspected. If not specified, the directory of the test .dll is searched.
 
 ### verbosity
 
@@ -108,7 +112,3 @@ Runs test via the dotnet cli
 ### watch
 
 - (boolean): Determines if `dotnet test` or `dotnet watch test` is used to execute tests.
-
-### extraParameters
-
-- (string): Extra command-line arguments that are passed verbatim to the dotnet command.

docs/core/executors/update-swagger.md

@@ -14,16 +14,16 @@ Extract openapi swagger documentation from the webapi
 
 - (string): Where should the swagger output be stored
 
-### swaggerDoc
-
-- (string): Which swagger doc should be used?
+### skipInstall
 
-Default: `"v1"`
+- (boolean): Skips installing Swashbuckle.AspNetCore.Cli. This option should be used if you are managing the installation on your own.
 
 ### startupAssembly
 
 - (string): Path from workspace root to the built api's startup dll file
 
-### skipInstall
+### swaggerDoc
 
-- (boolean): Skips installing Swashbuckle.AspNetCore.Cli. This option should be used if you are managing the installation on your own.
+- (string): Which swagger doc should be used?
+
+Default: `"v1"`