clojure-grimoire / grimoire

Community documentation of Clojure
http://conj.io
159 stars 41 forks source link

Rework example UI #221

Open arrdem opened 9 years ago

arrdem commented 9 years ago

Right now examples take entirely too much vertical screen space and for no clear reason the header is very prominent compared to the body text of notes. Since I don't support linking to examples, simply clearing the example header would probably be a big step forwards. Future UI versions should investigate better layouts of examples (tiling etc.)

arrdem commented 8 years ago

Some amount of this deployed tonight. The real blocker here is that more (most/all) defs need articles rather than raw unformatted strings. There's not a whole lot I can do besides blithely throw those strings at a markdown renderer and see what happens :expressionless:.

Also example quality overall remains fairly poor. Better than clojuredocs, but poor.