Particular / docs.particular.net

All content for ParticularDocs
https://docs.particular.net
Other
104 stars 300 forks source link

Feedback: 'Handlers' #5687

Open victorcassel opened 2 years ago

victorcassel commented 2 years ago

Feedback for 'Handlers' https://docs.particular.net/nservicebus/handlers/

Location in GitHub: https://github.com/Particular/docs.particular.net/blob/master/nservicebus/handlers/index.md

The structure in the page with the headers is not very clear: Too small differences in header styles, first of all. Then that Multiple handlers is talking about error behaviour and their solutions further down is only understood if you read the page very concentrated in one sitting, you won't get the bigger context from the header text och styles alone, and can't jump straight in. Example:

Behavior when there is no handler for a message

Multiple handlers for a single message

Alternatives

Events

Other messages

ramonsmits commented 2 years ago

@victorcassel Thanks for taking the opportunity to provide feedback. I would like to improve this page, would you have one of more suggestions on restructuring or point to a piece of text that must be easier to discover?

Is there a missing section or do you expect a section to be split?