Robert Fedoruk wrote:
On Wiki, each page had multiple sections. Clicking search results landed you in a comfy nest of useful information.
In many cases, Docs treats sections as whole separate pages.
This design is one of the biggest complaints I receive - that docs consists of a large number of pages with relatively little content, compared to wiki that had fewer pages with more content. It seemed people were used to hitting one long page then scrolling to sections of interest, rather then clicking further links.
Consequently this "over-normalisation" of pages increases search results, leaving readers to click many links in an effort to find their content of interest.
Curious to know if any visitor reports have been conducted on both sites: how did visitor numbers begin to drop on wiki once docs was launched, and how many visitors did wiki still continue to receive compared to docs?
I detest documentation that tersely explains: "${TOPIC}: you can ${TOPIC}". As an example, the above docs tell me I can use a global variable in inbound email actions, and that it can be used to reference fields on the email record.
But... no explanation of why I would use it, no benefits to using it, no situations when I wouldn't, no examples demonstrating its use... just "you can use it".
