Fork me on GitHub
#docs
<
2017-10-17
>
lxsameer17:10:58

@seancorfield hi sean. You're working on some improvement for clojure docs, Am I right?

seancorfield17:10:23

@lxsameer I was part of a group of folks that discussed a "documentation hub" at Clojure/conj, yes.

lxsameer17:10:05

How can i learn more about the stuff you are doing

seancorfield17:10:51

The thinking is that if we can create a central hub of documentation for Clojure symbols (across all libraries), with an API that allows any tooling to retrieve it, we can improve the ecosystem for everyone. Right now, it's very much in the "ideas" phase. We don't have any concrete plans.

lxsameer17:10:48

I have an idea about clojure and how we can improve it .

lxsameer17:10:15

Should i create a thread for it on clojure_dev mailing list

seancorfield17:10:52

I think there will be more discussions -- somewhere, not sure where -- to flesh out the approach and build a list of things we need to do and people we need to talk to. Specifically, we need to get buy in from all the tooling projects and existing Clojure doc sites, that pulling documentation-as-data from a central hub is acceptable and that they would implement it.

seancorfield18:10:45

It's worth bearing in mind that the Clojure/core folks are happy to see the community take on this work but are probably not going to be involved themselves -- so clojure-dev is not an appropriate venue for the discussion around docs.

seancorfield18:10:23

But if you have ideas about improving Clojure-the-language, clojure-dev is appropriate.

lxsameer18:10:36

The idea i have involves clojure itself

lxsameer18:10:02

My idea is to add some features to spec or a similar entity in clojure itself

lxsameer18:10:43

Cool. Thanks a lot.