You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
As a user of the platform
I need/want/expect to be able to navigate the user guide with ease
So that I can find relevant information where I expect it to be
Value / Purpose
The Analytical Platform user guide is difficult to navigate. Partially as a consequence of undesigned information architecture, and partially due to the overwhelming way the information is presented in the contents view - up to 300 entries can be visible in the left hand contents at once.
The search functionality of the docs sites can be quite poor, so doesn't offer a viable alternative to structured navigation. With this in mind, reworking the contents section will make the user guide more approachable and navigable for users.
Proposal
Improve the 'contents' view for the Analytical Platform User Guide.
Options include:
Use top-level-only headings in the left hand contents for the AP user guide (page titles only). A right-hand side contents is used for headings within pages (see VSCode docs)
Definition of Done
User GuideContents simplified
The text was updated successfully, but these errors were encountered:
User Story
As a user of the platform
I need/want/expect to be able to navigate the user guide with ease
So that I can find relevant information where I expect it to be
Value / Purpose
The Analytical Platform user guide is difficult to navigate. Partially as a consequence of undesigned information architecture, and partially due to the overwhelming way the information is presented in the contents view - up to 300 entries can be visible in the left hand contents at once.
The search functionality of the docs sites can be quite poor, so doesn't offer a viable alternative to structured navigation. With this in mind, reworking the contents section will make the user guide more approachable and navigable for users.
Proposal
Improve the 'contents' view for the Analytical Platform User Guide.
Options include:
Definition of Done
The text was updated successfully, but these errors were encountered: