{"action":"created","issue":{"url":"https://api.github.com/repos/SuaveIO/suave/issues/527","repository_url":"https://api.github.com/repos/SuaveIO/suave","labels_url":"https://api.github.com/repos/SuaveIO/suave/issues/527/labels{/name}","comments_url":"https://api.github.com/repos/SuaveIO/suave/issues/527/comments","events_url":"https://api.github.com/repos/SuaveIO/suave/issues/527/events","html_url":"https://github.com/SuaveIO/suave/issues/527","id":187514960,"number":527,"title":"Documentation overhaul for v2","user":{"login":"haf","id":193115,"avatar_url":"https://avatars.githubusercontent.com/u/193115?v=3","gravatar_id":"","url":"https://api.github.com/users/haf","html_url":"https://github.com/haf","followers_url":"https://api.github.com/users/haf/followers","following_url":"https://api.github.com/users/haf/following{/other_user}","gists_url":"https://api.github.com/users/haf/gists{/gist_id}","starred_url":"https://api.github.com/users/haf/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/haf/subscriptions","organizations_url":"https://api.github.com/users/haf/orgs","repos_url":"https://api.github.com/users/haf/repos","events_url":"https://api.github.com/users/haf/events{/privacy}","received_events_url":"https://api.github.com/users/haf/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":7,"created_at":"2016-11-05T18:41:21Z","updated_at":"2016-11-11T05:16:37Z","closed_at":null,"body":"Let's sketch out some ideas for the documentation overhaul for v2 of Suave. This issue tracks creating a new web site that guides people towards being proficient at writing Suave code.\r\n\r\nSuggested structure:\r\n\r\n - Home page – single scrolling page, [served by server](https://github.com/SuaveIO/suave/tree/master/docs/server)\r\n   * Quick intro\r\n     > Suave is a simple web development F# library providing a lightweight web server and a set of combinators to manipulate route flow and web part composition.\r\n   * A counter that updates live, on how many browsers are connected using the `EventSource` module\r\n   * Three 'concepts' with illustrations\r\n     - functional – shows Hello World\r\n     - stand alone\r\n     - cloud / micro-services ready – Heroku, Kubernetes, Azure Functions links\r\n   * CTAs (with sublinks – expand on click?)\r\n     - Learn\r\n       - Walkthrough\r\n       - [Suave music store](https://www.gitbook.com/book/theimowski/suave-music-store/details)\r\n       - [F# Applied](http://products.tamizhvendan.in/fsharp-applied/)\r\n     - Go to community\r\n       - gitter.im\r\n       - github / github issues\r\n       - twitter.com/suaveio\r\n     - Commercial support\r\n       - Commercial support providers, e.g. Mark Grey?\r\n   * Walkthrough\r\n     - Outline – showcase e.g. [FsSnip](https://github.com/fssnippets/fssnip-website) including how it's hosted\r\n     - How to set up VSCode and .Net Core for Suave.IO usage, with screens/animated gifs\r\n     - Hello world (repeated)\r\n     - Filters – e.g. path, pathScan\r\n     - Testing your app so far with Suave.Testing\r\n     - Files\r\n     - Deferring execution with `warbler`/`request`/`context`\r\n     - Building HTML on the server with Experimental\r\n     - EventSource\r\n     - WebSocket\r\n     - Setting up log shipping, tracing and metrics with Logary\r\n     - Deploying to google cloud and Kubernetes\r\n     - Writing Azure Functions\r\n  * Nice to use with (tm)\r\n    - Fable\r\n    - Fable + ReactJS/webpack\r\n    - OWIN\r\n    - Suave.Swagger\r\n    - Suave.Hawk\r\n    - Suave.Locale\r\n    - Suave.OAuth\r\n    - Logary\r\n  * Concepts\r\n    - Security\r\n      * CSRF\r\n      * Authentication; basic, hawk, oauth, claims\r\n      * Authorisation\r\n      * TLS\r\n    - Logging\r\n    - Redirects\r\n    - Input validation & form binding\r\n    - Reverse proxying\r\n  * Contribution guidance\r\n\r\nAlso:\r\n\r\n - It would be great if each page had a link to itself in this repo, to allow quick changes\r\n - ..."},"comment":{"url":"https://api.github.com/repos/SuaveIO/suave/issues/comments/259883111","html_url":"https://github.com/SuaveIO/suave/issues/527#issuecomment-259883111","issue_url":"https://api.github.com/repos/SuaveIO/suave/issues/527","id":259883111,"user":{"login":"tamizhvendan","id":1128916,"avatar_url":"https://avatars.githubusercontent.com/u/1128916?v=3","gravatar_id":"","url":"https://api.github.com/users/tamizhvendan","html_url":"https://github.com/tamizhvendan","followers_url":"https://api.github.com/users/tamizhvendan/followers","following_url":"https://api.github.com/users/tamizhvendan/following{/other_user}","gists_url":"https://api.github.com/users/tamizhvendan/gists{/gist_id}","starred_url":"https://api.github.com/users/tamizhvendan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tamizhvendan/subscriptions","organizations_url":"https://api.github.com/users/tamizhvendan/orgs","repos_url":"https://api.github.com/users/tamizhvendan/repos","events_url":"https://api.github.com/users/tamizhvendan/events{/privacy}","received_events_url":"https://api.github.com/users/tamizhvendan/received_events","type":"User","site_admin":false},"created_at":"2016-11-11T05:16:37Z","updated_at":"2016-11-11T05:16:37Z","body":"A section on \"Sites using Suave\", \"Testimonials\" and I feel it would be nice to have a donation page. @haf and @ademar deserve it!"}}
{"actor":{"display_login":"tamizhvendan"}}