Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cljdoc/cljdoc

📚 A central documentation hub for the Clojure community
https://github.com/cljdoc/cljdoc

api clojure clojurescript docs documentation

Last synced: 3 months ago
JSON representation

📚 A central documentation hub for the Clojure community

Awesome Lists containing this project

README 

        
:notitle:

// num-contributors is updated automatically by doc-readme-update bb task

:num-contributors: 138



image:resources/public/cljdoc-logo-beta-square.png[cljdoc,100,100]



An effort to create a central documentation hub for the Clojure & ClojureScript ecosystem.



link:doc/userguide/for-library-authors.adoc[For Library Authors] | 

link:CONTRIBUTING.adoc[Contributing] | 

https://cljdoc.org/[Website] | 

https://www.youtube.com/watch?v=mWrvd6SE7Vg[ClojuTRE Talk]



[quote]

____

👋  Need help getting started? Say hi on https://telegram.me/martinklepsch[Telegram], https://twitter.com/martinklepsch[Twitter] or http://clojurians.net/[Clojurians Slack] in https://clojurians.slack.com/messages/C8V0BQ0M6/[#cljdoc].

____



https://circleci.com/gh/cljdoc/cljdoc[image:https://circleci.com/gh/cljdoc/cljdoc.svg?style=svg[CircleCI]]

link:#contributors[image:https://img.shields.io/badge/all_contributors-{num-contributors}-orange.svg?style=flat[Contributors]]

https://clojurians.slack.com/messages/C8V0BQ0M6/[image:https://badgen.net/badge/-/slack?icon=slack&label[Slack]]



== Rationale

[quote]

____

📹  I (Martin) gave https://www.youtube.com/watch?v=mWrvd6SE7Vg[a talk at ClojuTRE] about cljdoc which is probably a good intro if you want to understand what cljdoc is and why it exists. If you prefer text, read on for the Rationale.

____



Publishing Clojure library documentation is an often manual and error prone process.

Library authors who want to provide documentation need to set up tooling to create such documentation, host it and keep it updated.

In combination all these steps introduce a significant amount of friction that often leads to there not being any HTML documentation at all.

If there is documentation it's often only a matter of time until it's out of date with the latest release.



**In short:** Publishing documentation is hard. Harder than it has to be.



By fully automating the process of publishing documentation we can take a great burden from the shoulders of library maintainers and let them focus on shipping great libraries with great documentation.



A central place and consistent UI for all Clojure/Script library documentation will also make it easier for developers to find and work with documentation.



By centralizing this publishing process we can also build up a global understanding of the Clojure/Script ecosystem enabling many more interesting use-cases down the road.



=== Goals



- Provide an easy way to host library documentation for Clojure/Script library authors

- Deal with all the boring stuff: hosting, updating, keeping old versions around

- Build an ecosystem-encompassing database (+ API) of artifacts, namespaces and their contents.

- Support API documentation, articles and examples.

- Encourage the writing of more and better documentation.



== Contributing



. Take look at our link:CONTRIBUTING.adoc[Contributing doc]

. Get up and running by following the steps in link:doc/running-cljdoc-locally.adoc[Running cljdoc locally]

. Understand why things are the way they are by reading our link:CONTRIBUTING.adoc#architecture-decision-records[Architecture Decision Records]



== Contributors



// Contributors updated by doc-udpate-readme bb task, do not edit

// AUTO-GENERATED:CONTRIBUTORS-START

:imagesdir: ./doc/generated/people

[]

--

image:martinklepsch.png[martinklepsch,width=273,link="https://github.com/martinklepsch"]

image:borkdude.png[borkdude,width=273,link="https://github.com/borkdude"]

image:avichalp.png[avichalp,width=273,link="https://github.com/avichalp"]

image:dawranliou.png[dawranliou,width=273,link="https://github.com/dawranliou"]

image:residentsummer.png[residentsummer,width=273,link="https://github.com/residentsummer"]

