Skip to content

Commit 8b37eae

Browse files
rjrudinrjrudin
authored
Merge pull request #164 from marklogic/feature/id-strategy-docs
DEVEXP-510 Added docs on ID strategies
2 parents 5787882 + cfa909c commit 8b37eae

File tree

8 files changed

+387
-41
lines changed

8 files changed

+387
-41
lines changed

‎docs/.gitignore‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
_site
2+
.sass-cache
3+
.jekyll-cache
4+
.jekyll-metadata
5+
vendor

‎docs/Gemfile‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
source "https://rubygems.org"
2+
# Hello! This is where you manage which Jekyll version is used to run.
3+
# When you want to use a different version, change it below, save the
4+
# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
5+
#
6+
# bundle exec jekyll serve
7+
#
8+
# This will help ensure the proper Jekyll version is running.
9+
# Happy Jekylling!
10+
11+
gem "github-pages", "~> 228", group: :jekyll_plugins
12+
13+
gem "webrick"
14+
15+
# If you have any plugins, put them here!
16+
group :jekyll_plugins do
17+
# gem "jekyll-feed", "~> 0.12"
18+
end
19+
20+
# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
21+
# and associated library.
22+
platforms :mingw, :x64_mingw, :mswin, :jruby do
23+
gem "tzinfo", ">= 1", "< 3"
24+
gem "tzinfo-data"
25+
end
26+
27+
# Performance-booster for watching directories on Windows
28+
gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
29+
30+
# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
31+
# do not have a Java counterpart.
32+
gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby]

‎docs/Gemfile.lock‎

