Add anchors to headers in LiveScript docs

[raine]

It would be great if you could link to h3's on http://livescript.net

[vendethiel]

Definitely! 👍

[dead-claudia]

@raine Here's an idea: make a PR. The site is in the gh-pages branch.

[phanimahesh]

Is there a separate source from which it is built, or do we have to edit raw html?

[gkz]

raw html

[phanimahesh]

Both the styles: <a name="anchor"></a> and <h3 id="anchor"> are being used on the page currently. @gkz: Do you have any preference, and if yes, should I clean up to have consistency?

How do we display something in the UI from where users can "get" the anchors? May be a tiny link icon next to h3s and other anchors on hover? Including everything in the navigation may be an overkill.

Also, isn't writing, editing and maintaining raw html a little tedious and error-prone? IMO, atleast the index should be autogenerated, and/or a pseudo-test to detect mistakes like adding links without corresponding targets, CSS rules that match no items, etc should be included. Would a PR be acceptable along those lines?

[raine]

How do we display something in the UI from where users can "get" the anchors?

Github style link icons on hover would work great.

[phanimahesh]

That was what I was suggesting. Will try that out for now, and we can choose whichever one looks best from all proposed alternates.