Skip to content

Commit 3a0f1d2

Browse files
authored
Adds a Lucene API section to the Fern docs, generated from java/cuvs-… (#2580)
Adds a Lucene API section to the Fern docs, generated from java/cuvs-lucene/src/main, mirroring the Java API section. Relates to #2289 Authors: - Igor Motov (https://github.com/imotov) Approvers: - Bradley Dice (https://github.com/bdice) - Corey J. Nolet (https://github.com/cjnolet) URL: #2580
1 parent cdfb7b8 commit 3a0f1d2

31 files changed

Lines changed: 3546 additions & 14 deletions

File tree

‎.pre-commit-config.yaml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -68,11 +68,11 @@ repos:
6868
^c/include/.*[.](h|hpp)$|
6969
^cpp/include/.*[.](h|hpp|cuh)$|
7070
^python/cuvs/cuvs/.*[.](py|pyx|pxd)$|
71-
^java/cuvs-java/src/main/.*[.]java$|
71+
^java/cuvs-(java|lucene)/src/main/.*[.]java$|
7272
^rust/cuvs/src/.*[.]rs$|
7373
^go/.*[.]go$|
7474
^fern/scripts/generate_api_reference[.]py$|
75-
^fern/pages/(c|cpp|python|java|rust|go)_api/.*[.]md$|
75+
^fern/pages/(c|cpp|python|java|lucene|rust|go)_api/.*[.]md$|
7676
^fern/pages/api_reference[.]md$|
7777
^fern/docs[.]yml$
7878
- id: no-deprecationwarning

‎fern/docs.yml‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -544,6 +544,61 @@ navigation:
544544
path: "./pages/java_api/java-api-com-nvidia-cuvs-tieredindexparams.md"
545545
- page: "TieredIndexQuery"
546546
path: "./pages/java_api/java-api-com-nvidia-cuvs-tieredindexquery.md"
547+
- section: "Lucene API Documentation"
548+
path: "./pages/lucene_api/index.md"
549+
contents:
550+
- page: "AcceleratedHNSWParams"
551+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-acceleratedhnswparams.md"
552+
- page: "AcceleratedHNSWUtils"
553+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-acceleratedhnswutils.md"
554+
- page: "CagraIndexParamsFactory"
555+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-cagraindexparamsfactory.md"
556+
- page: "FilterBitsetCacheConfig"
557+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-filterbitsetcacheconfig.md"
558+
- page: "FilterCuVSServiceProvider"
559+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-filtercuvsserviceprovider.md"
560+
- page: "GPUIndex"
561+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-gpuindex.md"
562+
- page: "GPUSearchParams"
563+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-gpusearchparams.md"
564+
- page: "LuceneProvider"
565+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-luceneprovider.md"
566+
- page: "ThreadLocalCuVSResourcesProvider"
567+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-threadlocalcuvsresourcesprovider.md"
568+
- page: "Utils"
569+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-utils.md"
570+
- page: "CuVS2510GPUSearchCodec"
571+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-cuvs2510gpusearchcodec.md"
572+
- page: "CuVS2510GPUVectorsFormat"
573+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-cuvs2510gpuvectorsformat.md"
574+
- page: "CuVS2510GPUVectorsReader"
575+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-cuvs2510gpuvectorsreader.md"
576+
- page: "CuVS2510GPUVectorsWriter"
577+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-cuvs2510gpuvectorswriter.md"
578+
- page: "FieldWriter"
579+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-fieldwriter.md"
580+
- page: "GPUBuiltHnswGraph"
581+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-gpubuilthnswgraph.md"
582+
- page: "GPUKnnFloatVectorQuery"
583+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-gpuknnfloatvectorquery.md"
584+
- page: "Lucene101AcceleratedHNSWCodec"
585+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-lucene101acceleratedhnswcodec.md"
586+
- page: "Lucene99AcceleratedHNSWVectorsFormat"
587+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-lucene99acceleratedhnswvectorsformat.md"
588+
- page: "Lucene99AcceleratedHNSWVectorsWriter"
589+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-lucene99acceleratedhnswvectorswriter.md"
590+
- page: "LuceneAcceleratedHNSWBinaryQuantizedCodec"
591+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswbinaryquantizedcodec.md"
592+
- page: "LuceneAcceleratedHNSWBinaryQuantizedVectorsFormat"
593+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswbinaryquantizedvectorsformat.md"
594+
- page: "LuceneAcceleratedHNSWBinaryQuantizedVectorsWriter"
595+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswbinaryquantizedvectorswriter.md"
596+
- page: "LuceneAcceleratedHNSWScalarQuantizedCodec"
597+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswscalarquantizedcodec.md"
598+
- page: "LuceneAcceleratedHNSWScalarQuantizedVectorsFormat"
599+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswscalarquantizedvectorsformat.md"
600+
- page: "LuceneAcceleratedHNSWScalarQuantizedVectorsWriter"
601+
path: "./pages/lucene_api/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswscalarquantizedvectorswriter.md"
547602
- section: "Rust API Documentation"
548603
path: "./pages/rust_api/index.md"
549604
contents:

‎fern/pages/api_reference.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,5 +14,6 @@ For task-focused examples and usage guidance, see the [API Guide](/user-guide/ap
1414
- [C++ API Documentation](/api-reference/cpp-api-documentation): inspect the core NVIDIA cuVS C++ APIs, including common RAFT types used in public headers.
1515
- [Python API Documentation](/api-reference/python-api-documentation): inspect Python modules, classes, functions, and parameters.
1616
- [Java API Documentation](/api-reference/java-api-documentation): inspect Java classes, resources, matrices, indexes, and query APIs.
17+
- [Lucene API Documentation](/api-reference/lucene-api-documentation): inspect the Apache Lucene codecs that offload vector index build and search to the GPU.
1718
- [Rust API Documentation](/api-reference/rust-api-documentation): inspect Rust modules, structs, and wrappers around NVIDIA cuVS APIs.
1819
- [Go API Documentation](/api-reference/go-api-documentation): inspect Go packages for supported NVIDIA cuVS APIs.

‎fern/pages/lucene_api/index.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Lucene API Documentation
2+
3+
These pages are generated from the Java source files in `java/cuvs-lucene/src/main`.
4+
5+
## Common
6+
7+
- [AcceleratedHNSWParams](/api-reference/lucene-api-com-nvidia-cuvs-lucene-acceleratedhnswparams)
8+
- [AcceleratedHNSWUtils](/api-reference/lucene-api-com-nvidia-cuvs-lucene-acceleratedhnswutils)
9+
- [CagraIndexParamsFactory](/api-reference/lucene-api-com-nvidia-cuvs-lucene-cagraindexparamsfactory)
10+
- [FilterBitsetCacheConfig](/api-reference/lucene-api-com-nvidia-cuvs-lucene-filterbitsetcacheconfig)
11+
- [FilterCuVSServiceProvider](/api-reference/lucene-api-com-nvidia-cuvs-lucene-filtercuvsserviceprovider)
12+
- [GPUIndex](/api-reference/lucene-api-com-nvidia-cuvs-lucene-gpuindex)
13+
- [GPUSearchParams](/api-reference/lucene-api-com-nvidia-cuvs-lucene-gpusearchparams)
14+
- [LuceneProvider](/api-reference/lucene-api-com-nvidia-cuvs-lucene-luceneprovider)
15+
- [ThreadLocalCuVSResourcesProvider](/api-reference/lucene-api-com-nvidia-cuvs-lucene-threadlocalcuvsresourcesprovider)
16+
- [Utils](/api-reference/lucene-api-com-nvidia-cuvs-lucene-utils)
17+
18+
## Codecs and Formats
19+
20+
- [CuVS2510GPUSearchCodec](/api-reference/lucene-api-com-nvidia-cuvs-lucene-cuvs2510gpusearchcodec)
21+
- [CuVS2510GPUVectorsFormat](/api-reference/lucene-api-com-nvidia-cuvs-lucene-cuvs2510gpuvectorsformat)
22+
- [CuVS2510GPUVectorsReader](/api-reference/lucene-api-com-nvidia-cuvs-lucene-cuvs2510gpuvectorsreader)
23+
- [CuVS2510GPUVectorsWriter](/api-reference/lucene-api-com-nvidia-cuvs-lucene-cuvs2510gpuvectorswriter)
24+
- [FieldWriter](/api-reference/lucene-api-com-nvidia-cuvs-lucene-fieldwriter)
25+
- [GPUBuiltHnswGraph](/api-reference/lucene-api-com-nvidia-cuvs-lucene-gpubuilthnswgraph)
26+
- [GPUKnnFloatVectorQuery](/api-reference/lucene-api-com-nvidia-cuvs-lucene-gpuknnfloatvectorquery)
27+
- [Lucene101AcceleratedHNSWCodec](/api-reference/lucene-api-com-nvidia-cuvs-lucene-lucene101acceleratedhnswcodec)
28+
- [Lucene99AcceleratedHNSWVectorsFormat](/api-reference/lucene-api-com-nvidia-cuvs-lucene-lucene99acceleratedhnswvectorsformat)
29+
- [Lucene99AcceleratedHNSWVectorsWriter](/api-reference/lucene-api-com-nvidia-cuvs-lucene-lucene99acceleratedhnswvectorswriter)
30+
- [LuceneAcceleratedHNSWBinaryQuantizedCodec](/api-reference/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswbinaryquantizedcodec)
31+
- [LuceneAcceleratedHNSWBinaryQuantizedVectorsFormat](/api-reference/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswbinaryquantizedvectorsformat)
32+
- [LuceneAcceleratedHNSWBinaryQuantizedVectorsWriter](/api-reference/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswbinaryquantizedvectorswriter)
33+
- [LuceneAcceleratedHNSWScalarQuantizedCodec](/api-reference/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswscalarquantizedcodec)
34+
- [LuceneAcceleratedHNSWScalarQuantizedVectorsFormat](/api-reference/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswscalarquantizedvectorsformat)
35+
- [LuceneAcceleratedHNSWScalarQuantizedVectorsWriter](/api-reference/lucene-api-com-nvidia-cuvs-lucene-luceneacceleratedhnswscalarquantizedvectorswriter)

0 commit comments

Comments
 (0)