News for hackers. Stuff that matters.
Re:RAML - RESTful API modeling language by publicfig on Wednesday October 02, 2013 @01:13PM (#6483779)
Man, that page is hard to read.
Re:RAML - RESTful API modeling language by rjd on Wednesday October 02, 2013 @03:02PM (#6484496)
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 :/
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.