4 ms·
Great tool. I think this is why folks have trouble finding the docs: Whole entire site is docs everywhere, including home page. Links to "docs" are tiny on t
by mixmastamyk 4y ago
Great tool. I think this is why folks have trouble finding the docs:
Whole entire site is docs everywhere, including home page. Links to "docs" are tiny on the home page. Main menu calls them "library" instead of docs, why?
Majority of the stuff is focused on migration rather than new users. These two should be separated into separate tracks immediately. There is an attempt, but it gets lost somehow.
Also the release page linked here and "what's new in 2.0" go straight into the deep end, "inside baseball" style. These kind of pages should be very light. Tons of history-I'm personally not interested when trying to get something done. Unsolicited advice, move that into another blog post. ;-)
- zzzeek 4y agoThe link I posted here is the blog post. That's why it's historical and chatty, it's the blog post.
- inquirer39243 4y agoLove your tools! I think you should consider changing "library" to "documentation" - for whatever reason I also struggled to discover "library" actually meant docs - but only after I also clicked on a specific version. I think the best UI/UX for this is something like django's [0], where "documentation" brings you straight to the latest version's documentation. [0] https://www.djangoproject.com/ https://www.djangoproject.com/
- zzzeek 4y ago> I think you should consider changing "library" to "documentation" - for whatever reason I also struggled to discover "library" actually meant docs - but only after I also clicked on a specific version. you got it, look now > I think the best UI/UX for this is something like django's [0], where "documentation" brings you straight to the latest version's documentation. the design of our main docs index page was taken completely from how Django does it (e.g. how they have "paragraphs of links" at https://docs.djangoproject.com/en/4.1/ https://docs.djangoproject.com/en/4.1/)
- inquirer39243 4y agoOh yeah I love it! I don't know why but it's just way more intuitive this way for me at least, thanks!
- zzzeek 4y ago> Whole entire site is docs everywhere, including home page. Links to "docs" are tiny on the home page. you got it, look now. If you can't find the docs now, I dont know what to say. > Main menu calls them "library" instead of docs, why? A library is where you'd go to learn...but I guess, because the product is a "library", that's why it's not obvious? The term is gone from the nav etc. the sub-page is still called "library" but nobody needs to go there.