{"action":"created","issue":{"url":"https://api.github.com/repos/jgm/pandoc/issues/2055","repository_url":"https://api.github.com/repos/jgm/pandoc","labels_url":"https://api.github.com/repos/jgm/pandoc/issues/2055/labels{/name}","comments_url":"https://api.github.com/repos/jgm/pandoc/issues/2055/comments","events_url":"https://api.github.com/repos/jgm/pandoc/issues/2055/events","html_url":"https://github.com/jgm/pandoc/pull/2055","id":66500603,"number":2055,"title":".md extension for README","user":{"login":"raunaqrox","id":2609361,"avatar_url":"https://avatars.githubusercontent.com/u/2609361?v=3","gravatar_id":"","url":"https://api.github.com/users/raunaqrox","html_url":"https://github.com/raunaqrox","followers_url":"https://api.github.com/users/raunaqrox/followers","following_url":"https://api.github.com/users/raunaqrox/following{/other_user}","gists_url":"https://api.github.com/users/raunaqrox/gists{/gist_id}","starred_url":"https://api.github.com/users/raunaqrox/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/raunaqrox/subscriptions","organizations_url":"https://api.github.com/users/raunaqrox/orgs","repos_url":"https://api.github.com/users/raunaqrox/repos","events_url":"https://api.github.com/users/raunaqrox/events{/privacy}","received_events_url":"https://api.github.com/users/raunaqrox/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":11,"created_at":"2015-04-06T01:05:00Z","updated_at":"2016-03-31T17:49:06Z","closed_at":"2015-04-06T01:40:35Z","pull_request":{"url":"https://api.github.com/repos/jgm/pandoc/pulls/2055","html_url":"https://github.com/jgm/pandoc/pull/2055","diff_url":"https://github.com/jgm/pandoc/pull/2055.diff","patch_url":"https://github.com/jgm/pandoc/pull/2055.patch"},"body":"Github was not showing the README in markdown"},"comment":{"url":"https://api.github.com/repos/jgm/pandoc/issues/comments/204049141","html_url":"https://github.com/jgm/pandoc/pull/2055#issuecomment-204049141","issue_url":"https://api.github.com/repos/jgm/pandoc/issues/2055","id":204049141,"user":{"login":"jgm","id":3044,"avatar_url":"https://avatars.githubusercontent.com/u/3044?v=3","gravatar_id":"","url":"https://api.github.com/users/jgm","html_url":"https://github.com/jgm","followers_url":"https://api.github.com/users/jgm/followers","following_url":"https://api.github.com/users/jgm/following{/other_user}","gists_url":"https://api.github.com/users/jgm/gists{/gist_id}","starred_url":"https://api.github.com/users/jgm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jgm/subscriptions","organizations_url":"https://api.github.com/users/jgm/orgs","repos_url":"https://api.github.com/users/jgm/repos","events_url":"https://api.github.com/users/jgm/events{/privacy}","received_events_url":"https://api.github.com/users/jgm/received_events","type":"User","site_admin":false},"created_at":"2016-03-31T17:49:06Z","updated_at":"2016-03-31T17:49:06Z","body":"+++ John MacFarlane [Mar 31 16 09:34 ]:\n>+++ Jeff Dickey [Mar 31 16 08:31 ]:\n>>  It's hard to get non-dyed-in-the-wool nerds (like quasi-technical\n>>  stakeholders with veto powers) to read \"jumbled text\" as in the present\n>>  README as viewed on GitHub.\n>\n>Real dyed-in-the-wool nerds are happy to look at plain text,\n>like the pandoc README.\n>\n>But the main point is this:  pandoc's README is written in\n>pandoc's Markdown extension, which github doesn't support.\n>So, things like definition lists and footnotes won't be\n>rendered correctly if we rename as .md.\n\nTwo more notes on this:\n\n1.  You can point quasi-technical stakeholders to the\nofficial website, http://pandoc.org, which presents the\nREADME/User's Guide in all its glory:\nsee http://pandoc.org/README.html, or, if you prefer,\nhttp://pandoc.org/README.pdf.\n\n2.  You might ask:  why not just stick to the extensions\ngithub supports?  Mainly because footnotes and definition\nlists are important for this.  The pandoc man page is\ngenerated from the README, and definition lists are used\nfor lists of command-line options and other things.\n\n"}}