On: RAML - RESTful API modeling language

[reedlaw]

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.