{"action":"created","issue":{"url":"https://api.github.com/repos/dotnet/orleans/issues/4310","repository_url":"https://api.github.com/repos/dotnet/orleans","labels_url":"https://api.github.com/repos/dotnet/orleans/issues/4310/labels{/name}","comments_url":"https://api.github.com/repos/dotnet/orleans/issues/4310/comments","events_url":"https://api.github.com/repos/dotnet/orleans/issues/4310/events","html_url":"https://github.com/dotnet/orleans/issues/4310","id":308779809,"number":4310,"title":"Tutorials for Orleans 2.0","user":{"login":"mehmetakbulut","id":18250141,"avatar_url":"https://avatars2.githubusercontent.com/u/18250141?v=4","gravatar_id":"","url":"https://api.github.com/users/mehmetakbulut","html_url":"https://github.com/mehmetakbulut","followers_url":"https://api.github.com/users/mehmetakbulut/followers","following_url":"https://api.github.com/users/mehmetakbulut/following{/other_user}","gists_url":"https://api.github.com/users/mehmetakbulut/gists{/gist_id}","starred_url":"https://api.github.com/users/mehmetakbulut/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mehmetakbulut/subscriptions","organizations_url":"https://api.github.com/users/mehmetakbulut/orgs","repos_url":"https://api.github.com/users/mehmetakbulut/repos","events_url":"https://api.github.com/users/mehmetakbulut/events{/privacy}","received_events_url":"https://api.github.com/users/mehmetakbulut/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-03-27T00:25:00Z","updated_at":"2018-03-27T00:40:33Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"This is issue ticket is intended to start a discussion on how the tutorials for Orleans 2.0 (and beyond) should  be developed. As we come up with tangible items to take action on, we can populate this post to track progress on these items."},"comment":{"url":"https://api.github.com/repos/dotnet/orleans/issues/comments/376357392","html_url":"https://github.com/dotnet/orleans/issues/4310#issuecomment-376357392","issue_url":"https://api.github.com/repos/dotnet/orleans/issues/4310","id":376357392,"user":{"login":"mehmetakbulut","id":18250141,"avatar_url":"https://avatars2.githubusercontent.com/u/18250141?v=4","gravatar_id":"","url":"https://api.github.com/users/mehmetakbulut","html_url":"https://github.com/mehmetakbulut","followers_url":"https://api.github.com/users/mehmetakbulut/followers","following_url":"https://api.github.com/users/mehmetakbulut/following{/other_user}","gists_url":"https://api.github.com/users/mehmetakbulut/gists{/gist_id}","starred_url":"https://api.github.com/users/mehmetakbulut/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mehmetakbulut/subscriptions","organizations_url":"https://api.github.com/users/mehmetakbulut/orgs","repos_url":"https://api.github.com/users/mehmetakbulut/repos","events_url":"https://api.github.com/users/mehmetakbulut/events{/privacy}","received_events_url":"https://api.github.com/users/mehmetakbulut/received_events","type":"User","site_admin":false},"created_at":"2018-03-27T00:40:33Z","updated_at":"2018-03-27T00:40:33Z","author_association":"CONTRIBUTOR","body":"Here are a few impressions I have from using the [1.x tutorials](https://dotnet.github.io/orleans/1.5/Tutorials/index.html) last year:\r\n\r\n- **Confusing Order.** The tutorials appear to be intended for sequential consumption. However the order in which they are presented doesn't really bode well for needs of someone learning from scratch.\r\n- **Too Verbose.** The tutorials are well written but suffer slightly from verbosity. We should aim to summarize as much as possible. (reader should be referred to other sections for details info)\r\n- **Reliance on Third Parties.** Showing how Orleans interfaces with third parties is great but detracts from the general learning goals. For example, the _Declarative Persistence_ tutorial depends on Azure. This is great if the reader's target environment is Azure but detracting for others. We should either write tutorials so there is no reliance on third-party services/software (i.e. the reader also learns how to substitute alternatives) and/or make sure there are alternate versions of the tutorial for alternative services/software.\r\n"}}
{"actor":{"display_login":"mehmetakbulut"}}