{"action":"created","issue":{"url":"https://api.github.com/repos/dotnet/core-docs/issues/408","repository_url":"https://api.github.com/repos/dotnet/core-docs","labels_url":"https://api.github.com/repos/dotnet/core-docs/issues/408/labels{/name}","comments_url":"https://api.github.com/repos/dotnet/core-docs/issues/408/comments","events_url":"https://api.github.com/repos/dotnet/core-docs/issues/408/events","html_url":"https://github.com/dotnet/core-docs/issues/408","id":149230743,"number":408,"title":".NET Core Concepts: Framing .NET Core","user":{"login":"cartermp","id":6309070,"avatar_url":"https://avatars.githubusercontent.com/u/6309070?v=3","gravatar_id":"","url":"https://api.github.com/users/cartermp","html_url":"https://github.com/cartermp","followers_url":"https://api.github.com/users/cartermp/followers","following_url":"https://api.github.com/users/cartermp/following{/other_user}","gists_url":"https://api.github.com/users/cartermp/gists{/gist_id}","starred_url":"https://api.github.com/users/cartermp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cartermp/subscriptions","organizations_url":"https://api.github.com/users/cartermp/orgs","repos_url":"https://api.github.com/users/cartermp/repos","events_url":"https://api.github.com/users/cartermp/events{/privacy}","received_events_url":"https://api.github.com/users/cartermp/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/dotnet/core-docs/labels/new%20content","name":"new content","color":"fbca04"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2016-04-18T18:19:35Z","updated_at":"2016-05-16T15:47:14Z","closed_at":null,"body":"We can benefit by having an article which focuses on framing .NET Core.  In short, this doc should be able to answer the following questions:\r\n\r\n- \"What is .NET Core and why should I care?\"\r\n- \"How is it different from the other .NET implementations and why should I care?\"\r\n- \"In what cases does .NET Core make sense for me?\"\r\n\r\nAnswers to these questions have crept into the porting-to-core articles, and it's easy for them to creep into future docs.  It's better to have that sort of framing in a central location we can link to.\r\n\r\nI propose the following structure as a starting point:\r\n\r\n1.  What is .NET Core and why should I care?\r\n\r\n   a. Overview of what .NET Core is, how it's composed of packages, and how that is rationalized with netstandard and netcoreapp\r\n   b. Overview of the unique benefits of .NET Core as compared to .NET Framework and Mono\r\n\r\n2. .NET Core compared with .NET Framework and Mono\r\n\r\n   a. Overview of the key differences between .NET Core and (.NET Framework and Mono)\r\n   b. Overview of the project system differences, why it matters, and links to project model docs\r\n\r\n3.  When does .NET Core matter for me? \r\n\r\n   a. Overview of the types of things you can build on .NET Core\r\n   b. Overview of the unique things you can do with .NET Core that you cannot do on .NET Framework and Mono\r\n\r\nThoughts?\r\n\r\n/cc @richlander @davidfowl "},"comment":{"url":"https://api.github.com/repos/dotnet/core-docs/issues/comments/219461071","html_url":"https://github.com/dotnet/core-docs/issues/408#issuecomment-219461071","issue_url":"https://api.github.com/repos/dotnet/core-docs/issues/408","id":219461071,"user":{"login":"rpetrusha","id":10886961,"avatar_url":"https://avatars.githubusercontent.com/u/10886961?v=3","gravatar_id":"","url":"https://api.github.com/users/rpetrusha","html_url":"https://github.com/rpetrusha","followers_url":"https://api.github.com/users/rpetrusha/followers","following_url":"https://api.github.com/users/rpetrusha/following{/other_user}","gists_url":"https://api.github.com/users/rpetrusha/gists{/gist_id}","starred_url":"https://api.github.com/users/rpetrusha/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rpetrusha/subscriptions","organizations_url":"https://api.github.com/users/rpetrusha/orgs","repos_url":"https://api.github.com/users/rpetrusha/repos","events_url":"https://api.github.com/users/rpetrusha/events{/privacy}","received_events_url":"https://api.github.com/users/rpetrusha/received_events","type":"User","site_admin":false},"created_at":"2016-05-16T15:47:14Z","updated_at":"2016-05-16T15:47:14Z","body":"Yes, it's intended to."}}