# Why isn't clojuredocs a mess?
**URL:** https://clojureverse.org/t/why-isnt-clojuredocs-a-mess/3785
**Category:** Watercooler
**Tags:** documentation
**Created:** [February 16, 2019, 6:02pm UTC](https://clojureverse.org/t/why-isnt-clojuredocs-a-mess/3785 "2019-02-16T18:02:22Z")
**Posts on this page:** 8
**Page:** 1
### Author:  [@mars0i](https://clojureverse.org/u/mars0i)
#### Post date: [February 16, 2019, 6:02pm UTC](https://clojureverse.org/t/why-isnt-clojuredocs-a-mess/3785/1 "2019-02-16T18:02:22Z")
[Clojuredocs.org](http://Clojuredocs.org) has been a wonderful resource for many years. This is kind of puzzling, because _anyone_ who registers as a Clojure contributor can add arbitrary examples, comments, and links to other functions to a function’s doc page.
I once suggested creating something similar in another language community, and the response was, “Oh, no. A doc site has to be carefully managed and curated by a small number of people, or it will be overrun by foolish newbies and web-spammers, and become useless.” That seems entirely reasonable. (There is now have a nice site in development [over there](https://ocamlverse.github.io/), but it is much more carefully controlled than clojuredocs seems to be.)
So why isn’t clojuredocs a mess? There are occasionally examples or comments that don’t exactly need to be there, but for the most part, everything I see there is potentially useful.
What explains this?
Do the creator, Zachary Kim, and others spend a lot of time weeding out junk? There’s no indication that I have found on the website or the github repo pages that this is part of the process.
Are Clojure developers, including newbies, all just reasonable people? (Would this change if Clojure were as popular as Python or Java?)
I’m curious about this, but it’s a valuable question to answer because it’s a potential lesson for other doc sites for other technologies.
(I’ll write to Z. Kim as well but I thought it would be worth discussing publicly here.)
---
### Author:  [@andy.fingerhut](https://clojureverse.org/u/andy.fingerhut)
#### Post date: [February 16, 2019, 8:19pm UTC](https://clojureverse.org/t/why-isnt-clojuredocs-a-mess/3785/2 "2019-02-16T20:19:33Z")
I think there are not a lot of people willing to edit those pages. In some cases, this might be because folks new to Clojure do not feel confident enough that their changes would be correct or useful.
---
### Author:  [@didibus](https://clojureverse.org/u/didibus)
#### Post date: [February 16, 2019, 9:13pm UTC](https://clojureverse.org/t/why-isnt-clojuredocs-a-mess/3785/3 "2019-02-16T21:13:36Z")
I love Clojuredocs. I wish Cider used it instead of Grimoire, as it has more and better examples in my opinion.
I think if bad examples or bad notes ever became an issue, adding a up/down voting system to them would solve the problem.
And if bots and spam became an issue, recaptcha could be used.
---
### Author:  [@alexmiller](https://clojureverse.org/u/alexmiller)
#### Post date: [February 17, 2019, 2:20am UTC](https://clojureverse.org/t/why-isnt-clojuredocs-a-mess/3785/4 "2019-02-17T02:20:12Z")
Because Clojurists are a wonderful and amazing group of people, obviously.
---
### Author:  [@mars0i](https://clojureverse.org/u/mars0i)
#### Post date: [February 17, 2019, 4:52am UTC](https://clojureverse.org/t/why-isnt-clojuredocs-a-mess/3785/5 "2019-02-17T04:52:18Z")
> [@andy.fingerhut](#):
>
> I think there are not a lot of people willing to edit those pages. In some cases, this might be because folks new to Clojure do not feel confident enough that their changes would be correct or useful.
So Clojurists have good judgement as well as being amazing and wonderful.
---
### Author:  [@linpengcheng](https://clojureverse.org/u/linpengcheng)
#### Post date: [February 17, 2019, 5:27am UTC](https://clojureverse.org/t/why-isnt-clojuredocs-a-mess/3785/6 "2019-02-17T05:27:33Z")
It would be better if it released a CHM offline file each year (or season), which could be easily used locally.
---
### Author:  [@pesterhazy](https://clojureverse.org/u/pesterhazy)
#### Post date: [February 17, 2019, 8:03am UTC](https://clojureverse.org/t/why-isnt-clojuredocs-a-mess/3785/7 "2019-02-17T08:03:53Z")
Thank you Zachary for a wonderful resource (in case you’re reading this)
---
### Author:  [@system](https://clojureverse.org/u/system)
#### Post date: [August 18, 2019, 8:03pm UTC](https://clojureverse.org/t/why-isnt-clojuredocs-a-mess/3785/8 "2019-08-18T20:03:53Z")
This topic was automatically closed 182 days after the last reply. New replies are no longer allowed.