docs.particular.net
docs.particular.net copied to clipboard
Hosting documentation is confusing
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.