From a73993656324925d124c8f54ed66d90883c8de51 Mon Sep 17 00:00:00 2001 From: Debanjum Date: Thu, 9 Jan 2025 20:06:00 +0700 Subject: [PATCH] Mark Github integration as unmaintained in documentation Also mention what the Reflective Questions table is about Resolves #1059 --- documentation/docs/advanced/admin.md | 7 +++++-- documentation/docs/data-sources/github_integration.md | 8 ++++++-- 2 files changed, 11 insertions(+), 4 deletions(-) diff --git a/documentation/docs/advanced/admin.md b/documentation/docs/advanced/admin.md index 11537cb8..3da1df1f 100644 --- a/documentation/docs/advanced/admin.md +++ b/documentation/docs/advanced/admin.md @@ -47,7 +47,7 @@ For each AI Model API you [add](http://localhost:42110/server/admin/database/aim ![example configuration for ai model api](/img/example_openai_processor_config.png) ### Search Model Configs -Search models are used to generate vector embeddings of your documents for natural language search and chat. You can choose any [embeddings models on HuggingFace](https://huggingface.co/models?pipeline_tag=sentence-similarity) to try, use for your to create vector embeddings of your documents for natural language search and chat. +Search models are used to generate vector embeddings of your documents for natural language search and chat. You can choose any [embeddings models on HuggingFace](https://huggingface.co/models?pipeline_tag=sentence-similarity) to create vector embeddings of your documents for natural language search and chat. Example Search Model Settings @@ -64,6 +64,9 @@ Add speech to text models with these settings. Khoj currently only supports whis ### Voice Model Options Add text to speech models with these settings. Khoj currently supports models from [ElevenLabs](https://elevenlabs.io/). +### Reflective Questions +This is a static list of starter question suggestions for each user. It is not current used in any client app. It used to be shown on the web app home page. We may turn it into a dynamic list of starter questions personalized to each users, say based on their recent conversations or synced knowledge base. + ## User Data - Users, Entrys, Conversations, Subscriptions, Github configs, Notion configs, User search configs, User conversation configs, User voice configs @@ -71,4 +74,4 @@ Add text to speech models with these settings. Khoj currently supports models fr - Process Locks: Persistent Locks for Automations - Client Applications: -Client applications allow you to setup third party applications that can query your Khoj server using a client application ID + secret. The secret would go in a bearer token. + Client applications allow you to setup third party applications that can query your Khoj server using a client application ID + secret. The secret would go in a bearer token. diff --git a/documentation/docs/data-sources/github_integration.md b/documentation/docs/data-sources/github_integration.md index 71d3ac04..4839d64b 100644 --- a/documentation/docs/data-sources/github_integration.md +++ b/documentation/docs/data-sources/github_integration.md @@ -1,6 +1,10 @@ # Github integration -The Github integration allows you to index as many repositories as you want. It's currently default configured to index Issues, Commits, and all Markdown/Org files in each repository. For large repositories, this takes a fairly long time, but it works well for smaller projects. +:::warning[Unmaintained] +The Github integration is not maintained. We are considering deprecating it. It doesn't seem used by many folks and its cumbersome for us to maintain. +::: + +The Github integration allows you to index as many repositories as you want. It's currently default configured to index all Markdown/Org/Text files in each repository. For large repositories, this takes a fairly long time, but it works well for smaller projects. # Configure your settings @@ -9,6 +13,6 @@ The Github integration allows you to index as many repositories as you want. It' ## Use the Github plugin 1. Generate a [classic PAT (personal access token)](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) from [Github](https://github.com/settings/tokens) with `repo` and `admin:org` scopes at least. -2. Navigate to [https://app.khoj.dev/settings#github](https://app.khoj.dev/settings#github) to configure your Github settings. Enter in your PAT, along with details for each repository you want to index. +2. Navigate to [https://app.khoj.dev/settings#github](https://app.khoj.dev/settings/content/github) to configure your Github settings. Enter in your PAT, along with details for each repository you want to index. 3. Click `Save`. Go back to the settings page and click `Configure`. 4. Go to [https://app.khoj.dev/](https://app.khoj.dev/) and start searching!