Documentation [was: Re: v8 DP3

[James Hale]

I too was interested in helping with the documentation but am a tad confused about its format.
It is not quite straight markdown, at least as far as any markdown editors I have put it through.
Also I had a look at the viewer.html and was blown away at how complicated it was.
Not that we need to deal with it, but given that it doesn't quite seem to be able to translate the "markdown" of the documentation fully perhaps we need more info on the required formatting.
As an example have a look at what it does to the "htmltext" entry. Things are fine until halfway through it and then things go awry.

BTW the JavaScript for the dictionary uses a hover function for the found entries. Lovely effect on a desktop, disaster on a touch device. Surely I am not the only one who likes to use a touch device to read the web, and yes, the documentation.

James