Современное состояние инструментов документации Clojure [закрыто]

За последний год или около того я видел различные объявления в списке обсуждения Clojure и других местах об инструментах для документирования кода Clojure. Они варьируются от полнофункциональных систем грамотного программирования, таких как Marginalia, и инструмента, используемого для создания книги «Clojure in Small Pieces» (или даже emacs org-mode), до более традиционных решений в стиле Javadoc, таких как Autodoc, и самого Javadoc, которые как сообщается, может использоваться с Clojure. Поиск в Google показывает разные другие, возможно, некоторые из них заслуживают большего внимания, и наверняка некоторые из них являются просто личными утилитами для создания документов. У меня вопрос: какие инструменты документирования лучше всего, и каковы их сильные и слабые стороны, исходя из вашего опыта их использования? На сегодняшний день я не использовал никаких инструментов для документации и хотел бы поэкспериментировать с одним или несколькими.

33
задан rplevy 17 March 2011 в 03:21
поделиться