{"action":"created","comment":{"url":"https://api.github.com/repos/apache/kafka/pulls/comments/92309276","pull_request_review_id":12821780,"id":92309276,"diff_hunk":"@@ -15,80 +15,84 @@\n  limitations under the License.\n -->\n \n-Kafka includes four core apis:\n-<ol>\n-  <li>The <a href=\"#producerapi\">Producer</a> API allows applications to send streams of data to topics in the Kafka cluster.\n-  <li>The <a href=\"#consumerapi\">Consumer</a> API allows applications to read streams of data from topics in the Kafka cluster.\n-  <li>The <a href=\"#streamsapi\">Streams</a> API allows transforming streams of data from input topics to output topics.\n-  <li>The <a href=\"#connectapi\">Connect</a> API allows implementing connectors that continually pull from some source system or application into Kafka or push from Kafka into some sink system or application.\n-</ol>\n-\n-Kafka exposes all its functionality over a language independent protocol which has clients available in many programming languages. However only the Java clients are maintained as part of the main Kafka project, the others are available as independent open source projects. A list of non-Java clients is available <a href=\"https://cwiki.apache.org/confluence/display/KAFKA/Clients\">here</a>.\n-\n-<h3><a id=\"producerapi\" href=\"#producerapi\">2.1 Producer API</a></h3>\n-\n-The Producer API allows applications to send streams of data to topics in the Kafka cluster.\n-<p>\n-Examples showing how to use the producer are given in the\n-<a href=\"/0100/javadoc/index.html?org/apache/kafka/clients/producer/KafkaProducer.html\" title=\"Kafka 0.10.0 Javadoc\">javadocs</a>.\n-<p>\n-To use the producer, you can use the following maven dependency:\n-\n-<pre>\n-\t&lt;dependency&gt;\n-\t    &lt;groupId&gt;org.apache.kafka&lt;/groupId&gt;\n-\t    &lt;artifactId&gt;kafka-clients&lt;/artifactId&gt;\n-\t    &lt;version&gt;0.10.0.0&lt;/version&gt;\n-\t&lt;/dependency&gt;\n-</pre>\n-\n-<h3><a id=\"consumerapi\" href=\"#consumerapi\">2.2 Consumer API</a></h3>\n-\n-The Consumer API allows applications to read streams of data from topics in the Kafka cluster.\n-<p>\n-Examples showing how to use the consumer are given in the\n-<a href=\"/0100/javadoc/index.html?org/apache/kafka/clients/consumer/KafkaConsumer.html\" title=\"Kafka 0.10.0 Javadoc\">javadocs</a>.\n-<p>\n-To use the consumer, you can use the following maven dependency:\n-<pre>\n-\t&lt;dependency&gt;\n-\t    &lt;groupId&gt;org.apache.kafka&lt;/groupId&gt;\n-\t    &lt;artifactId&gt;kafka-clients&lt;/artifactId&gt;\n-\t    &lt;version&gt;0.10.0.0&lt;/version&gt;\n-\t&lt;/dependency&gt;\n-</pre>\n-\n-<h3><a id=\"streamsapi\" href=\"#streamsapi\">2.3 Streams API</a></h3>\n-\n-The <a href=\"#streamsapi\">Streams</a> API allows transforming streams of data from input topics to output topics.\n-<p>\n-Examples showing how to use this library are given in the\n-<a href=\"/0100/javadoc/index.html?org/apache/kafka/streams/KafkaStreams.html\" title=\"Kafka 0.10.0 Javadoc\">javadocs</a>\n-<p>\n-Additional documentation on using the Streams API is available <a href=\"/documentation.html#streams\">here</a>.\n-<p>\n-To use Kafka Streams you can use the following maven dependency:\n-\n-<pre>\n-\t&lt;dependency&gt;\n-\t    &lt;groupId&gt;org.apache.kafka&lt;/groupId&gt;\n-\t    &lt;artifactId&gt;kafka-streams&lt;/artifactId&gt;\n-\t    &lt;version&gt;0.10.0.0&lt;/version&gt;\n-\t&lt;/dependency&gt;\n-</pre>\n-\n-<h3><a id=\"connectapi\" href=\"#connectapi\">2.4 Connect API</a></h3>\n-\n-The Connect API allows implementing connectors that continually pull from some source data system into Kafka or push from Kafka into some sink data system.\n-<p>\n-Many users of Connect won't need to use this API directly, though, they can use pre-built connectors without needing to write any code. Additional information on using Connect is available <a href=\"/documentation.html#connect\">here</a>.\n-<p>\n-Those who want to implement custom connectors can see the <a href=\"/0100/javadoc/index.html?org/apache/kafka/connect\" title=\"Kafka 0.10.0 Javadoc\">javadoc</a>.\n-<p>\n-\n-<h3><a id=\"legacyapis\" href=\"#streamsapi\">2.5 Legacy APIs</a></h3>\n-\n-<p>\n-A more limited legacy producer and consumer api is also included in Kafka. These old Scala APIs are deprecated and only still available for compatibility purposes. Information on them can be found here <a href=\"/081/documentation.html#producerapi\"  title=\"Kafka 0.8.1 Docs\">\n-here</a>.\n-</p>\n+<script id=\"api-template\" type=\"text/x-handlebars-template\">\n+\tKafka includes four core apis:\n+\t<ol>\n+\t<li>The <a href=\"#producerapi\">Producer</a> API allows applications to send streams of data to topics in the Kafka cluster.\n+\t<li>The <a href=\"#consumerapi\">Consumer</a> API allows applications to read streams of data from topics in the Kafka cluster.\n+\t<li>The <a href=\"#streamsapi\">Streams</a> API allows transforming streams of data from input topics to output topics.\n+\t<li>The <a href=\"#connectapi\">Connect</a> API allows implementing connectors that continually pull from some source system or application into Kafka or push from Kafka into some sink system or application.\n+\t</ol>\n+\n+\tKafka exposes all its functionality over a language independent protocol which has clients available in many programming languages. However only the Java clients are maintained as part of the main Kafka project, the others are available as independent open source projects. A list of non-Java clients is available <a href=\"https://cwiki.apache.org/confluence/display/KAFKA/Clients\">here</a>.\n+\n+\t<h3><a id=\"producerapi\" href=\"#producerapi\">2.1 Producer API</a></h3>\n+\n+\tThe Producer API allows applications to send streams of data to topics in the Kafka cluster.\n+\t<p>\n+\tExamples showing how to use the producer are given in the\n+\t<a href=\"/{{version}}/javadoc/index.html?org/apache/kafka/clients/producer/KafkaProducer.html\" title=\"Kafka 0.10.0 Javadoc\">javadocs</a>.\n+\t<p>\n+\tTo use the producer, you can use the following maven dependency:\n+\n+\t<pre>\n+\t\t&lt;dependency&gt;\n+\t\t\t&lt;groupId&gt;org.apache.kafka&lt;/groupId&gt;\n+\t\t\t&lt;artifactId&gt;kafka-clients&lt;/artifactId&gt;\n+\t\t\t&lt;version&gt;0.10.0.0&lt;/version&gt;","path":"docs/api.html","position":105,"original_position":105,"commit_id":"ed28eb4f017e78665847fc892907c77cf51e7c50","original_commit_id":"7c1e80e40655b5b71b1bc4cadd56ac12d3211fd3","user":{"login":"guozhangwang","id":10729597,"avatar_url":"https://avatars.githubusercontent.com/u/10729597?v=3","gravatar_id":"","url":"https://api.github.com/users/guozhangwang","html_url":"https://github.com/guozhangwang","followers_url":"https://api.github.com/users/guozhangwang/followers","following_url":"https://api.github.com/users/guozhangwang/following{/other_user}","gists_url":"https://api.github.com/users/guozhangwang/gists{/gist_id}","starred_url":"https://api.github.com/users/guozhangwang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/guozhangwang/subscriptions","organizations_url":"https://api.github.com/users/guozhangwang/orgs","repos_url":"https://api.github.com/users/guozhangwang/repos","events_url":"https://api.github.com/users/guozhangwang/events{/privacy}","received_events_url":"https://api.github.com/users/guozhangwang/received_events","type":"User","site_admin":false},"body":"Got it, we can work on that with a separate PR then.","created_at":"2016-12-14T01:58:20Z","updated_at":"2016-12-14T01:58:21Z","html_url":"https://github.com/apache/kafka/pull/2245#discussion_r92309276","pull_request_url":"https://api.github.com/repos/apache/kafka/pulls/2245","_links":{"self":{"href":"https://api.github.com/repos/apache/kafka/pulls/comments/92309276"},"html":{"href":"https://github.com/apache/kafka/pull/2245#discussion_r92309276"},"pull_request":{"href":"https://api.github.com/repos/apache/kafka/pulls/2245"}}},"pull_request":{"url":"https://api.github.com/repos/apache/kafka/pulls/2245","id":97609142,"html_url":"https://github.com/apache/kafka/pull/2245","diff_url":"https://github.com/apache/kafka/pull/2245.diff","patch_url":"https://github.com/apache/kafka/pull/2245.patch","issue_url":"https://api.github.com/repos/apache/kafka/issues/2245","number":2245,"state":"open","locked":false,"title":"Separate Streams documentation and setup docs with easy to set variables","user":{"login":"derrickdoo","id":271961,"avatar_url":"https://avatars.githubusercontent.com/u/271961?v=3","gravatar_id":"","url":"https://api.github.com/users/derrickdoo","html_url":"https://github.com/derrickdoo","followers_url":"https://api.github.com/users/derrickdoo/followers","following_url":"https://api.github.com/users/derrickdoo/following{/other_user}","gists_url":"https://api.github.com/users/derrickdoo/gists{/gist_id}","starred_url":"https://api.github.com/users/derrickdoo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/derrickdoo/subscriptions","organizations_url":"https://api.github.com/users/derrickdoo/orgs","repos_url":"https://api.github.com/users/derrickdoo/repos","events_url":"https://api.github.com/users/derrickdoo/events{/privacy}","received_events_url":"https://api.github.com/users/derrickdoo/received_events","type":"User","site_admin":false},"body":"- Seperate Streams documentation out to a standalone page. \r\n- Setup templates to use handlebars.js\r\n- Create template variables to swap in frequently updated values like version number from a single file templateData.js","created_at":"2016-12-12T18:42:26Z","updated_at":"2016-12-14T01:58:21Z","closed_at":null,"merged_at":null,"merge_commit_sha":"14ad5a5038a39024e5b9888bd440792c5047d4c0","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/apache/kafka/pulls/2245/commits","review_comments_url":"https://api.github.com/repos/apache/kafka/pulls/2245/comments","review_comment_url":"https://api.github.com/repos/apache/kafka/pulls/comments{/number}","comments_url":"https://api.github.com/repos/apache/kafka/issues/2245/comments","statuses_url":"https://api.github.com/repos/apache/kafka/statuses/ed28eb4f017e78665847fc892907c77cf51e7c50","head":{"label":"derrickdoo:docTemplates","ref":"docTemplates","sha":"ed28eb4f017e78665847fc892907c77cf51e7c50","user":{"login":"derrickdoo","id":271961,"avatar_url":"https://avatars.githubusercontent.com/u/271961?v=3","gravatar_id":"","url":"https://api.github.com/users/derrickdoo","html_url":"https://github.com/derrickdoo","followers_url":"https://api.github.com/users/derrickdoo/followers","following_url":"https://api.github.com/users/derrickdoo/following{/other_user}","gists_url":"https://api.github.com/users/derrickdoo/gists{/gist_id}","starred_url":"https://api.github.com/users/derrickdoo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/derrickdoo/subscriptions","organizations_url":"https://api.github.com/users/derrickdoo/orgs","repos_url":"https://api.github.com/users/derrickdoo/repos","events_url":"https://api.github.com/users/derrickdoo/events{/privacy}","received_events_url":"https://api.github.com/users/derrickdoo/received_events","type":"User","site_admin":false},"repo":{"id":70528942,"name":"kafka","full_name":"derrickdoo/kafka","owner":{"login":"derrickdoo","id":271961,"avatar_url":"https://avatars.githubusercontent.com/u/271961?v=3","gravatar_id":"","url":"https://api.github.com/users/derrickdoo","html_url":"https://github.com/derrickdoo","followers_url":"https://api.github.com/users/derrickdoo/followers","following_url":"https://api.github.com/users/derrickdoo/following{/other_user}","gists_url":"https://api.github.com/users/derrickdoo/gists{/gist_id}","starred_url":"https://api.github.com/users/derrickdoo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/derrickdoo/subscriptions","organizations_url":"https://api.github.com/users/derrickdoo/orgs","repos_url":"https://api.github.com/users/derrickdoo/repos","events_url":"https://api.github.com/users/derrickdoo/events{/privacy}","received_events_url":"https://api.github.com/users/derrickdoo/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/derrickdoo/kafka","description":"Mirror of Apache Kafka","fork":true,"url":"https://api.github.com/repos/derrickdoo/kafka","forks_url":"https://api.github.com/repos/derrickdoo/kafka/forks","keys_url":"https://api.github.com/repos/derrickdoo/kafka/keys{/key_id}","collaborators_url":"https://api.github.com/repos/derrickdoo/kafka/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/derrickdoo/kafka/teams","hooks_url":"https://api.github.com/repos/derrickdoo/kafka/hooks","issue_events_url":"https://api.github.com/repos/derrickdoo/kafka/issues/events{/number}","events_url":"https://api.github.com/repos/derrickdoo/kafka/events","assignees_url":"https://api.github.com/repos/derrickdoo/kafka/assignees{/user}","branches_url":"https://api.github.com/repos/derrickdoo/kafka/branches{/branch}","tags_url":"https://api.github.com/repos/derrickdoo/kafka/tags","blobs_url":"https://api.github.com/repos/derrickdoo/kafka/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/derrickdoo/kafka/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/derrickdoo/kafka/git/refs{/sha}","trees_url":"https://api.github.com/repos/derrickdoo/kafka/git/trees{/sha}","statuses_url":"https://api.github.com/repos/derrickdoo/kafka/statuses/{sha}","languages_url":"https://api.github.com/repos/derrickdoo/kafka/languages","stargazers_url":"https://api.github.com/repos/derrickdoo/kafka/stargazers","contributors_url":"https://api.github.com/repos/derrickdoo/kafka/contributors","subscribers_url":"https://api.github.com/repos/derrickdoo/kafka/subscribers","subscription_url":"https://api.github.com/repos/derrickdoo/kafka/subscription","commits_url":"https://api.github.com/repos/derrickdoo/kafka/commits{/sha}","git_commits_url":"https://api.github.com/repos/derrickdoo/kafka/git/commits{/sha}","comments_url":"https://api.github.com/repos/derrickdoo/kafka/comments{/number}","issue_comment_url":"https://api.github.com/repos/derrickdoo/kafka/issues/comments{/number}","contents_url":"https://api.github.com/repos/derrickdoo/kafka/contents/{+path}","compare_url":"https://api.github.com/repos/derrickdoo/kafka/compare/{base}...{head}","merges_url":"https://api.github.com/repos/derrickdoo/kafka/merges","archive_url":"https://api.github.com/repos/derrickdoo/kafka/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/derrickdoo/kafka/downloads","issues_url":"https://api.github.com/repos/derrickdoo/kafka/issues{/number}","pulls_url":"https://api.github.com/repos/derrickdoo/kafka/pulls{/number}","milestones_url":"https://api.github.com/repos/derrickdoo/kafka/milestones{/number}","notifications_url":"https://api.github.com/repos/derrickdoo/kafka/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/derrickdoo/kafka/labels{/name}","releases_url":"https://api.github.com/repos/derrickdoo/kafka/releases{/id}","deployments_url":"https://api.github.com/repos/derrickdoo/kafka/deployments","created_at":"2016-10-10T21:08:02Z","updated_at":"2016-10-10T21:08:08Z","pushed_at":"2016-12-14T00:02:56Z","git_url":"git://github.com/derrickdoo/kafka.git","ssh_url":"git@github.com:derrickdoo/kafka.git","clone_url":"https://github.com/derrickdoo/kafka.git","svn_url":"https://github.com/derrickdoo/kafka","homepage":null,"size":37409,"stargazers_count":0,"watchers_count":0,"language":"Java","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":"trunk"}},"base":{"label":"apache:trunk","ref":"trunk","sha":"448f194c70e7a66ae2f1a7e89c822032359b14c9","user":{"login":"apache","id":47359,"avatar_url":"https://avatars.githubusercontent.com/u/47359?v=3","gravatar_id":"","url":"https://api.github.com/users/apache","html_url":"https://github.com/apache","followers_url":"https://api.github.com/users/apache/followers","following_url":"https://api.github.com/users/apache/following{/other_user}","gists_url":"https://api.github.com/users/apache/gists{/gist_id}","starred_url":"https://api.github.com/users/apache/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/apache/subscriptions","organizations_url":"https://api.github.com/users/apache/orgs","repos_url":"https://api.github.com/users/apache/repos","events_url":"https://api.github.com/users/apache/events{/privacy}","received_events_url":"https://api.github.com/users/apache/received_events","type":"Organization","site_admin":false},"repo":{"id":2211243,"name":"kafka","full_name":"apache/kafka","owner":{"login":"apache","id":47359,"avatar_url":"https://avatars.githubusercontent.com/u/47359?v=3","gravatar_id":"","url":"https://api.github.com/users/apache","html_url":"https://github.com/apache","followers_url":"https://api.github.com/users/apache/followers","following_url":"https://api.github.com/users/apache/following{/other_user}","gists_url":"https://api.github.com/users/apache/gists{/gist_id}","starred_url":"https://api.github.com/users/apache/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/apache/subscriptions","organizations_url":"https://api.github.com/users/apache/orgs","repos_url":"https://api.github.com/users/apache/repos","events_url":"https://api.github.com/users/apache/events{/privacy}","received_events_url":"https://api.github.com/users/apache/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/apache/kafka","description":"Mirror of Apache Kafka","fork":false,"url":"https://api.github.com/repos/apache/kafka","forks_url":"https://api.github.com/repos/apache/kafka/forks","keys_url":"https://api.github.com/repos/apache/kafka/keys{/key_id}","collaborators_url":"https://api.github.com/repos/apache/kafka/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/apache/kafka/teams","hooks_url":"https://api.github.com/repos/apache/kafka/hooks","issue_events_url":"https://api.github.com/repos/apache/kafka/issues/events{/number}","events_url":"https://api.github.com/repos/apache/kafka/events","assignees_url":"https://api.github.com/repos/apache/kafka/assignees{/user}","branches_url":"https://api.github.com/repos/apache/kafka/branches{/branch}","tags_url":"https://api.github.com/repos/apache/kafka/tags","blobs_url":"https://api.github.com/repos/apache/kafka/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/apache/kafka/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/apache/kafka/git/refs{/sha}","trees_url":"https://api.github.com/repos/apache/kafka/git/trees{/sha}","statuses_url":"https://api.github.com/repos/apache/kafka/statuses/{sha}","languages_url":"https://api.github.com/repos/apache/kafka/languages","stargazers_url":"https://api.github.com/repos/apache/kafka/stargazers","contributors_url":"https://api.github.com/repos/apache/kafka/contributors","subscribers_url":"https://api.github.com/repos/apache/kafka/subscribers","subscription_url":"https://api.github.com/repos/apache/kafka/subscription","commits_url":"https://api.github.com/repos/apache/kafka/commits{/sha}","git_commits_url":"https://api.github.com/repos/apache/kafka/git/commits{/sha}","comments_url":"https://api.github.com/repos/apache/kafka/comments{/number}","issue_comment_url":"https://api.github.com/repos/apache/kafka/issues/comments{/number}","contents_url":"https://api.github.com/repos/apache/kafka/contents/{+path}","compare_url":"https://api.github.com/repos/apache/kafka/compare/{base}...{head}","merges_url":"https://api.github.com/repos/apache/kafka/merges","archive_url":"https://api.github.com/repos/apache/kafka/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/apache/kafka/downloads","issues_url":"https://api.github.com/repos/apache/kafka/issues{/number}","pulls_url":"https://api.github.com/repos/apache/kafka/pulls{/number}","milestones_url":"https://api.github.com/repos/apache/kafka/milestones{/number}","notifications_url":"https://api.github.com/repos/apache/kafka/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/apache/kafka/labels{/name}","releases_url":"https://api.github.com/repos/apache/kafka/releases{/id}","deployments_url":"https://api.github.com/repos/apache/kafka/deployments","created_at":"2011-08-15T18:06:16Z","updated_at":"2016-12-14T01:47:41Z","pushed_at":"2016-12-14T01:37:28Z","git_url":"git://github.com/apache/kafka.git","ssh_url":"git@github.com:apache/kafka.git","clone_url":"https://github.com/apache/kafka.git","svn_url":"https://github.com/apache/kafka","homepage":null,"size":37525,"stargazers_count":4268,"watchers_count":4268,"language":"Java","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":2661,"mirror_url":"git://git.apache.org/kafka.git","open_issues_count":305,"forks":2661,"open_issues":305,"watchers":4268,"default_branch":"trunk"}},"_links":{"self":{"href":"https://api.github.com/repos/apache/kafka/pulls/2245"},"html":{"href":"https://github.com/apache/kafka/pull/2245"},"issue":{"href":"https://api.github.com/repos/apache/kafka/issues/2245"},"comments":{"href":"https://api.github.com/repos/apache/kafka/issues/2245/comments"},"review_comments":{"href":"https://api.github.com/repos/apache/kafka/pulls/2245/comments"},"review_comment":{"href":"https://api.github.com/repos/apache/kafka/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/apache/kafka/pulls/2245/commits"},"statuses":{"href":"https://api.github.com/repos/apache/kafka/statuses/ed28eb4f017e78665847fc892907c77cf51e7c50"}}}}
{"actor":{"display_login":"guozhangwang"}}