{"action":"created","comment":{"url":"https://api.github.com/repos/dotnet/core-docs/pulls/comments/70994965","id":70994965,"diff_hunk":"@@ -0,0 +1,321 @@\n+---\n+# required metadata\n+\n+title: [ARTICLE TITLE | SERVICE NAME]\n+description:\n+keywords:\n+author: [GITHUB USERNAME]\n+manager: wpickett\n+ms.date: [CREATION/UPDATE DATE]\n+ms.topic: article\n+ms.prod: .net-core\n+ms.technology: .net-core-technologies\n+ms.assetid: [GET ONE FROM guidgenerator.com]\n+\n+# optional metadata\n+\n+#ROBOTS:\n+#audience:\n+#ms.devlang: dotnet\n+#ms.reviewer: [ALIAS]\n+\n+---\n+\n+# Metadata and Markdown Template\n+\n+This core-docs template contains examples of Markdown syntax, as well as guidance on setting the metadata. To get the most of it, you must view both the [raw Markdown](https://raw.githubusercontent.com/dotnet/core-docs/master/template.md) and the [rendered view](https://github.com/dotnet/core-docs/blob/master/template.md) (for instance, the raw Markdown shows the metadata block, while the rendered view does not).\n+\n+When creating a Markdown file, you should copy this template to a new file, fill out the metadata as specified below, set the H1 heading above to the title of the article, and delete the content. \n+\n+\n+## Metadata \n+\n+The full metadata block is above (in the [raw Markdown](https://raw.githubusercontent.com/dotnet/core-docs/master/template.md)), divided into required fields and optional fields. Some key notes:\n+\n+- You **must** have a space between the colon (:) and the value for a metadata element.\n+- If an optional metadata element does not have a value, comment out the element with a # or remove it (do not leave it blank or use \"na\"); if you are adding a value to an element that was commented out, be sure to remove the #.\n+- Colons in a value (for example, a title) break the metadata parser. In this case, surround the title with double quotes (for example, `title: \"Writing .NET Core console apps: An advanced step-by-step guide\"`).\n+- **title**: This title will appear in search engine results. You can also add a pipe (|) followed by the product name (for example, `title: Developing Libraries with Cross Platform Tools | .NET Core`). The title doesn't need be identical to the title in your H1 heading and it should contain 65 characters or less (including | PRODUCT NAME).\n+- **author**, **manager**, **ms.reviewer**: The author field should contain the **GitHub username** of the author, not their alias.  The \"manager\" and \"ms.reviewer\" fields, on the other hand, should contain Microsoft aliases. ms.reviewer specifies the name of the PM/dev associated with the article or feature.\n+- **ms.devlang** defines the technology. Some of the supported values are: dotnet, cpp, csharp, fsharp, xml, vb and xml.\n+- **ms.assetid**: This is the GUID of the article that is used for internal tracking purposes such as Business Intelligence (BI). When creating a new Markdown file, get a GUID from [https://www.guidgenerator.com](https://www.guidgenerator.com). \n+\n+## Basic Markdown, GFM, and special characters\n+\n+All basic and GitHub-flavored Markdown (GFM) is supported. For more information on these, see:\n+\n+- [Baseline Markdown syntax](https://daringfireball.net/projects/markdown/syntax)\n+- [GitHub-flavored Markdown documentation](https://guides.github.com/features/mastering-markdown)\n+\n+Markdown uses special characters such as \\*, \\`, and \\# for formatting. If you wish to include one of these characters in your content, you must do one of two things:\n+\n+- Put a backslash before the special character to \"escape\" it (for example, `\\*` for a \\*)\n+- Use the [HTML entity code](http://www.ascii.cl/htmlcodes.htm) for the character (for example, `&#42;` for a &#42;).\n+\n+## File name\n+\n+File names use the following rules:\n+* Contain only lowercase letters, numbers, and hyphens.\n+* No spaces or punctuation characters. Use the hyphens to separate words and numbers in the file name.\n+* Use action verbs that are specific, such as develop, buy, build, troubleshoot. No -ing words.\n+* No small words - don't include a, and, the, in, or, etc.\n+* Must be in Markdown and use the .md file extension.\n+\n+## Headings\n+\n+Use sentence-style capitalization. Always capitalize:\n+- The first word of a heading. \n+- The word following a colon in a title or heading (for example, \"How to: Sort an array\"). \n+\n+Headings should be done using atx-style, that is, use 1-6 hash characters (#) at the start of the line to indicate a heading, corresponding to HTML headings levels H1 through H6. Examples of first- and second-level headers are used above. \n+\n+There **must** be only one first-level heading (H1) in your topic, which will be displayed as the on-page title.\n+\n+If your heading finishes with a `#` character, you need to add an extra `#` character in the end in order for the title to render correctly. For example, `# Async Programming in F# #`.     \n+\n+Second-level headings will generate the on-page TOC that appears in the \"In this article\" section underneath the on-page title.\n+\n+### Third-level heading\n+#### Fourth-level heading\n+##### Fifth level heading\n+###### Sixth-level heading\n+ \n+## Text styling\n+\n+*Italics*\n+ Use for files, folders, paths (for long items, split onto their own line) - new terms - URLs (unless rendered as links, which is the default).\n+\n+**Bold**\n+Use for UI elements.\n+\n+~~Strikethrough~~\n+\n+## Links\n+\n+### Internal Links\n+\n+To link to a header in the same Markdown file, view the source of the published article, find the id of the head (for example, `id=\"blockquote\"`), and link using # + id (for example, `#blockquote`).\n+\n+- Example: [Blockquotes](#blockquote)\n+\n+To link to a Markdown file in the same repo, use [relative links](https://www.w3.org/TR/WD-html40-970917/htmlweb.html#h-5.1.2), including the \".md\" at the end of the filename.\n+\n+- Example: [Readme file](readme.md)\n+- Example: [Welcome to .NET](./docs/welcome.md)\n+\n+To link to a header in a Markdown file in the same repo, use relative linking + hashtag linking.\n+\n+- Example: [.NET Community](./docs/welcome.md#community)\n+\n+### External Links","path":"template.md","position":110,"original_position":110,"commit_id":"a08a3e03d9c013afeb5f6748050807b355ff0887","original_commit_id":"a08a3e03d9c013afeb5f6748050807b355ff0887","user":{"login":"BillWagner","id":493969,"avatar_url":"https://avatars.githubusercontent.com/u/493969?v=3","gravatar_id":"","url":"https://api.github.com/users/BillWagner","html_url":"https://github.com/BillWagner","followers_url":"https://api.github.com/users/BillWagner/followers","following_url":"https://api.github.com/users/BillWagner/following{/other_user}","gists_url":"https://api.github.com/users/BillWagner/gists{/gist_id}","starred_url":"https://api.github.com/users/BillWagner/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/BillWagner/subscriptions","organizations_url":"https://api.github.com/users/BillWagner/orgs","repos_url":"https://api.github.com/users/BillWagner/repos","events_url":"https://api.github.com/users/BillWagner/events{/privacy}","received_events_url":"https://api.github.com/users/BillWagner/received_events","type":"User","site_admin":false},"body":"Same comment as above. Maybe just reference those docs?","created_at":"2016-07-15T15:46:57Z","updated_at":"2016-07-15T15:46:57Z","html_url":"https://github.com/dotnet/core-docs/pull/668#discussion_r70994965","pull_request_url":"https://api.github.com/repos/dotnet/core-docs/pulls/668","_links":{"self":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/comments/70994965"},"html":{"href":"https://github.com/dotnet/core-docs/pull/668#discussion_r70994965"},"pull_request":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/668"}}},"pull_request":{"url":"https://api.github.com/repos/dotnet/core-docs/pulls/668","id":75274854,"html_url":"https://github.com/dotnet/core-docs/pull/668","diff_url":"https://github.com/dotnet/core-docs/pull/668.diff","patch_url":"https://github.com/dotnet/core-docs/pull/668.patch","issue_url":"https://api.github.com/repos/dotnet/core-docs/issues/668","number":668,"state":"open","locked":false,"title":"changes to contribution guide","user":{"login":"mairaw","id":12971179,"avatar_url":"https://avatars.githubusercontent.com/u/12971179?v=3","gravatar_id":"","url":"https://api.github.com/users/mairaw","html_url":"https://github.com/mairaw","followers_url":"https://api.github.com/users/mairaw/followers","following_url":"https://api.github.com/users/mairaw/following{/other_user}","gists_url":"https://api.github.com/users/mairaw/gists{/gist_id}","starred_url":"https://api.github.com/users/mairaw/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mairaw/subscriptions","organizations_url":"https://api.github.com/users/mairaw/orgs","repos_url":"https://api.github.com/users/mairaw/repos","events_url":"https://api.github.com/users/mairaw/events{/privacy}","received_events_url":"https://api.github.com/users/mairaw/received_events","type":"User","site_admin":false},"body":"/cc @richlander @blackdwarf ","created_at":"2016-06-27T08:45:00Z","updated_at":"2016-07-15T15:46:57Z","closed_at":null,"merged_at":null,"merge_commit_sha":"3f9ad4cd78b7d6eddd68803ad8e271cb3d608cb4","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/dotnet/core-docs/pulls/668/commits","review_comments_url":"https://api.github.com/repos/dotnet/core-docs/pulls/668/comments","review_comment_url":"https://api.github.com/repos/dotnet/core-docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/dotnet/core-docs/issues/668/comments","statuses_url":"https://api.github.com/repos/dotnet/core-docs/statuses/a08a3e03d9c013afeb5f6748050807b355ff0887","head":{"label":"dotnet:contribguide","ref":"contribguide","sha":"a08a3e03d9c013afeb5f6748050807b355ff0887","user":{"login":"dotnet","id":9141961,"avatar_url":"https://avatars.githubusercontent.com/u/9141961?v=3","gravatar_id":"","url":"https://api.github.com/users/dotnet","html_url":"https://github.com/dotnet","followers_url":"https://api.github.com/users/dotnet/followers","following_url":"https://api.github.com/users/dotnet/following{/other_user}","gists_url":"https://api.github.com/users/dotnet/gists{/gist_id}","starred_url":"https://api.github.com/users/dotnet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dotnet/subscriptions","organizations_url":"https://api.github.com/users/dotnet/orgs","repos_url":"https://api.github.com/users/dotnet/repos","events_url":"https://api.github.com/users/dotnet/events{/privacy}","received_events_url":"https://api.github.com/users/dotnet/received_events","type":"Organization","site_admin":false},"repo":{"id":35890081,"name":"core-docs","full_name":"dotnet/core-docs","owner":{"login":"dotnet","id":9141961,"avatar_url":"https://avatars.githubusercontent.com/u/9141961?v=3","gravatar_id":"","url":"https://api.github.com/users/dotnet","html_url":"https://github.com/dotnet","followers_url":"https://api.github.com/users/dotnet/followers","following_url":"https://api.github.com/users/dotnet/following{/other_user}","gists_url":"https://api.github.com/users/dotnet/gists{/gist_id}","starred_url":"https://api.github.com/users/dotnet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dotnet/subscriptions","organizations_url":"https://api.github.com/users/dotnet/orgs","repos_url":"https://api.github.com/users/dotnet/repos","events_url":"https://api.github.com/users/dotnet/events{/privacy}","received_events_url":"https://api.github.com/users/dotnet/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/dotnet/core-docs","description":"This repository contains .NET Documentation.","fork":false,"url":"https://api.github.com/repos/dotnet/core-docs","forks_url":"https://api.github.com/repos/dotnet/core-docs/forks","keys_url":"https://api.github.com/repos/dotnet/core-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dotnet/core-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dotnet/core-docs/teams","hooks_url":"https://api.github.com/repos/dotnet/core-docs/hooks","issue_events_url":"https://api.github.com/repos/dotnet/core-docs/issues/events{/number}","events_url":"https://api.github.com/repos/dotnet/core-docs/events","assignees_url":"https://api.github.com/repos/dotnet/core-docs/assignees{/user}","branches_url":"https://api.github.com/repos/dotnet/core-docs/branches{/branch}","tags_url":"https://api.github.com/repos/dotnet/core-docs/tags","blobs_url":"https://api.github.com/repos/dotnet/core-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dotnet/core-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dotnet/core-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/dotnet/core-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dotnet/core-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/dotnet/core-docs/languages","stargazers_url":"https://api.github.com/repos/dotnet/core-docs/stargazers","contributors_url":"https://api.github.com/repos/dotnet/core-docs/contributors","subscribers_url":"https://api.github.com/repos/dotnet/core-docs/subscribers","subscription_url":"https://api.github.com/repos/dotnet/core-docs/subscription","commits_url":"https://api.github.com/repos/dotnet/core-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/dotnet/core-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/dotnet/core-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/dotnet/core-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/dotnet/core-docs/contents/{+path}","compare_url":"https://api.github.com/repos/dotnet/core-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dotnet/core-docs/merges","archive_url":"https://api.github.com/repos/dotnet/core-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dotnet/core-docs/downloads","issues_url":"https://api.github.com/repos/dotnet/core-docs/issues{/number}","pulls_url":"https://api.github.com/repos/dotnet/core-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/dotnet/core-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/dotnet/core-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dotnet/core-docs/labels{/name}","releases_url":"https://api.github.com/repos/dotnet/core-docs/releases{/id}","deployments_url":"https://api.github.com/repos/dotnet/core-docs/deployments","created_at":"2015-05-19T15:13:32Z","updated_at":"2016-07-15T06:06:46Z","pushed_at":"2016-07-15T05:32:29Z","git_url":"git://github.com/dotnet/core-docs.git","ssh_url":"git@github.com:dotnet/core-docs.git","clone_url":"https://github.com/dotnet/core-docs.git","svn_url":"https://github.com/dotnet/core-docs","homepage":"https://docs.microsoft.com/dotnet","size":17326,"stargazers_count":190,"watchers_count":190,"language":"PowerShell","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":211,"mirror_url":null,"open_issues_count":154,"forks":211,"open_issues":154,"watchers":190,"default_branch":"master"}},"base":{"label":"dotnet:master","ref":"master","sha":"2aec790ad37acc2b6783aa42d6551267d8d486c6","user":{"login":"dotnet","id":9141961,"avatar_url":"https://avatars.githubusercontent.com/u/9141961?v=3","gravatar_id":"","url":"https://api.github.com/users/dotnet","html_url":"https://github.com/dotnet","followers_url":"https://api.github.com/users/dotnet/followers","following_url":"https://api.github.com/users/dotnet/following{/other_user}","gists_url":"https://api.github.com/users/dotnet/gists{/gist_id}","starred_url":"https://api.github.com/users/dotnet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dotnet/subscriptions","organizations_url":"https://api.github.com/users/dotnet/orgs","repos_url":"https://api.github.com/users/dotnet/repos","events_url":"https://api.github.com/users/dotnet/events{/privacy}","received_events_url":"https://api.github.com/users/dotnet/received_events","type":"Organization","site_admin":false},"repo":{"id":35890081,"name":"core-docs","full_name":"dotnet/core-docs","owner":{"login":"dotnet","id":9141961,"avatar_url":"https://avatars.githubusercontent.com/u/9141961?v=3","gravatar_id":"","url":"https://api.github.com/users/dotnet","html_url":"https://github.com/dotnet","followers_url":"https://api.github.com/users/dotnet/followers","following_url":"https://api.github.com/users/dotnet/following{/other_user}","gists_url":"https://api.github.com/users/dotnet/gists{/gist_id}","starred_url":"https://api.github.com/users/dotnet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dotnet/subscriptions","organizations_url":"https://api.github.com/users/dotnet/orgs","repos_url":"https://api.github.com/users/dotnet/repos","events_url":"https://api.github.com/users/dotnet/events{/privacy}","received_events_url":"https://api.github.com/users/dotnet/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/dotnet/core-docs","description":"This repository contains .NET Documentation.","fork":false,"url":"https://api.github.com/repos/dotnet/core-docs","forks_url":"https://api.github.com/repos/dotnet/core-docs/forks","keys_url":"https://api.github.com/repos/dotnet/core-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dotnet/core-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dotnet/core-docs/teams","hooks_url":"https://api.github.com/repos/dotnet/core-docs/hooks","issue_events_url":"https://api.github.com/repos/dotnet/core-docs/issues/events{/number}","events_url":"https://api.github.com/repos/dotnet/core-docs/events","assignees_url":"https://api.github.com/repos/dotnet/core-docs/assignees{/user}","branches_url":"https://api.github.com/repos/dotnet/core-docs/branches{/branch}","tags_url":"https://api.github.com/repos/dotnet/core-docs/tags","blobs_url":"https://api.github.com/repos/dotnet/core-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dotnet/core-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dotnet/core-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/dotnet/core-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dotnet/core-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/dotnet/core-docs/languages","stargazers_url":"https://api.github.com/repos/dotnet/core-docs/stargazers","contributors_url":"https://api.github.com/repos/dotnet/core-docs/contributors","subscribers_url":"https://api.github.com/repos/dotnet/core-docs/subscribers","subscription_url":"https://api.github.com/repos/dotnet/core-docs/subscription","commits_url":"https://api.github.com/repos/dotnet/core-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/dotnet/core-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/dotnet/core-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/dotnet/core-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/dotnet/core-docs/contents/{+path}","compare_url":"https://api.github.com/repos/dotnet/core-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dotnet/core-docs/merges","archive_url":"https://api.github.com/repos/dotnet/core-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dotnet/core-docs/downloads","issues_url":"https://api.github.com/repos/dotnet/core-docs/issues{/number}","pulls_url":"https://api.github.com/repos/dotnet/core-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/dotnet/core-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/dotnet/core-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dotnet/core-docs/labels{/name}","releases_url":"https://api.github.com/repos/dotnet/core-docs/releases{/id}","deployments_url":"https://api.github.com/repos/dotnet/core-docs/deployments","created_at":"2015-05-19T15:13:32Z","updated_at":"2016-07-15T06:06:46Z","pushed_at":"2016-07-15T05:32:29Z","git_url":"git://github.com/dotnet/core-docs.git","ssh_url":"git@github.com:dotnet/core-docs.git","clone_url":"https://github.com/dotnet/core-docs.git","svn_url":"https://github.com/dotnet/core-docs","homepage":"https://docs.microsoft.com/dotnet","size":17326,"stargazers_count":190,"watchers_count":190,"language":"PowerShell","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":211,"mirror_url":null,"open_issues_count":154,"forks":211,"open_issues":154,"watchers":190,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/668"},"html":{"href":"https://github.com/dotnet/core-docs/pull/668"},"issue":{"href":"https://api.github.com/repos/dotnet/core-docs/issues/668"},"comments":{"href":"https://api.github.com/repos/dotnet/core-docs/issues/668/comments"},"review_comments":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/668/comments"},"review_comment":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/668/commits"},"statuses":{"href":"https://api.github.com/repos/dotnet/core-docs/statuses/a08a3e03d9c013afeb5f6748050807b355ff0887"}}}}
{"actor":{"display_login":"BillWagner"}}