Lines changed: 264 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,264 @@
1+
GEM
2+
remote: https://rubygems.org/
3+
specs:
4+
activesupport (7.0.6)
5+
concurrent-ruby (~> 1.0, >= 1.0.2)
6+
i18n (>= 1.6, < 2)
7+
minitest (>= 5.1)
8+
tzinfo (~> 2.0)
9+
addressable (2.8.5)
10+
public_suffix (>= 2.0.2, < 6.0)
11+
coffee-script (2.4.1)
12+
coffee-script-source
13+
execjs
14+
coffee-script-source (1.11.1)
15+
colorator (1.1.0)
16+
commonmarker (0.23.10)
17+
concurrent-ruby (1.2.2)
18+
dnsruby (1.70.0)
19+
simpleidn (~> 0.2.1)
20+
em-websocket (0.5.3)
21+
eventmachine (>= 0.12.9)
22+
http_parser.rb (~> 0)
23+
ethon (0.16.0)
24+
ffi (>= 1.15.0)
25+
eventmachine (1.2.7)
26+
execjs (2.8.1)
27+
faraday (2.7.10)
28+
faraday-net_http (>= 2.0, < 3.1)
29+
ruby2_keywords (>= 0.0.4)
30+
faraday-net_http (3.0.2)
31+
ffi (1.15.5)
32+
forwardable-extended (2.6.0)
33+
gemoji (3.0.1)
34+
github-pages (228)
35+
github-pages-health-check (= 1.17.9)
36+
jekyll (= 3.9.3)
37+
jekyll-avatar (= 0.7.0)
38+
jekyll-coffeescript (= 1.1.1)
39+
jekyll-commonmark-ghpages (= 0.4.0)
40+
jekyll-default-layout (= 0.1.4)
41+
jekyll-feed (= 0.15.1)
42+
jekyll-gist (= 1.5.0)
43+
jekyll-github-metadata (= 2.13.0)
44+
jekyll-include-cache (= 0.2.1)
45+
jekyll-mentions (= 1.6.0)
46+
jekyll-optional-front-matter (= 0.3.2)
47+
jekyll-paginate (= 1.1.0)
48+
jekyll-readme-index (= 0.3.0)
49+
jekyll-redirect-from (= 0.16.0)
50+
jekyll-relative-links (= 0.6.1)
51+
jekyll-remote-theme (= 0.4.3)
52+
jekyll-sass-converter (= 1.5.2)
53+
jekyll-seo-tag (= 2.8.0)
54+
jekyll-sitemap (= 1.4.0)
55+
jekyll-swiss (= 1.0.0)
56+
jekyll-theme-architect (= 0.2.0)
57+
jekyll-theme-cayman (= 0.2.0)
58+
jekyll-theme-dinky (= 0.2.0)
59+
jekyll-theme-hacker (= 0.2.0)
60+
jekyll-theme-leap-day (= 0.2.0)
61+
jekyll-theme-merlot (= 0.2.0)
62+
jekyll-theme-midnight (= 0.2.0)
63+
jekyll-theme-minimal (= 0.2.0)
64+
jekyll-theme-modernist (= 0.2.0)
65+
jekyll-theme-primer (= 0.6.0)
66+
jekyll-theme-slate (= 0.2.0)
67+
jekyll-theme-tactile (= 0.2.0)
68+
jekyll-theme-time-machine (= 0.2.0)
69+
jekyll-titles-from-headings (= 0.5.3)
70+
jemoji (= 0.12.0)
71+
kramdown (= 2.3.2)
72+
kramdown-parser-gfm (= 1.1.0)
73+
liquid (= 4.0.4)
74+
mercenary (~> 0.3)
75+
minima (= 2.5.1)
76+
nokogiri (>= 1.13.6, < 2.0)
77+
rouge (= 3.26.0)
78+
terminal-table (~> 1.4)
79+
github-pages-health-check (1.17.9)
80+
addressable (~> 2.3)
81+
dnsruby (~> 1.60)
82+
octokit (~> 4.0)
83+
public_suffix (>= 3.0, < 5.0)
84+
typhoeus (~> 1.3)
85+
html-pipeline (2.14.3)
86+
activesupport (>= 2)
87+
nokogiri (>= 1.4)
88+
http_parser.rb (0.8.0)
89+
i18n (1.14.1)
90+
concurrent-ruby (~> 1.0)
91+
jekyll (3.9.3)
92+
addressable (~> 2.4)
93+
colorator (~> 1.0)
94+
em-websocket (~> 0.5)
95+
i18n (>= 0.7, < 2)
96+
jekyll-sass-converter (~> 1.0)
97+
jekyll-watch (~> 2.0)
98+
kramdown (>= 1.17, < 3)
99+
liquid (~> 4.0)
100+
mercenary (~> 0.3.3)
101+
pathutil (~> 0.9)
102+
rouge (>= 1.7, < 4)
103+
safe_yaml (~> 1.0)
104+
jekyll-avatar (0.7.0)
105+
jekyll (>= 3.0, < 5.0)
106+
jekyll-coffeescript (1.1.1)
107+
coffee-script (~> 2.2)
108+
coffee-script-source (~> 1.11.1)
109+
jekyll-commonmark (1.4.0)
110+
commonmarker (~> 0.22)
111+
jekyll-commonmark-ghpages (0.4.0)
112+
commonmarker (~> 0.23.7)
113+
jekyll (~> 3.9.0)
114+
jekyll-commonmark (~> 1.4.0)
115+
rouge (>= 2.0, < 5.0)
116+
jekyll-default-layout (0.1.4)
117+
jekyll (~> 3.0)
118+
jekyll-feed (0.15.1)
119+
jekyll (>= 3.7, < 5.0)
120+
jekyll-gist (1.5.0)
121+
octokit (~> 4.2)
122+
jekyll-github-metadata (2.13.0)
123+
jekyll (>= 3.4, < 5.0)
124+
octokit (~> 4.0, != 4.4.0)
125+
jekyll-include-cache (0.2.1)
126+
jekyll (>= 3.7, < 5.0)
127+
jekyll-mentions (1.6.0)
128+
html-pipeline (~> 2.3)
129+
jekyll (>= 3.7, < 5.0)
130+
jekyll-optional-front-matter (0.3.2)
131+
jekyll (>= 3.0, < 5.0)
132+
jekyll-paginate (1.1.0)
133+
jekyll-readme-index (0.3.0)
134+
jekyll (>= 3.0, < 5.0)
135+
jekyll-redirect-from (0.16.0)
136+
jekyll (>= 3.3, < 5.0)
137+
jekyll-relative-links (0.6.1)
138+
jekyll (>= 3.3, < 5.0)
139+
jekyll-remote-theme (0.4.3)
140+
addressable (~> 2.0)
141+
jekyll (>= 3.5, < 5.0)
142+
jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0)
143+
rubyzip (>= 1.3.0, < 3.0)
144+
jekyll-sass-converter (1.5.2)
145+
sass (~> 3.4)
146+
jekyll-seo-tag (2.8.0)
147+
jekyll (>= 3.8, < 5.0)
148+
jekyll-sitemap (1.4.0)
149+
jekyll (>= 3.7, < 5.0)
150+
jekyll-swiss (1.0.0)
151+
jekyll-theme-architect (0.2.0)
152+
jekyll (> 3.5, < 5.0)
153+
jekyll-seo-tag (~> 2.0)
154+
jekyll-theme-cayman (0.2.0)
155+
jekyll (> 3.5, < 5.0)
156+
jekyll-seo-tag (~> 2.0)
157+
jekyll-theme-dinky (0.2.0)
158+
jekyll (> 3.5, < 5.0)
159+
jekyll-seo-tag (~> 2.0)
160+
jekyll-theme-hacker (0.2.0)
161+
jekyll (> 3.5, < 5.0)
162+
jekyll-seo-tag (~> 2.0)
163+
jekyll-theme-leap-day (0.2.0)
164+
jekyll (> 3.5, < 5.0)
165+
jekyll-seo-tag (~> 2.0)
166+
jekyll-theme-merlot (0.2.0)
167+
jekyll (> 3.5, < 5.0)
168+
jekyll-seo-tag (~> 2.0)
169+
jekyll-theme-midnight (0.2.0)
170+
jekyll (> 3.5, < 5.0)
171+
jekyll-seo-tag (~> 2.0)
172+
jekyll-theme-minimal (0.2.0)
173+
jekyll (> 3.5, < 5.0)
174+
jekyll-seo-tag (~> 2.0)
175+
jekyll-theme-modernist (0.2.0)
176+
jekyll (> 3.5, < 5.0)
177+
jekyll-seo-tag (~> 2.0)
178+
jekyll-theme-primer (0.6.0)
179+
jekyll (> 3.5, < 5.0)
180+
jekyll-github-metadata (~> 2.9)
181+
jekyll-seo-tag (~> 2.0)
182+
jekyll-theme-slate (0.2.0)
183+
jekyll (> 3.5, < 5.0)
184+
jekyll-seo-tag (~> 2.0)
185+
jekyll-theme-tactile (0.2.0)
186+
jekyll (> 3.5, < 5.0)
187+
jekyll-seo-tag (~> 2.0)
188+
jekyll-theme-time-machine (0.2.0)
189+
jekyll (> 3.5, < 5.0)
190+
jekyll-seo-tag (~> 2.0)
191+
jekyll-titles-from-headings (0.5.3)
192+
jekyll (>= 3.3, < 5.0)
193+
jekyll-watch (2.2.1)
194+
listen (~> 3.0)
195+
jemoji (0.12.0)
196+
gemoji (~> 3.0)
197+
html-pipeline (~> 2.2)
198+
jekyll (>= 3.0, < 5.0)
199+
kramdown (2.3.2)
200+
rexml
201+
kramdown-parser-gfm (1.1.0)
202+
kramdown (~> 2.0)
203+
liquid (4.0.4)
204+
listen (3.8.0)
205+
rb-fsevent (~> 0.10, >= 0.10.3)
206+
rb-inotify (~> 0.9, >= 0.9.10)
207+
mercenary (0.3.6)
208+
minima (2.5.1)
209+
jekyll (>= 3.5, < 5.0)
210+
jekyll-feed (~> 0.9)
211+
jekyll-seo-tag (~> 2.1)
212+
minitest (5.19.0)
213+
nokogiri (1.15.3-arm64-darwin)
214+
racc (~> 1.4)
215+
octokit (4.25.1)
216+
faraday (>= 1, < 3)
217+
sawyer (~> 0.9)
218+
pathutil (0.16.2)
219+
forwardable-extended (~> 2.6)
220+
public_suffix (4.0.7)
221+
racc (1.7.1)
222+
rb-fsevent (0.11.2)
223+
rb-inotify (0.10.1)
224+
ffi (~> 1.0)
225+
rexml (3.2.6)
226+
rouge (3.26.0)
227+
ruby2_keywords (0.0.5)
228+
rubyzip (2.3.2)
229+
safe_yaml (1.0.5)
230+
sass (3.7.4)
231+
sass-listen (~> 4.0.0)
232+
sass-listen (4.0.0)
233+
rb-fsevent (~> 0.9, >= 0.9.4)
234+
rb-inotify (~> 0.9, >= 0.9.7)
235+
sawyer (0.9.2)
236+
addressable (>= 2.3.5)
237+
faraday (>= 0.17.3, < 3)
238+
simpleidn (0.2.1)
239+
unf (~> 0.1.4)
240+
terminal-table (1.8.0)
241+
unicode-display_width (~> 1.1, >= 1.1.1)
242+
typhoeus (1.4.0)
243+
ethon (>= 0.9.0)
244+
tzinfo (2.0.6)
245+
concurrent-ruby (~> 1.0)
246+
unf (0.1.4)
247+
unf_ext
248+
unf_ext (0.0.8.2)
249+
unicode-display_width (1.8.0)
250+
webrick (1.8.1)
251+
252+
PLATFORMS
253+
arm64-darwin-21
254+
255+
DEPENDENCIES
256+
github-pages (~> 228)
257+
http_parser.rb (~> 0.6.0)
258+
tzinfo (>= 1, < 3)
259+
tzinfo-data
260+
wdm (~> 0.1.1)
261+
webrick
262+
263+
BUNDLED WITH
264+
2.4.7

