Improve UX in Getting Started (+ landing page nitpick) #63
Description
Getting Started sections on documentation should be really straightforward on the app's onboarding process. Let's take a look at the current Getting Started page and propose some improvements to user navigation experience.
Group all installation methods on a single one called Installing Inkdrop, where the body would have a new ordered list, now displaying the platform-specific contents:
Optimally, in a linear flow, there are 4 actions that users perform that needs to be documented in this page: Creating your Inkdrop account, Downloading, Installing and Log In.
Currently, thanks to the orderered list, the content may be read as a step-by-step documentation on how to start using Inkdrop, but there are more information being displayed than these just 4 main steps, so a proposed solution would be:
1. [Creating your Inkdrop account](https://docs.inkdrop.app/manual/#creating-your-inkdrop-account)
2. [Downloading the app](https://docs.inkdrop.app/manual/#downloading-the-app)
3. [Installing Inkdrop](https://docs.inkdrop.app/manual/#installing)
4. [Log in](https://docs.inkdrop.app/manual/#log-in)Then, a new Installing section, referencing to the platform-specific installation guides and also referencing to mobile versions, which are not mentioned on the documentation entrypoint (author may have a reason for not mentioning this one here, maybe it's because documentations are mostly visited via Desktop environments? valid criticisim to my issue)
Following other documentation patterns, content should be immediately after section title:
Currently, short-description related to Getting Started introduction is being displayed after the summary links. On most documentations, sections are composed by its titles and descriptions coming immediately after it. Thanks to the description nature of being a welcoming message for the user, the new ones who aren't familiarized will still read it and enjoy the warm message, but hard users who are more interested in the actual content will ignore it, instead of being baited to read thanks to a uncommon nature.
Additional Nitpicking: Docs aren't receiving enough attention on Inkdrop's landing page
Developers like to read documentation when they need to learn something new. So, it's expected from products targeting this audience to showcase links to it's documentation on a most optimal position possible.
Although Inkdrop is a developer targeted product, documentations are kind of "Hidden" (compared to other products targeting the same audience), having to hover on a toggle menu:
So, by including the Docs link at the navbar root level, it would get more traction to documentation proccess, therefore more users can discover more about the application ecosystem without having to leave the page and googling the docs.
Some examples below on other developer-targeted products:
