Clojurians Log v2

@martinklepsch has joined the channel

@sekao has joined the channel

Would be curious if other people have thoughts on a centralized documentation platform for Clojure libraries: https://clojureverse.org/t/creating-a-central-documentation-repository-website-codox-complications/1287 Especially if you’re working on some documentation tooling yourself 🙂 /cc @arrdem @sekao

@martinklepsch lotta thoughts, where's best to engage with you on this?

@arrdem that forum thread is a good start, DMs also welcome ofc

mmk forum it is.

This is a really good writeup of the user flow for learning GraphQL: https://github.com/graphql/graphql.github.io/blob/source/notes/NewSiteArchitecture.md.

@arrdem Re your reply: are you aware of codox support for markdown docs? It seems to me that this could address the guides/cookbooks etc. part of documentation?

@martinklepsch I am aware of that support, I just don't think it goes nearly far enough and frankly I've never seen anyone use it.

Ok just checking, will read again + reply tmrw :) thanks for weighing in! 👍

Sure! Thanks for raising that conversation, I wasn't keeping an eye on clojureverse.