Feedback: 'NServiceBus Quickstart: Recovering from failure'

[mnadareski-particular]

Feedback for 'NServiceBus Quickstart: Recovering from failure' https://docs.particular.net/tutorials/quickstart/tutorial-reliability

Location in GitHub: https://github.com/Particular/docs.particular.net/blob/master/tutorials/quickstart/tutorial-reliability.md

• Nitpicky wording: "In the Handle method, comment out all the code past the throw statement so that Visual Studio doesn't show a warning about unreachable code." will throw an error if you accidentally comment out the #endregion tag
• "Within Main, replace the line await Task.CompletedTask; with await Particular.PlatformLauncher.Launch();. This is responsible for launching the platform when we start our project." is not consistent with the code block that follows, showing the Launch invocation still commented out
  • For code blocks, I expected to see the desired outcome, not the current state of the solution
• ServicePulse is said to only work on Windows according to "In order to use the portable version of the Particular Service Platform included in this tutorial, you'll need to use a Windows operating system." but all steps seemingly could be followed on Linux as well
• Pedantic nitpick that it says ServicePulse will open in a new window (actually new window or tab) and to undock the tab to a new window (shouldn't be needed if already in a new window?)
  • "After a few seconds, the application launches ServicePulse in a new browser window:"
  • "Undock the ServicePulse browser tab into a new window to better see what's going on."