image:tonsky.png[tonsky,width=273,link="https://github.com/tonsky"]

image:danielcompton.png[danielcompton,width=273,link="https://github.com/danielcompton"]

image:samihda.png[samihda,width=273,link="https://github.com/samihda"]

image:saskali.png[saskali,width=273,link="https://github.com/saskali"]

image:jorinvo.png[jorinvo,width=273,link="https://github.com/jorinvo"]

image:IamDrowsy.png[IamDrowsy,width=273,link="https://github.com/IamDrowsy"]

image:angusiguess.png[angusiguess,width=273,link="https://github.com/angusiguess"]

image:greg-kargin.png[greg-kargin,width=273,link="https://github.com/greg-kargin"]

image:rakyi.png[rakyi,width=273,link="https://github.com/rakyi"]

image:nikolap.png[nikolap,width=273,link="https://github.com/nikolap"]

image:mhuebert.png[mhuebert,width=273,link="https://github.com/mhuebert"]

image:elarous.png[elarous,width=273,link="https://github.com/elarous"]

image:mk.png[mk,width=273,link="https://github.com/mk"]

image:bbatsov.png[bbatsov,width=273,link="https://github.com/bbatsov"]

image:SevereOverfl0w.png[SevereOverfl0w,width=273,link="https://github.com/SevereOverfl0w"]

image:roman01la.png[roman01la,width=273,link="https://github.com/roman01la"]

image:mfikes.png[mfikes,width=273,link="https://github.com/mfikes"]

image:anthonygalea.png[anthonygalea,width=273,link="https://github.com/anthonygalea"]

image:devurandom.png[devurandom,width=273,link="https://github.com/devurandom"]

image:jsimpson-ovo.png[jsimpson-ovo,width=273,link="https://github.com/jsimpson-ovo"]

image:Tavistock.png[Tavistock,width=273,link="https://github.com/Tavistock"]

image:alex-dixon.png[alex-dixon,width=273,link="https://github.com/alex-dixon"]

image:timothypratley.png[timothypratley,width=273,link="https://github.com/timothypratley"]

image:kkinnear.png[kkinnear,width=273,link="https://github.com/kkinnear"]

image:karls.png[karls,width=273,link="https://github.com/karls"]

image:ikitommi.png[ikitommi,width=273,link="https://github.com/ikitommi"]

image:pesterhazy.png[pesterhazy,width=273,link="https://github.com/pesterhazy"]

image:eerohele.png[eerohele,width=273,link="https://github.com/eerohele"]

image:nberger.png[nberger,width=273,link="https://github.com/nberger"]

image:ajoberstar.png[ajoberstar,width=273,link="https://github.com/ajoberstar"]

image:polymeris.png[polymeris,width=273,link="https://github.com/polymeris"]

image:ryrobes.png[ryrobes,width=273,link="https://github.com/ryrobes"]

image:julienba.png[julienba,width=273,link="https://github.com/julienba"]

image:crimeminister.png[crimeminister,width=273,link="https://github.com/crimeminister"]

image:seancorfield.png[seancorfield,width=273,link="https://github.com/seancorfield"]

image:holyjak.png[holyjak,width=273,link="https://github.com/holyjak"]

image:lread.png[lread,width=273,link="https://github.com/lread"]

image:nha.png[nha,width=273,link="https://github.com/nha"]

image:mjhanninen.png[mjhanninen,width=273,link="https://github.com/mjhanninen"]

image:jacobobryant.png[jacobobryant,width=273,link="https://github.com/jacobobryant"]

image:lins05.png[lins05,width=273,link="https://github.com/lins05"]

image:jimmyhmiller.png[jimmyhmiller,width=273,link="https://github.com/jimmyhmiller"]

image:awkay.png[awkay,width=273,link="https://github.com/awkay"]

image:tobias.png[tobias,width=273,link="https://github.com/tobias"]

image:frozar.png[frozar,width=273,link="https://github.com/frozar"]

image:moonbrv.png[moonbrv,width=273,link="https://github.com/moonbrv"]

