It's hard to find information on documentation site

[dvdstelt]

Our documentation website contains all the information one might want to search for when developing software using the NServiceBus API.

However, it is not structured well

• Many pages are mostly composed of links with very little, to no, content. [1] [2] [3]
• Some subjects like transactions are scattered across the website and sometimes are located under a specific technology, whereas it's interesting to a broader audience. [1] [2] [3]
• Finding specific bits of information is hard because of a lack of proper structure
• Search doesn't help, as there is no weight to certain documents, and what you're searching for might be the 6th entry in the results.

We should investigate ways in which we can improve the searchability of the docs site