{"action":"created","comment":{"url":"https://api.github.com/repos/JuliaLang/julia/pulls/comments/79472634","id":79472634,"diff_hunk":"@@ -29,7 +29,7 @@ end\n \"\"\"\n     @enum EnumName EnumValue1[=x] EnumValue2[=y]\n \n-Create an [`Enum`](:obj:`Enum`) type with name `EnumName` and enum member values of\n+Create an `Enum` type with name `EnumName` and enum member values of","path":"base/Enums.jl","position":5,"original_position":5,"commit_id":"ace2fabe38f27756dd90b323608edaecb695f837","original_commit_id":"ace2fabe38f27756dd90b323608edaecb695f837","user":{"login":"MichaelHatherly","id":6144086,"avatar_url":"https://avatars.githubusercontent.com/u/6144086?v=3","gravatar_id":"","url":"https://api.github.com/users/MichaelHatherly","html_url":"https://github.com/MichaelHatherly","followers_url":"https://api.github.com/users/MichaelHatherly/followers","following_url":"https://api.github.com/users/MichaelHatherly/following{/other_user}","gists_url":"https://api.github.com/users/MichaelHatherly/gists{/gist_id}","starred_url":"https://api.github.com/users/MichaelHatherly/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/MichaelHatherly/subscriptions","organizations_url":"https://api.github.com/users/MichaelHatherly/orgs","repos_url":"https://api.github.com/users/MichaelHatherly/repos","events_url":"https://api.github.com/users/MichaelHatherly/events{/privacy}","received_events_url":"https://api.github.com/users/MichaelHatherly/received_events","type":"User","site_admin":false},"body":"Re: autodetection, I think we can probably add, at some point, a check to Documenter that will suggest non-references that could be references. ","created_at":"2016-09-19T19:43:23Z","updated_at":"2016-09-19T19:43:23Z","html_url":"https://github.com/JuliaLang/julia/pull/18588#discussion_r79472634","pull_request_url":"https://api.github.com/repos/JuliaLang/julia/pulls/18588","_links":{"self":{"href":"https://api.github.com/repos/JuliaLang/julia/pulls/comments/79472634"},"html":{"href":"https://github.com/JuliaLang/julia/pull/18588#discussion_r79472634"},"pull_request":{"href":"https://api.github.com/repos/JuliaLang/julia/pulls/18588"}}},"pull_request":{"url":"https://api.github.com/repos/JuliaLang/julia/pulls/18588","id":85853824,"html_url":"https://github.com/JuliaLang/julia/pull/18588","diff_url":"https://github.com/JuliaLang/julia/pull/18588.diff","patch_url":"https://github.com/JuliaLang/julia/pull/18588.patch","issue_url":"https://api.github.com/repos/JuliaLang/julia/issues/18588","number":18588,"state":"open","locked":false,"title":"Manual Conversion","user":{"login":"MichaelHatherly","id":6144086,"avatar_url":"https://avatars.githubusercontent.com/u/6144086?v=3","gravatar_id":"","url":"https://api.github.com/users/MichaelHatherly","html_url":"https://github.com/MichaelHatherly","followers_url":"https://api.github.com/users/MichaelHatherly/followers","following_url":"https://api.github.com/users/MichaelHatherly/following{/other_user}","gists_url":"https://api.github.com/users/MichaelHatherly/gists{/gist_id}","starred_url":"https://api.github.com/users/MichaelHatherly/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/MichaelHatherly/subscriptions","organizations_url":"https://api.github.com/users/MichaelHatherly/orgs","repos_url":"https://api.github.com/users/MichaelHatherly/repos","events_url":"https://api.github.com/users/MichaelHatherly/events{/privacy}","received_events_url":"https://api.github.com/users/MichaelHatherly/received_events","type":"User","site_admin":false},"body":"This moves the manual to markdown and uses Documenter.jl to generated the HTML docs.\r\n\r\nTODO items:\r\n\r\n- [ ] decide how to deploy the generated docs;\r\n- [ ] integrate `docs/make.jl` into the `Makefile`s;\r\n- [ ] move/remove the rest of the files in the old `doc/` directory;\r\n- [ ] check that the generated docs aren't broken.\r\n\r\nI've opened the branch for review now since it is at the point where further changes will need to be done manually and will become difficult to rebase (these changes touch most of `doc/` and `base/`) easily.\r\n\r\nMy suggestion would be to check that the converted docs haven't lost any information, all links still point to the correct places, and address the other TODO items above. After that has all been verified then merge this branch and further polishing and rearranging and/or restructuring of the manual can take place with less chance of running into merge conflicts.\r\n\r\nCurrently the \"doc checks\" part of the Documenter build is disabled. This includes checks such as doctests, missing docs, and missing/duplicate footnote checks. Fixing the warnings currently being raised when enabling these checks will each need individual attention, but can be split over several PRs to make reviewing easier. In my mind these checks are only *absolutely necessary* for a released version of Julia, and for `master` we can probably manage without them for a couple of days. If anyone feels that this isn't a good trade-off then I'll fix everything in this PR, but it may take a while longer to get it done properly.\r\n\r\nHere's a link the to generated docs to make reviewing a bit easier: https://michaelhatherly.github.io/julia-docs/. Note that source links for docstrings will 404 since the commits they point to aren't on `master`.\r\n","created_at":"2016-09-19T19:26:06Z","updated_at":"2016-09-19T19:43:23Z","closed_at":null,"merged_at":null,"merge_commit_sha":"4811d677a554b2cfe2a334be5795d11b4f1105db","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/JuliaLang/julia/pulls/18588/commits","review_comments_url":"https://api.github.com/repos/JuliaLang/julia/pulls/18588/comments","review_comment_url":"https://api.github.com/repos/JuliaLang/julia/pulls/comments{/number}","comments_url":"https://api.github.com/repos/JuliaLang/julia/issues/18588/comments","statuses_url":"https://api.github.com/repos/JuliaLang/julia/statuses/ace2fabe38f27756dd90b323608edaecb695f837","head":{"label":"MichaelHatherly:mh/markdown-docs","ref":"mh/markdown-docs","sha":"ace2fabe38f27756dd90b323608edaecb695f837","user":{"login":"MichaelHatherly","id":6144086,"avatar_url":"https://avatars.githubusercontent.com/u/6144086?v=3","gravatar_id":"","url":"https://api.github.com/users/MichaelHatherly","html_url":"https://github.com/MichaelHatherly","followers_url":"https://api.github.com/users/MichaelHatherly/followers","following_url":"https://api.github.com/users/MichaelHatherly/following{/other_user}","gists_url":"https://api.github.com/users/MichaelHatherly/gists{/gist_id}","starred_url":"https://api.github.com/users/MichaelHatherly/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/MichaelHatherly/subscriptions","organizations_url":"https://api.github.com/users/MichaelHatherly/orgs","repos_url":"https://api.github.com/users/MichaelHatherly/repos","events_url":"https://api.github.com/users/MichaelHatherly/events{/privacy}","received_events_url":"https://api.github.com/users/MichaelHatherly/received_events","type":"User","site_admin":false},"repo":{"id":15361317,"name":"julia","full_name":"MichaelHatherly/julia","owner":{"login":"MichaelHatherly","id":6144086,"avatar_url":"https://avatars.githubusercontent.com/u/6144086?v=3","gravatar_id":"","url":"https://api.github.com/users/MichaelHatherly","html_url":"https://github.com/MichaelHatherly","followers_url":"https://api.github.com/users/MichaelHatherly/followers","following_url":"https://api.github.com/users/MichaelHatherly/following{/other_user}","gists_url":"https://api.github.com/users/MichaelHatherly/gists{/gist_id}","starred_url":"https://api.github.com/users/MichaelHatherly/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/MichaelHatherly/subscriptions","organizations_url":"https://api.github.com/users/MichaelHatherly/orgs","repos_url":"https://api.github.com/users/MichaelHatherly/repos","events_url":"https://api.github.com/users/MichaelHatherly/events{/privacy}","received_events_url":"https://api.github.com/users/MichaelHatherly/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/MichaelHatherly/julia","description":"The Julia Language: A fresh approach to technical computing.","fork":true,"url":"https://api.github.com/repos/MichaelHatherly/julia","forks_url":"https://api.github.com/repos/MichaelHatherly/julia/forks","keys_url":"https://api.github.com/repos/MichaelHatherly/julia/keys{/key_id}","collaborators_url":"https://api.github.com/repos/MichaelHatherly/julia/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/MichaelHatherly/julia/teams","hooks_url":"https://api.github.com/repos/MichaelHatherly/julia/hooks","issue_events_url":"https://api.github.com/repos/MichaelHatherly/julia/issues/events{/number}","events_url":"https://api.github.com/repos/MichaelHatherly/julia/events","assignees_url":"https://api.github.com/repos/MichaelHatherly/julia/assignees{/user}","branches_url":"https://api.github.com/repos/MichaelHatherly/julia/branches{/branch}","tags_url":"https://api.github.com/repos/MichaelHatherly/julia/tags","blobs_url":"https://api.github.com/repos/MichaelHatherly/julia/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/MichaelHatherly/julia/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/MichaelHatherly/julia/git/refs{/sha}","trees_url":"https://api.github.com/repos/MichaelHatherly/julia/git/trees{/sha}","statuses_url":"https://api.github.com/repos/MichaelHatherly/julia/statuses/{sha}","languages_url":"https://api.github.com/repos/MichaelHatherly/julia/languages","stargazers_url":"https://api.github.com/repos/MichaelHatherly/julia/stargazers","contributors_url":"https://api.github.com/repos/MichaelHatherly/julia/contributors","subscribers_url":"https://api.github.com/repos/MichaelHatherly/julia/subscribers","subscription_url":"https://api.github.com/repos/MichaelHatherly/julia/subscription","commits_url":"https://api.github.com/repos/MichaelHatherly/julia/commits{/sha}","git_commits_url":"https://api.github.com/repos/MichaelHatherly/julia/git/commits{/sha}","comments_url":"https://api.github.com/repos/MichaelHatherly/julia/comments{/number}","issue_comment_url":"https://api.github.com/repos/MichaelHatherly/julia/issues/comments{/number}","contents_url":"https://api.github.com/repos/MichaelHatherly/julia/contents/{+path}","compare_url":"https://api.github.com/repos/MichaelHatherly/julia/compare/{base}...{head}","merges_url":"https://api.github.com/repos/MichaelHatherly/julia/merges","archive_url":"https://api.github.com/repos/MichaelHatherly/julia/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/MichaelHatherly/julia/downloads","issues_url":"https://api.github.com/repos/MichaelHatherly/julia/issues{/number}","pulls_url":"https://api.github.com/repos/MichaelHatherly/julia/pulls{/number}","milestones_url":"https://api.github.com/repos/MichaelHatherly/julia/milestones{/number}","notifications_url":"https://api.github.com/repos/MichaelHatherly/julia/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/MichaelHatherly/julia/labels{/name}","releases_url":"https://api.github.com/repos/MichaelHatherly/julia/releases{/id}","deployments_url":"https://api.github.com/repos/MichaelHatherly/julia/deployments","created_at":"2013-12-21T15:50:22Z","updated_at":"2014-06-28T08:05:54Z","pushed_at":"2016-09-19T19:22:13Z","git_url":"git://github.com/MichaelHatherly/julia.git","ssh_url":"git@github.com:MichaelHatherly/julia.git","clone_url":"https://github.com/MichaelHatherly/julia.git","svn_url":"https://github.com/MichaelHatherly/julia","homepage":"http://julialang.org/","size":81060,"stargazers_count":0,"watchers_count":0,"language":"Julia","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"JuliaLang:master","ref":"master","sha":"a6a8946a8f668798dbe641ac48860f9e192e58db","user":{"login":"JuliaLang","id":743164,"avatar_url":"https://avatars.githubusercontent.com/u/743164?v=3","gravatar_id":"","url":"https://api.github.com/users/JuliaLang","html_url":"https://github.com/JuliaLang","followers_url":"https://api.github.com/users/JuliaLang/followers","following_url":"https://api.github.com/users/JuliaLang/following{/other_user}","gists_url":"https://api.github.com/users/JuliaLang/gists{/gist_id}","starred_url":"https://api.github.com/users/JuliaLang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JuliaLang/subscriptions","organizations_url":"https://api.github.com/users/JuliaLang/orgs","repos_url":"https://api.github.com/users/JuliaLang/repos","events_url":"https://api.github.com/users/JuliaLang/events{/privacy}","received_events_url":"https://api.github.com/users/JuliaLang/received_events","type":"Organization","site_admin":false},"repo":{"id":1644196,"name":"julia","full_name":"JuliaLang/julia","owner":{"login":"JuliaLang","id":743164,"avatar_url":"https://avatars.githubusercontent.com/u/743164?v=3","gravatar_id":"","url":"https://api.github.com/users/JuliaLang","html_url":"https://github.com/JuliaLang","followers_url":"https://api.github.com/users/JuliaLang/followers","following_url":"https://api.github.com/users/JuliaLang/following{/other_user}","gists_url":"https://api.github.com/users/JuliaLang/gists{/gist_id}","starred_url":"https://api.github.com/users/JuliaLang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JuliaLang/subscriptions","organizations_url":"https://api.github.com/users/JuliaLang/orgs","repos_url":"https://api.github.com/users/JuliaLang/repos","events_url":"https://api.github.com/users/JuliaLang/events{/privacy}","received_events_url":"https://api.github.com/users/JuliaLang/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/JuliaLang/julia","description":"The Julia Language: A fresh approach to technical computing.","fork":false,"url":"https://api.github.com/repos/JuliaLang/julia","forks_url":"https://api.github.com/repos/JuliaLang/julia/forks","keys_url":"https://api.github.com/repos/JuliaLang/julia/keys{/key_id}","collaborators_url":"https://api.github.com/repos/JuliaLang/julia/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/JuliaLang/julia/teams","hooks_url":"https://api.github.com/repos/JuliaLang/julia/hooks","issue_events_url":"https://api.github.com/repos/JuliaLang/julia/issues/events{/number}","events_url":"https://api.github.com/repos/JuliaLang/julia/events","assignees_url":"https://api.github.com/repos/JuliaLang/julia/assignees{/user}","branches_url":"https://api.github.com/repos/JuliaLang/julia/branches{/branch}","tags_url":"https://api.github.com/repos/JuliaLang/julia/tags","blobs_url":"https://api.github.com/repos/JuliaLang/julia/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/JuliaLang/julia/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/JuliaLang/julia/git/refs{/sha}","trees_url":"https://api.github.com/repos/JuliaLang/julia/git/trees{/sha}","statuses_url":"https://api.github.com/repos/JuliaLang/julia/statuses/{sha}","languages_url":"https://api.github.com/repos/JuliaLang/julia/languages","stargazers_url":"https://api.github.com/repos/JuliaLang/julia/stargazers","contributors_url":"https://api.github.com/repos/JuliaLang/julia/contributors","subscribers_url":"https://api.github.com/repos/JuliaLang/julia/subscribers","subscription_url":"https://api.github.com/repos/JuliaLang/julia/subscription","commits_url":"https://api.github.com/repos/JuliaLang/julia/commits{/sha}","git_commits_url":"https://api.github.com/repos/JuliaLang/julia/git/commits{/sha}","comments_url":"https://api.github.com/repos/JuliaLang/julia/comments{/number}","issue_comment_url":"https://api.github.com/repos/JuliaLang/julia/issues/comments{/number}","contents_url":"https://api.github.com/repos/JuliaLang/julia/contents/{+path}","compare_url":"https://api.github.com/repos/JuliaLang/julia/compare/{base}...{head}","merges_url":"https://api.github.com/repos/JuliaLang/julia/merges","archive_url":"https://api.github.com/repos/JuliaLang/julia/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/JuliaLang/julia/downloads","issues_url":"https://api.github.com/repos/JuliaLang/julia/issues{/number}","pulls_url":"https://api.github.com/repos/JuliaLang/julia/pulls{/number}","milestones_url":"https://api.github.com/repos/JuliaLang/julia/milestones{/number}","notifications_url":"https://api.github.com/repos/JuliaLang/julia/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/JuliaLang/julia/labels{/name}","releases_url":"https://api.github.com/repos/JuliaLang/julia/releases{/id}","deployments_url":"https://api.github.com/repos/JuliaLang/julia/deployments","created_at":"2011-04-21T07:01:50Z","updated_at":"2016-09-19T12:31:20Z","pushed_at":"2016-09-19T19:29:27Z","git_url":"git://github.com/JuliaLang/julia.git","ssh_url":"git@github.com:JuliaLang/julia.git","clone_url":"https://github.com/JuliaLang/julia.git","svn_url":"https://github.com/JuliaLang/julia","homepage":"http://julialang.org/","size":422493,"stargazers_count":7512,"watchers_count":7512,"language":"Julia","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":1761,"mirror_url":null,"open_issues_count":1989,"forks":1761,"open_issues":1989,"watchers":7512,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/JuliaLang/julia/pulls/18588"},"html":{"href":"https://github.com/JuliaLang/julia/pull/18588"},"issue":{"href":"https://api.github.com/repos/JuliaLang/julia/issues/18588"},"comments":{"href":"https://api.github.com/repos/JuliaLang/julia/issues/18588/comments"},"review_comments":{"href":"https://api.github.com/repos/JuliaLang/julia/pulls/18588/comments"},"review_comment":{"href":"https://api.github.com/repos/JuliaLang/julia/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/JuliaLang/julia/pulls/18588/commits"},"statuses":{"href":"https://api.github.com/repos/JuliaLang/julia/statuses/ace2fabe38f27756dd90b323608edaecb695f837"}}}}
{"actor":{"display_login":"MichaelHatherly"}}