image:plexus.png[plexus,width=273,link="https://github.com/plexus"]

image:davidjameshumphreys.png[davidjameshumphreys,width=273,link="https://github.com/davidjameshumphreys"]

image:KingMob.png[KingMob,width=273,link="https://github.com/KingMob"]

image:green-coder.png[green-coder,width=273,link="https://github.com/green-coder"]

image:kolharsam.png[kolharsam,width=273,link="https://github.com/kolharsam"]

image:miikka.png[miikka,width=273,link="https://github.com/miikka"]

image:renatoalencar.png[renatoalencar,width=273,link="https://github.com/renatoalencar"]

image:kloimhardt.png[kloimhardt,width=273,link="https://github.com/kloimhardt"]

image:superstructor.png[superstructor,width=273,link="https://github.com/superstructor"]

image:corasaurus-hex.png[corasaurus-hex,width=273,link="https://github.com/corasaurus-hex"]

image:rvalentini.png[rvalentini,width=273,link="https://github.com/rvalentini"]

image:rollacaster.png[rollacaster,width=273,link="https://github.com/rollacaster"]

image:vemv.png[vemv,width=273,link="https://github.com/vemv"]

image:piotr-yuxuan.png[piotr-yuxuan,width=273,link="https://github.com/piotr-yuxuan"]

image:RickMoynihan.png[RickMoynihan,width=273,link="https://github.com/RickMoynihan"]

image:FieryCod.png[FieryCod,width=273,link="https://github.com/FieryCod"]

image:cloojure.png[cloojure,width=273,link="https://github.com/cloojure"]

image:IGJoshua.png[IGJoshua,width=273,link="https://github.com/IGJoshua"]

image:clyfe.png[clyfe,width=273,link="https://github.com/clyfe"]

image:sritchie.png[sritchie,width=273,link="https://github.com/sritchie"]

image:metasoarous.png[metasoarous,width=273,link="https://github.com/metasoarous"]

image:BrunoBonacci.png[BrunoBonacci,width=273,link="https://github.com/BrunoBonacci"]

image:anthony-khong.png[anthony-khong,width=273,link="https://github.com/anthony-khong"]

image:aaronEberhart.png[aaronEberhart,width=273,link="https://github.com/aaronEberhart"]

image:mpenet.png[mpenet,width=273,link="https://github.com/mpenet"]

image:cldwalker.png[cldwalker,width=273,link="https://github.com/cldwalker"]

image:dAnjou.png[dAnjou,width=273,link="https://github.com/dAnjou"]

image:wilkerlucio.png[wilkerlucio,width=273,link="https://github.com/wilkerlucio"]

image:jpmonettas.png[jpmonettas,width=273,link="https://github.com/jpmonettas"]

image:pragyanatvade.png[pragyanatvade,width=273,link="https://github.com/pragyanatvade"]

image:kxygk.png[kxygk,width=273,link="https://github.com/kxygk"]

image:JulienRouse.png[JulienRouse,width=273,link="https://github.com/JulienRouse"]

image:nblumoe.png[nblumoe,width=273,link="https://github.com/nblumoe"]

image:cjohansen.png[cjohansen,width=273,link="https://github.com/cjohansen"]

image:marcomorain.png[marcomorain,width=273,link="https://github.com/marcomorain"]

image:f-f.png[f-f,width=273,link="https://github.com/f-f"]

image:ghost.png[ghost,width=273,link="https://github.com/ghost"]

image:smahood.png[smahood,width=273,link="https://github.com/smahood"]

image:witek.png[witek,width=273,link="https://github.com/witek"]

image:thheller.png[thheller,width=273,link="https://github.com/thheller"]

image:zcaudate.png[zcaudate,width=273,link="https://github.com/zcaudate"]

image:rubygeek.png[rubygeek,width=273,link="https://github.com/rubygeek"]

image:Biserkov.png[Biserkov,width=273,link="https://github.com/Biserkov"]

