On: RAML - RESTful API modeling language

[publicfig]

Man, that page is hard to read.

[rjd → publicfig]

Especially if you are a skim reader, that grey to bright colour jump just ma me loose my place, and made it impossible to refer back. Probably the worst document page I've ever tried to read :/

[reedlaw → publicfig]

Did you try mouse-hovering over paragraphs?

[Patrick_Devine → reedlaw]

The content should be good enough that it can stand on its own instead of trying to be flashy. A simple doc and tutorial would have been sufficient.

I found the contrast of colours on the website almost unreadable.

[shaunxcode → reedlaw]

for me that is what made it difficult, I wanted to see the example in its entirety without having to hover back and forth. The hover "highlight" should be a "oh thats nice" interaction - not a required step for reading.

[tommmmmm → shaunxcode]

Agreed, I shouldn't have to constantly move the mouse around just to read the page.