Description
As someone discovering nushell for the first time and coming across the main https://nushell.sh/ landing page, it's not apparent where to find documentation.
Suggestion: Add a glaringly obvious "Documentation" link rather than being buried in the "Get Nu" installation instruction hyperlinks.
Here's the current experience:
- Skimming through the brief sections - overview, "Get Nu", "Community" - you get to the bottom and think, "Wait that's all? Sounds cool but where's the documentation? Maybe I missed that section."
- You then re-read the page and see some hyperlinks in the "Get Nu" section and think "I'm not ready to get Nu yet - I'm just trying to learn about it. Maybe I need to look somewhere else."
- You re-re-read it again and see an inconspicuous hyperlink: "Nu speaks JSON, YAML, SQLite, Excel, and more out of the box." And then you finally think, "Well I guess that's probably the most likely place to find documentation, after exhaustively ruling out all other options."
- The "JSON, YAML, SQLite Excel, and more" hyperlink drops you into the middle of the main documentation page - not in the "Getting Started" but rather in "Nu Fundamentals."
- You then either navigate to the "Introduction" in the side bar, or go back to https://nushell.sh and try another link, in the installation instructions section of all places.
So ultimately you end up finding the documentation after this effort, and in that sense it's "fine, I guess." But one has to wonder how many people turn away before step 3. Worth keeping in mind that in many cases, this is a user's very first introduction to Nu. Until they get to experience its value, the onboarding experience ought to be as frictionless as possible.
Just an idea, from one newcomer's perspective. Thanks
Side note: There seems to be a common trend of putting installation instructions ahead of documentation - but just because everyone does it, it doesn't mean it's a good idea. Ask yourself, how often do you come across an intriguing tool where you know almost nothing about it, and think "I want to install that!" Never. It's always "I want to learn more, and then decide if it's something I want to install."