image:bhb.png[bhb,width=273,link="https://github.com/bhb"]

image:aviflax.png[aviflax,width=273,link="https://github.com/aviflax"]

image:gnl.png[gnl,width=273,link="https://github.com/gnl"]

image:jmlsf.png[jmlsf,width=273,link="https://github.com/jmlsf"]

image:gacelita.png[gacelita,width=273,link="https://github.com/gacelita"]

image:l3nz.png[l3nz,width=273,link="https://github.com/l3nz"]

image:bfontaine.png[bfontaine,width=273,link="https://github.com/bfontaine"]

image:kumarshantanu.png[kumarshantanu,width=273,link="https://github.com/kumarshantanu"]

image:glts.png[glts,width=273,link="https://github.com/glts"]

image:Shashai.png[Shashai,width=273,link="https://github.com/Shashai"]

image:daveyarwood.png[daveyarwood,width=273,link="https://github.com/daveyarwood"]

image:erasmas.png[erasmas,width=273,link="https://github.com/erasmas"]

image:esuomi.png[esuomi,width=273,link="https://github.com/esuomi"]

image:j-cr.png[j-cr,width=273,link="https://github.com/j-cr"]

image:lilactown.png[lilactown,width=273,link="https://github.com/lilactown"]

image:noprompt.png[noprompt,width=273,link="https://github.com/noprompt"]

image:oskarkv.png[oskarkv,width=273,link="https://github.com/oskarkv"]

image:patrickaroo.png[patrickaroo,width=273,link="https://github.com/patrickaroo"]

image:puredanger.png[puredanger,width=273,link="https://github.com/puredanger"]

image:serioga.png[serioga,width=273,link="https://github.com/serioga"]

image:somecho.png[somecho,width=273,link="https://github.com/somecho"]

image:viebel.png[viebel,width=273,link="https://github.com/viebel"]

image:vlaaad.png[vlaaad,width=273,link="https://github.com/vlaaad"]

image:AdamFrey.png[AdamFrey,width=273,link="https://github.com/AdamFrey"]

image:Raynes.png[Raynes,width=273,link="https://github.com/Raynes"]

image:anmonteiro.png[anmonteiro,width=273,link="https://github.com/anmonteiro"]

image:atroche.png[atroche,width=273,link="https://github.com/atroche"]

image:ccfontes.png[ccfontes,width=273,link="https://github.com/ccfontes"]

image:davidsantiago.png[davidsantiago,width=273,link="https://github.com/davidsantiago"]

image:floybix.png[floybix,width=273,link="https://github.com/floybix"]

image:hugoduncan.png[hugoduncan,width=273,link="https://github.com/hugoduncan"]

image:ieure.png[ieure,width=273,link="https://github.com/ieure"]

image:metametadata.png[metametadata,width=273,link="https://github.com/metametadata"]

image:moea.png[moea,width=273,link="https://github.com/moea"]

image:moxaj.png[moxaj,width=273,link="https://github.com/moxaj"]

image:mtnygard.png[mtnygard,width=273,link="https://github.com/mtnygard"]

image:odyssomay.png[odyssomay,width=273,link="https://github.com/odyssomay"]

image:rm-hull.png[rm-hull,width=273,link="https://github.com/rm-hull"]

image:rwilson.png[rwilson,width=273,link="https://github.com/rwilson"]

image:sbauer322.png[sbauer322,width=273,link="https://github.com/sbauer322"]

image:tsulej.png[tsulej,width=273,link="https://github.com/tsulej"]

image:weavejester.png[weavejester,width=273,link="https://github.com/weavejester"]

image:ptaoussanis.png[ptaoussanis,width=273,link="https://github.com/ptaoussanis"]

image:tengstrand.png[tengstrand,width=273,link="https://github.com/tengstrand"]

--

// AUTO-GENERATED:CONTRIBUTORS-END

Did we leave someone out? That certainly was not our intention, please do let us know!



== License



`EPL-2.0` see `LICENSE`