Skip to content

Commit 7faaf4e

Browse files
Repackage documentation and apply poetry updates (#146)
Improves VL documentation with new Redis logos, poetry scripting, poetry docs dependencies, and also adds new reranking user guide.
1 parent 4cd53d0 commit 7faaf4e

22 files changed

+1240
-327
lines changed

CONTRIBUTING.md

+14-2
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,6 @@ Then install the required libraries:
3838
poetry install --all-extras
3939
```
4040

41-
4241
### Linting and Tests
4342

4443
Check formatting, linting, and typing:
@@ -58,7 +57,7 @@ To run Testcontainers-based tests you need a local Docker installation such as:
5857

5958
#### Running the Tests
6059

61-
Tests (with vectorizers):
60+
Tests w/ vectorizers:
6261
```bash
6362
poetry run test-cov
6463
```
@@ -73,6 +72,19 @@ Tests w/out rerankers:
7372
SKIP_RERANKERS=true poetry run test-cov
7473
```
7574

75+
### Documentation
76+
Docs are served from the `docs/` directory.
77+
78+
Build the docs. Generates the `_build/html` contents:
79+
```bash
80+
poetry run build-docs
81+
```
82+
83+
Serve the documentation with a local webserver:
84+
```bash
85+
poetry run serve-docs
86+
```
87+
7688
### Getting Redis
7789

7890
In order for your applications to use RedisVL, you must have [Redis](https://redis.io) accessible with Search & Query features enabled on [Redis Cloud](https://redis.com/try-free) or locally in docker with [Redis Stack](https://redis.io/docs/getting-started/install-stack/docker/):
1.89 KB
Loading
461 Bytes
Loading
801 Bytes
Loading

docs/_static/Redis_Logo_Red_RGB.svg

+66
Loading
-41.2 KB
Binary file not shown.
-188 KB
Binary file not shown.

docs/_static/apple-touch-icon.png

-38.5 KB
Binary file not shown.

docs/_static/favicon-16x16.png

-817 Bytes
Binary file not shown.

docs/_static/favicon-32x32.png

-2.23 KB
Binary file not shown.

docs/_static/favicon.ico

-15 KB
Binary file not shown.

docs/_static/js/sidebar.js

+2
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ const toc = [
99
{ title: "Query and Filter", path: "/user_guide/hybrid_queries_02.html" },
1010
{ title: "JSON vs Hash Storage", path: "/user_guide/hash_vs_json_05.html" },
1111
{ title: "Vectorizers", path: "/user_guide/vectorizers_04.html" },
12+
{ title: "Rerankers", path: "/user_guide/rerankers_06.html"},
1213
{ title: "Semantic Caching", path: "/user_guide/llmcache_03.html" },
1314
]},
1415
{ header: "API", toc: [
@@ -17,6 +18,7 @@ const toc = [
1718
{ title: "Query", path: "/api/query.html" },
1819
{ title: "Filter", path: "/api/filter.html" },
1920
{ title: "Vectorizers", path: "/api/vectorizer.html" },
21+
{ title: "Rerankers", path: "/api/reranker.html" },
2022
{ title: "LLMCache", path: "/api/cache.html" }
2123
]}
2224
];

docs/_static/redis-cube-red-white-rgb.svg

-1
This file was deleted.

docs/_static/site.webmanifest

+1-1
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
{"name":"","short_name":"","icons":[{"src":"/android-chrome-192x192.png","sizes":"192x192","type":"image/png"},{"src":"/android-chrome-512x512.png","sizes":"512x512","type":"image/png"}],"theme_color":"#ffffff","background_color":"#ffffff","display":"standalone"}
1+
{"name":"","short_name":"","icons":[{"src":"Redis_Favicon_144x144_Red.png","sizes":"144x144","type":"image/png"}],"theme_color":"#ffffff","background_color":"#ffffff","display":"standalone"}

docs/conf.py

+6-9
Original file line numberDiff line numberDiff line change
@@ -76,8 +76,8 @@
7676
html_context = {
7777
"default_mode": "dark"
7878
}
79-
html_logo = "_static/redis-cube-red-white-rgb.svg"
80-
html_favicon = "_static/redis-cube-red-white-rgb.svg"
79+
html_logo = "_static/Redis_Favicon_32x32_Red.png"
80+
html_favicon = "_static/Redis_Favicon_32x32_Red.png"
8181
html_context = {
8282
"github_user": "RedisVentures",
8383
"github_repo": "RedisVL",
@@ -145,13 +145,10 @@
145145

146146
# see https://sphinx-favicon.readthedocs.io for more information about the
147147
# sphinx-favicon extension
148+
148149
favicons = [
149150
# generic icons compatible with most browsers
150-
"favicon-32x32.png",
151-
"favicon-16x16.png",
152-
{"rel": "shortcut icon", "sizes": "any", "href": "favicon.ico"},
153-
# chrome specific
154-
"android-chrome-192x192.png",
155-
# apple icons
156-
{"rel": "apple-touch-icon", "href": "apple-touch-icon.png"},
151+
"Redis_Favicon_32x32_Red.png",
152+
"Redis_Favicon_16x16_Red.png",
153+
"Redis_Favicon_144x144_Red.png",
157154
]

docs/requirements-doc.txt

-9
This file was deleted.

docs/user_guide/index.md

+1
Original file line numberDiff line numberDiff line change
@@ -16,5 +16,6 @@ hybrid_queries_02
1616
llmcache_03
1717
vectorizers_04
1818
hash_vs_json_05
19+
rerankers_06
1920
```
2021

0 commit comments

Comments
 (0)