tomfaulhaber / autodoc

The robot to automatically generate documentation for Clojure code. Used to generate the API docs for clojure.org.
121 stars 26 forks source link

Documentation clarity and accessibility #1

Closed dpawson closed 6 years ago

dpawson commented 14 years ago

http://richhickey.github.com/clojure/clojure.core-api.html#clojure.core/numerator I mistakenly looked for the numerator function in Clojure 1.1 The page states that this is a 1.2 feature.

The text on that page is too small to be clear, to me. Web Content needs to be accessible not to discriminate. The Table of contents on that page has next to no contrast.

I wear glasses but am not registered as having low vision.

Please consider Clojure users with less than perfect eye sight.

DaveP

puredanger commented 6 years ago
screen shot 2017-11-17 at 9 25 01 am

Current impl looks good to me.