Towards Awesome Clojure Documentation – Bozhidar Batsov

Bozhidar Batsov discusses the state of Clojure documentation, its challenges, and how the community can adopt better practices and conventions.

Most developers allegedly hate writing documentation. On the other hand, pretty much everyone considers good project documentation to be a strong indicator of the project's quality. Go figure! In this session we'll examine the state of the current documentation initiatives and practices in Clojure, some overall problems with documentation in Clojure and some potential solutions. Here's a few topics will touch upon: - the various Clojure documentation projects - the quality of the official Clojure documentation - lessons we can learn from other Lisps when it comes to documentation - adopting a common convention for structuring docstrings - additional documentation metadata Documenting things can be fun and extremely rewarding! Join us and find out how!