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
There is currently 0 organization within the documentation.
This is really bad for multiple issues:
coherence is lost, as everything blends together in the single document
there is no organization, no ToC, no sections
all this causes readers to get easily lost in the documentation
tiny scrollbars due to a single-document design means touching the scrollbar in any way can move you across entire sections of the documentations
The decision to have a single-document NXSL doc is REALLY BAD for UX / usability.
Example:
Let's assume I am a new user that wants to get familiar with available functions in NXSL.
In current wiki, let's look at this page:
It gives me a nice overview, I can see available functions, and what their purpose is.
I can then drill-down to each individual function, and get the details I want.
Let's look at the new documentation:
When a new user sees this, they will just be completely lost.
There is 0 structuring, no overview, just a lot of data dumped into a single page.
Huge scroll-bars will just scare new users away.
For existing users, it's MUCH easier to find what they need in the old documentation (Wiki), due to easier segmentation and organization of information.
The text was updated successfully, but these errors were encountered:
There is currently 0 organization within the documentation.
This is really bad for multiple issues:
The decision to have a single-document NXSL doc is REALLY BAD for UX / usability.
Example:

Let's assume I am a new user that wants to get familiar with available functions in NXSL.
In current wiki, let's look at this page:
It gives me a nice overview, I can see available functions, and what their purpose is.
I can then drill-down to each individual function, and get the details I want.
Let's look at the new documentation:

When a new user sees this, they will just be completely lost.
There is 0 structuring, no overview, just a lot of data dumped into a single page.
Huge scroll-bars will just scare new users away.
For existing users, it's MUCH easier to find what they need in the old documentation (Wiki), due to easier segmentation and organization of information.
The text was updated successfully, but these errors were encountered: