News for hackers. Stuff that matters.
Re:RAML - RESTful API modeling language by reedlaw on Wednesday October 02, 2013 @01:18PM (#6483816)
Did you try mouse-hovering over paragraphs?
Re:RAML - RESTful API modeling language by Patrick_Devine on Wednesday October 02, 2013 @03:00PM (#6484475)
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.

Re:RAML - RESTful API modeling language by shaunxcode on Wednesday October 02, 2013 @01:33PM (#6483915)
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.
Re:RAML - RESTful API modeling language by tommmmmm on Wednesday October 02, 2013 @01:41PM (#6483970)
Agreed, I shouldn't have to constantly move the mouse around just to read the page.