Commit Graph

42 Commits

Author SHA1 Message Date
Ismael Juma d17fbe1af6
MINOR: Remove old message format documentation (#19033)
Link to the older version of the documentation for people who care about
the old message format.

Reviewers: Jun Rao <junrao@apache.org>, Chia-Ping Tsai <chia7712@apache.org>
2025-02-26 09:36:08 -08:00
Mickael Maison 13d9a199f2
KAFKA-18011 Remove ZooKeeper sections from the docs (#17813)
Reviewers: Chia-Ping Tsai <chia7712@gmail.com>
2024-11-26 01:58:48 +08:00
GangHuo 6ee46ea865
MINOR: Fix DefaultRecordBatch and DefaultRecord protocol documentation (#17196)
Reviewers: Chia-Ping Tsai <chia7712@gmail.com>
2024-09-30 10:15:28 +08:00
Mickael Maison c4a3d2475f
MINOR: Refresh of the docs (#16375)
Reviewers: Luke Chen <showuon@gmail.com>, Chia-Ping Tsai <chia7712@gmail.com>
2024-06-18 17:15:47 +02:00
Mickael Maison 74be72a559
MINOR: Various fixes in the docs (#14914)
- Only use https links
- Fix broken HTML tags
- Replace usage of <tt> which is deprecated with <code>
- Replace hardcoded version numbers

Reviewers: Chris Egerton <fearthecellos@gmail.com>, Greg Harris <gharris1727@gmail.com>
2023-12-04 22:06:49 +01:00
Anton Agestam 6ca8f0d5f0
MINOR: Correct type of record batch CRC field (#13583)
The CRC field of Record Batch was incorrectly documented as int32 while in reality it's an unsigned uint32 field.

Reviewers: Luke Chen <showuon@gmail.com>
2023-04-17 20:22:36 +08:00
drgnchan 8d2e157b37
MINOR: Fix docs to state that sendfile implemented in `TransferableRecords` instead of `MessageSet` (#13109)
Reviewers: Ismael Juma <ismael@juma.me.uk>
2023-01-14 23:06:18 -08:00
Federico Valeri 74a18bafae
Minor: replace .kafka with .log in implementation documentation (#12401)
replace .kafka with .log in implementation documentation

Reviewers: Luke Chen <showuon@gmail.com>, Liam Clarke-Hutchinson <liam@steelsky.co.nz>
2022-07-20 18:11:51 +08:00
Matthew Wong 17dcb8097c
MINOR: Update documentation and DumpLogSegments tool for addition of `deleteHorizonMs` in batch format (#11694)
This PR updates the documentation and tooling to match https://github.com/apache/kafka/pull/10914, which added support for encoding `deleteHorizonMs` in the record batch schema. The changes include adding the new attribute and updating field names. We have also updated stale references to the old `FirstTimestamp` field in the code and comments. Finally, In the `DumpLogSegments` tool, when record batch information is printed, it will also include the value of `deleteHorizonMs` is (e.g. `OptionalLong.empty` or `OptionalLong[123456]`).

Reviewers: Vincent Jiang <84371940+vincent81jiang@users.noreply.github.com>, Kvicii <42023367+Kvicii@users.noreply.github.com>, Jason Gustafson <jason@confluent.io>
2022-02-04 16:20:37 -08:00
Josep Prat f5a94d913f
MINOR: Fix indentation for several doc pages (#10766)
Fixes the indentation of the code listings for:

api.html
configuration.html
design.html
implementation.html
toc.html
These changes consist of whitespaces added or removed for consistency. It also contains a couple of fixes on unbalanced html tags.

Reviewers: Luke Chen <showuon@gmail.com>, Bill Bejeck <bbejeck@apache.org>
2021-06-17 15:58:40 -04:00
prince-mahajan db288e4a64
Update implementation.html (#10771)
Fixing the link to a cited blog. The existing link now points to a steroid website so need to pull the blog from internet archives.
2021-05-26 17:30:34 -07:00
Bill Bejeck b4f00d7ef6
KAFKA-10679: Migrate upgrade changes from site to kafka/docs (#9551)
During the AK website upgrade, changes made to kafka-site weren't migrated back to kafka-docs.

This PR is an initial attempt at porting the changes to kafka/docs, but it does not include the streams changes. Those will come in a separate PR.

For the most part, the bulk of the changes in the PR are cosmetic. Only the introduction.html has substantial changes, but it's a direct port from the live documentation.

For testing:

I reviewed the PR diffs
Rendered the changes locally

Reviewers: Matthias J. Sax <mjsax@apache.org>
2020-11-03 13:40:44 -05:00
Okada Haruki 94ccd4d25e
MINOR: Fix timestampDelta type in doc (#8870)
Reviewers: Chia-Ping Tsai <chia7712@gmail.com>
2020-10-22 16:42:53 +08:00
showuon 91efb30dfa
MINOR: Improve formatting in docs (#8611)
Reviewers: Matthias J. Sax <matthias@confluent.io>
2020-05-08 15:32:50 -07:00
Jorge Esteban Quilcate Otoya 4803c779de
MINOR: Use `firstTimestamp` instead of `baseTimestamp` in docs (#8584)
In the docs, the `baseTimestamp` term is used when `firstTimestamp` is defined in the on-disk format and implementation.

Reviewers: Jason Gustafson <jason@confluent.io>
2020-05-01 14:43:47 -07:00
Fábio Silva a2aa0a458b KAFKA-9255: Add 'timestamp' field to 'message' entry (#7764)
Reviewers: Mickael Maison <mickael.maison@gmail.com>
2019-12-02 14:39:28 +00:00
Sönke Liebau d7513693a3 KAFKA-9226: Updated documentation section on log deletion policies. (#7738)
Reviewers: Mickael Maison <mickael.maison@gmail.com>
2019-11-27 12:08:06 +00:00
Simon Clark af17468fa6 MINOR: Standardise "variable-length" vs "variable length" (#7720)
Both were used in the same sentence, which isn't necessarily clear.

Reviewers: Mickael Maison <mickael.maison@gmail.com>
2019-11-21 13:36:56 +00:00
Lee Dongjin 741cb761c5 KAFKA-4514; Add Codec for ZStandard Compression (#2267)
This patch adds support for zstandard compression to Kafka as documented in KIP-110: https://cwiki.apache.org/confluence/display/KAFKA/KIP-110%3A+Add+Codec+for+ZStandard+Compression. 

Reviewers: Ivan Babrou <ibobrik@gmail.com>, Ismael Juma <ismael@juma.me.uk>, Jason Gustafson <jason@confluent.io>
2018-10-09 17:13:33 -07:00
Manikumar Reddy O 49c5994dd9 KAFKA-7063; Remove references to old producers and consumers in docs (#5240)
Reviewers: Vahid Hashemian <vahidhashemian@us.ibm.com>, Ismael Juma <ismael@juma.me.uk>, Jason Gustafson <jason@confluent.io>
2018-08-21 14:02:14 -07:00
Andras Beni 29d2e8cf17 KAFKA-3368; Add documentation for old message format (#3425) 2018-03-12 15:13:34 -07:00
Adem Efe Gencer 86062e9a78 KAFKA-6157; Fix repeated words words in JavaDoc and comments.
Author: Adem Efe Gencer <agencer@linkedin.com>

Reviewers: Jiangjie Qin <becket.qin@gmail.com>

Closes #4170 from efeg/bug/typoFix
2017-11-05 18:00:43 -08:00
Apurva Mehta 6471822079 KAFKA-5020; Update message format in implementation docs
Author: Apurva Mehta <apurva@confluent.io>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #3360 from apurvam/KAFKA-5020-message-format-docs-update
2017-06-30 09:22:25 -07:00
Tom Bentley a6799f4e14 KAFKA-4059; API Design section under Implementation is out of date
It describes the old deprecated clients and it's better to just
remove it.

The contribution is my original work and I license the work to the
project under the project's open source license.

Author: Tom Bentley <tbentley@redhat.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #3385 from tombentley/KAFKA-4059
2017-06-22 13:42:40 +01:00
Hao Chen 9790d5aba0 MINOR: Remove version in the uses page
This is contributed by Hao Chen.

Author: Guozhang Wang <wangguoz@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #3366 from guozhangwang/KMinor-fix-streams-link-in-uses
2017-06-20 09:34:59 -07:00
Guozhang Wang 57b0d0fe57 MINOR: syntax brush for java / bash / json / text
Author: Guozhang Wang <wangguoz@gmail.com>

Reviewers: Derrick Or <derrickor@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #3214 from guozhangwang/KMinor-doc-java-brush
2017-06-07 15:17:25 +01:00
Derrick Or 53428694a6 Separate Streams documentation and setup docs with easy to set variables
- Seperate Streams documentation out to a standalone page.
- Setup templates to use handlebars.js
- Create template variables to swap in frequently updated values like version number from a single file templateData.js

Author: Derrick Or <derrickor@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2245 from derrickdoo/docTemplates
2016-12-13 17:59:49 -08:00
Jason Gustafson 9662e466d9 MINOR: Some images should be centered in the documentation
Author: Jason Gustafson <jason@confluent.io>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #2029 from hachikuji/center-some-images
2016-10-14 10:04:13 -07:00
Vahid Hashemian e972d2afd3 MINOR: Fix typos in documentation
And improve readability by adding proper punctuations.

Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #2002 from vahidhashemian/doc/fix_typos
2016-10-10 15:58:37 -07:00
Vahid Hashemian d2a267b111 KAFKA-3697; Clean up website documentation of client usage
This is to imply that the Java consumer/producer are the recommended consumer/producer now.

Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #1921 from vahidhashemian/KAFKA-3697
2016-09-29 19:37:20 -07:00
Sumit Arrawatia 36242b846a KAFKA-4151; Update public docs for Cluster Id (KIP-78)
- Updated implementation docs with details on Cluster Id generation.
- Mention cluster id in "noteworthy changes for 0.10.1.0" in upgrade docs.

Author: Sumit Arrawatia <sumit.arrawatia@gmail.com>
Author: arrawatia <sumit.arrawatia@gmail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #1895 from arrawatia/kip-78-docs
2016-09-24 10:23:18 +01:00
Jiangjie Qin 61f4c8b092 KAFKA-3698; Update the message format section.
Author: Jiangjie Qin <becket.qin@gmail.com>

Reviewers: Jun Rao <junrao@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #1375 from becketqin/KAFKA-3698
2016-05-16 17:16:27 +01:00
Vahid Hashemian 18226ff0be KAFKA-3608; Fix ZooKeeper structures and output format in documentation
Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Gwen Shapira

Closes #1257 from vahidhashemian/KAFKA-3608
2016-05-09 17:29:15 -07:00
Dongjoon Hyun e79d9af3cf KAFKA-3461: Fix typos in Kafka web documentations.
This PR fixes 8 typos in HTML files of `docs` module. I wrote explicitly here since Github sometimes does not highlight the corrections on long lines correctly.
- docs/api.html: compatability => compatibility
- docs/connect.html: simultaneoulsy => simultaneously
- docs/implementation.html: LATIEST_TIME => LATEST_TIME, nPartions => nPartitions
- docs/migration.html: Decomission => Decommission
- docs/ops.html: stoping => stopping, ConumserGroupCommand => ConsumerGroupCommand, youre => you're

Author: Dongjoon Hyun <dongjoon@apache.org>

Reviewers: Ismael Juma

Closes #1138 from dongjoon-hyun/KAFKA-3461
2016-04-12 13:48:18 -07:00
Sasaki Toru 291f430d9c MINOR: Fix typos in docs
Author: Sasaki Toru <sasakitoa@nttdata.co.jp>

Reviewers: Gwen Shapira

Closes #1003 from sasakitoa/Fix_typo_in_docs
2016-03-03 11:46:16 -08:00
Vahid Hashemian d00cf520fb MINOR: Improve Kafka documentation
Improve the documentation by fixing typos, punctuations, and correcting the content.

Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Grant Henke <granthenke@gmail.com>, Ewen Cheslack-Postava <ewen@confluent.io>

Closes #778 from vahidhashemian/typo05/fix_documentation_typos
2016-01-23 22:26:53 -08:00
Samuel Julius Hecht e11946b097 MINOR: fixing typos in docs
This commit contains minor grammatical fixes.  Some of the changes are just removing rogue commas, which can be hard to see in the diff.

This contribution is my original work and I license the work to the project under the project's open source license.

Author: Samuel Julius Hecht <samjhecht@gmail.com>

Reviewers: Gwen Shapira

Closes #721 from samjhecht/minor-docs-edits
2015-12-30 17:02:58 -08:00
Jun Rao b609645dc4 trivial change to 0.9.0 docs to fix outdated ConsumerMetadataRequest 2015-11-20 13:26:40 -08:00
Grant Henke 6cbd97597c KAFKA-2809; Improve documentation linking
Often it is useful to link to a specific header within the documentation. Especially when referencing docs in the mailing lists.

This adds anchors and links for all headers in the docs.

Author: Grant Henke <granthenke@gmail.com>

Reviewers: Jun Rao <junrao@gmail.com>

Closes #498 from granthenke/doc-links
2015-11-16 14:14:17 -08:00
Grant Henke 69af573b35 KAFKA-2783; Drop outdated hadoop contrib modules
Author: Grant Henke <granthenke@gmail.com>

Reviewers: Gwen Shapira

Closes #466 from granthenke/drop-contrib
2015-11-09 11:02:46 -08:00
Gwen Shapira 78a2e2f8f3 KAFKA-2665: Add images to code github
…art of the code github

Author: Gwen Shapira <cshapi@gmail.com>

Reviewers: Guozhang Wang

Closes #325 from gwenshap/KAFKA-2665
2015-10-16 17:52:06 -07:00
Manikumar reddy O 4016011457 KAFKA-2425; Copy latest docs to kafka repo docs/ directory
This PR copies the latest kafka docs to kafka repo docs directory. Here I have copied 0.8.3/ directory contents from svn website repo to kafka/docs repository.

Some questions: This PR contains generated javadocs also.  Do we need to copy javadocs here?

Author: Manikumar reddy O <manikumar.reddy@gmail.com>

Reviewers: Gwen Shapira, Ismael Juma

Closes #171 from omkreddy/KAFKA-2425-MOVE-DOCS-TO-KAFKA-REPO
2015-10-03 06:50:45 -07:00