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!
Towards Awesome Clojure Documentation – Bozhidar Batsov | |
| 57 Likes | 57 Dislikes |
| 2,197 views views | 1,162 followers |
| Science & Technology | Upload TimePublished on 5 Sep 2017 |
Không có nhận xét nào:
Đăng nhận xét