Add samples and documentation

[nirvinm]

It is very hard to find documentation for Fable which negatively affects adopting it. Please add how-to guides for basic things like Fetch/Ajax.

[whitetigle]

Hi, thanks for taking time to evaluate Fable.

You should find relevant information in the official docs and official samples.

Just browse these links for more information:

• fable.io
• official doc
• samples link in the doc
• samples repo
• fetch + promise sample

[whitetigle]

Also please take a look at the tests in this repo you should find informative snippets. 😃

[fpellet]

I find it quite hard to use bindings and there are only simple examples.
No POST with data for example.

Since I wasted a lot of time migrating an old version of the fable, I would like to participate in the documentation and facilitate the learning of Fable.

Would you prefer to have a document in this repository or on the fable site?

[MangelMaxime]

Hello, @fpellet thank you for proposing to help.

I am planning to rework all the Fable website and migrate it to a new website generator. So I think for now we could just add the documentation to the README.md file or in a DOCUMENTATION.md file.

[reinux]

I'm actually not seeing any documentation regarding POST with data either in this repo or on Fable.

Maybe I'm missing something obvious, but I don't see anything regarding BodyInit or U3, and the link to the docs in the function (https://fable.io › docs › communicate › js-from-fable.html is just redirecting to home.

[MangelMaxime]

@reinux Fable documentation has been completely rewritten and during the process perhaps I missing adding a rediction for that page.

In any case, Fable documentation never contained documentation about Fable.Fetch itself.

Regarding sending a POST request you can check how it's done in JavaScript as Fable.Fetch is just a wrapper on top of the JS API.

It should look something like this:

open Fetch.Types
open Fable.Core.JsInterop

Fetch.fetch 
            "https://randomuser.me/api/" 
            [
                Method HttpMethod.POST
                Body (!^ "json")
            ]

[reinux]

Thanks, yeah, I ended up figuring it out, though not with such tight syntax:

        Fetch.fetchUnsafe "/api/upload-document" [
          RequestProperties.Method HttpMethod.POST
          RequestProperties.Body (U3.Case2 form)
        ]

I'm assuming U3 and !^ are from Fable, since they seem to have to do with js interop. When you get a chance, could you please link me in the right direction?

Thanks!

[MangelMaxime]

Here the section related to U2, U3, etc.

https://fable.io/docs/javascript/features.html#erased-unions