‎docs/_config.yml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ remote_theme: just-the-docs/just-the-docs
33
plugins:
44
- jekyll-remote-theme
55

6+
# Haven't needed this in other projects, but jekyll throws an error without it.
7+
repository: "marklogic/kafka-marklogic-connector"
8+
69
heading_anchors: true
710

811
# Aux links for the upper right navigation

‎docs/installation-guide.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ instructions on using the MarkLogic connector with either Kafka as a standalone
99
Kafka providers exist and should be capable of utilizing the MarkLogic connector as well, but instructions on those
1010
are out of scope of this document.
1111

12-
### Using the connector with Confluent Platform
12+
## Using the connector with Confluent Platform
1313

1414
[Confluent Platform](https://docs.confluent.io/platform/current/platform.html) provides an easy mechanism for running
1515
Kafka via a single application, which includes a simple process for installing new connectors.
@@ -19,7 +19,7 @@ The MarkLogic Kafka connector can be installed via the instructions at
1919
[Confluent Control Center](https://docs.confluent.io/platform/current/control-center/index.html) to load and configure
2020
as many instances of the MarkLogic Kafka connector that you wish.
2121

22-
### Using the connector with Apache Kafka
22+
## Using the connector with Apache Kafka
2323

2424
For a regular installation of Apache Kafka, obtain the latest version of the MarkLogic Kafka connector from
2525
[this repository's Releases page](https://github.com/marklogic/kafka-marklogic-connector/releases). Download

0 commit comments

Comments
 (0)