Skip to content
πŸ“š A central documentation hub for the Clojure community
Clojure JavaScript Shell HCL CSS TSQL Other
Branch: master
Clone or download

Latest commit

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci remove analysis runner code thats now in analyzer project May 1, 2020
.clj-kondo add clj-kondo linting Aug 22, 2019
.github add .github/FUNDING.yml May 25, 2019
data-test add @frozar as documentation contributor Apr 2, 2020
doc add version 0.6.1 to muuntaja URL in running-cljsdoc-locally.md Apr 16, 2020
js Implement custom search; fixes #85 Jun 5, 2019
modules remove re-frame config (#393) May 7, 2020
ops use infrequent access storage class for backups Nov 5, 2019
resources add @frozar as documentation contributor Apr 2, 2020
script add @frozar as documentation contributor Apr 2, 2020
src/cljdoc fix #400: upgrade analyzer Jun 4, 2020
test/cljdoc Builds using maven central are failing because http vs https. Jan 24, 2020
.all-contributorsrc add @frozar as documentation contributor Apr 2, 2020
.gitignore Ignore test-data/ generated by integration tests Nov 12, 2019
.prettierignore fix prettierignore patterns Nov 14, 2018
2019-11-19.logs.txt add @frozar as documentation contributor Apr 2, 2020
2019-11-19.single-log-line.txt add @frozar as documentation contributor Apr 2, 2020
CONTRIBUTING.adoc [DOC] Fix a tiny typography in CONTRIBUTING.adoc (#382) Apr 2, 2020
LICENSE add EPL-2.0 as LICENSE; fix #8 Jan 25, 2018
README.md add @frozar as documentation contributor Apr 2, 2020
article.md add @frozar as documentation contributor Apr 2, 2020
cljdoc-deploy add @frozar as documentation contributor Apr 2, 2020
cljdoc-deploy.pub add @frozar as documentation contributor Apr 2, 2020
deps.edn Handle namespaces with special symbols in its name (#385) Apr 16, 2020
mini-config.edn add @frozar as documentation contributor Apr 2, 2020
package-lock.json npm audit fix Apr 13, 2020
package.json npm audit fix Feb 14, 2020
tests.edn allow skipping of integration tests for faster watch mode, enable not… Mar 4, 2019

README.md

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

For Library Authors | Contributing | Website | ClojuTRE Talk

πŸ‘‹ Need help getting started? Say hi on Telegram, Twitter or Clojurians Slack in #cljdoc.

CircleCI cljdoc All Contributors slack

Rationale

πŸ“Ή I (Martin) gave 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

  1. Take look at our Contributing file
  2. Get up and running by following the steps in Running cljdoc locally
  3. Understand why things are the way they are by reading our Architecture Decision Records

Contributors

Michiel Borkent
Michiel Borkent

πŸ“– πŸ›
Avichal
Avichal

πŸ’»
Daw-Ran Liou
Daw-Ran Liou

πŸ’» πŸ“– πŸ’΅
Anton S
Anton S

πŸ’»
Nikita Prokopov
Nikita Prokopov

πŸ’» πŸ“–
Daniel Compton
Daniel Compton

πŸ’» πŸš‡
samihda
samihda

πŸ’»
saskali
saskali

πŸ’»
Jorin Vogel
Jorin Vogel

πŸ“– πŸ’»
Albrecht Schmidt
Albrecht Schmidt

πŸ’»
Angus Fletcher
Angus Fletcher

πŸ’» πŸ“–
greg
greg

πŸ’»
Martin RačÑk
Martin RačÑk

πŸš‡ πŸ’»
Nikola Peric
Nikola Peric

πŸ’»
Matt Huebert
Matt Huebert

πŸ’» 🎨
el arbaoui oussama
el arbaoui oussama

πŸ’»
Martin Kavalar
Martin Kavalar

πŸ’»
Bozhidar Batsov
Bozhidar Batsov

πŸ“–
Dominic Monroe
Dominic Monroe

πŸ“– πŸ’»
Roman Liutikov
Roman Liutikov

🎨 πŸ’»
Mike Fikes
Mike Fikes

πŸ“–
Anthony Galea
Anthony Galea

πŸ’»
Dennis Schridde
Dennis Schridde

πŸ“–
jsimpson-ovo
jsimpson-ovo

πŸ’»
Travis McNeill
Travis McNeill

πŸ’»
Alex Dixon
Alex Dixon

πŸ’» ⚠️
Timothy Pratley
Timothy Pratley

πŸ’»
Kim Kinnear
Kim Kinnear

πŸ’»
Karl Sutt
Karl Sutt

πŸ’»
Tommi Reiman
Tommi Reiman

πŸ’»
Paulus Esterhazy
Paulus Esterhazy

πŸ’»
Eero Helenius
Eero Helenius

πŸ’»
Nicolas Berger
Nicolas Berger

πŸ’΅
Andrew Oberstar
Andrew Oberstar

πŸ’΅
Camilo Polymeris
Camilo Polymeris

πŸ’΅
Ryan Robitaille
Ryan Robitaille

πŸ’΅
julien bille
julien bille

πŸ’΅
Robert Medeiros
Robert Medeiros

πŸ’΅
Sean Corfield
Sean Corfield

πŸ’¬
Jakub Holy
Jakub Holy

πŸ’» πŸ“–
Lee Read
Lee Read

πŸ“– πŸ’» πŸ‘€ πŸ’¬ 🎨
Nicolas Ha
Nicolas Ha

πŸ’»
Matti HΓ€nninen
Matti HΓ€nninen

πŸ“–
Jacob O'Bryant
Jacob O'Bryant

πŸ’»
Shuai Lin
Shuai Lin

πŸ’»
Jimmy Miller
Jimmy Miller

πŸ’» 🚧
Tony Kay
Tony Kay

πŸ›
Toby Crawley
Toby Crawley

πŸ› πŸ’»
ROZAR Fabien
ROZAR Fabien

πŸ“–

License

EPL-2.0 see LICENSE

You can’t perform that action at this time.