docs.particular.net icon indicating copy to clipboard operation
docs.particular.net copied to clipboard

Hosting documentation is confusing

Open timbussmann opened this issue 3 years ago • 0 comments

We have two main documents describing hosting options:

  • https://docs.particular.net/nservicebus/hosting/
  • https://docs.particular.net/nservicebus/hosting/selecting

both pages contain similar content with some variation. The categorizations are a bit weird, for example:

  • it describes send-only endpoints as a specific hosting option rather (it also seems to be the only place it is really mentioned).
  • the generic host is listed as a specific hosting option although it offers a variety of hosting integrations, e.g. including web applications
  • windows service hosting is in the "self-hosting" option which is explicitly separate from the generic host but links to the guidance which uses the generic host

Overall it seems the two pages have a lot of duplication and not a clear enough separation in regards to the documentation goal. The categorization of hosting options seems to be based on old versions and doesn't align well anymore with current hosting options.

timbussmann avatar Sep 09 '22 16:09 timbussmann