Documentation disappeared

[ArthurClemens]

fay-lang.org redirects now to this repo. I understand the original site contained documentation and demos - these are inaccessible.

[chrisdone]

We moved to the wiki a while ago. Probably updating the wiki is better. Although I can pass the domain over to @bergmark if he wants to repoint it to use Github's home pages or w/e.

[bergmark]

I don't think there's that much missing from the old website. There were some code generation examples that are probably outdated by now but we could add anything like that to the wiki!

[bnolan]

We really could do with some example code / a tutorial.

[bergmark]

What would you like the tutorial to address?

[bnolan]

An introduction to haskell using faye, showing what it supported, using the FFI to call out to javascript, and using javascript to call fay functions?

[bergmark]

We have some of this on the wiki already:

• https://github.com/faylang/fay/wiki/Foreign-function-interface
• https://github.com/faylang/fay/wiki/Calling-Fay-from-JavaScript

I added a page for what is not supported:

• https://github.com/faylang/fay/wiki/What-is-not-supported%3F

It's pretty hard to make an exhaustive list of what we do or don't support, and I'm not sure how useful it would be, but I'll keep adding things here if I come across things I think people care to know about :)

[chreekat]

As a small suggestion, I would suggest putting critical docs like "Installing and Running" somewhere other than under the heading, "Misc" :)

As for a bare-bones introduction to the ffi, here's a hello-world I just made. I don't know if it is useful to read, but it was very useful to write.

You could also point to the existing alert.hs as a super tiny code example.

[bergmark]

Heh, I was reorganizing that but I think i got distracted half way through or something :) Updated it, and added the alert example.

[bergmark]

I opened #358 for further documentation suggestions.