docs

About docs of Clojure & libs
admay 2017-10-03T13:00:10.000842Z

I just finished looking around on the Haskell site, https://www.haskell.org/ and it’s, I think, a great example of how to structure a documentation site. Specifically their documentation page, https://www.haskell.org/documentation. It’s a single link to a universal road map, like we were talking about, that’s intuitive to find.

alexmiller 2017-10-03T13:02:44.000233Z

https://clojure.org/community/resources ?

admay 2017-10-03T13:09:11.000397Z

Its a great page which, I think, should be the hub for anything documentation and presented on the front page as a “Don’t know where to go? Whatever you’re looking for, you can find it here” kind of thing

alexmiller 2017-10-03T14:30:33.000838Z

It’s linked on the front page on the right side bar in the Community block

admay 2017-10-03T14:33:30.000236Z

As ‘Community’, I’m thinking something like the Community hub for documentation resources would be beneficial. Not necessarily changing the purpose of the Community hub, but creating one for the guides, reference, APIs, etc…

alexmiller 2017-10-03T14:39:15.001037Z

Right now the main “guides” link just goes to the first guide. It could instead go to an overview page

alexmiller 2017-10-03T14:40:13.000262Z

or something could do that. I’ve never been entirely happy with the right side bar on the front page

admay 2017-10-03T14:40:40.000048Z

The ‘learn more’ side bar?

alexmiller 2017-10-03T14:47:06.000674Z

yeah - that could be doing more