Re:RAML - RESTful API modeling language
by publicfig on Wednesday October 02, 2013 @01:13PM
(#6483779)
Man, that page is hard to read.
[ Parent
| on HN ]
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.