chore: rename categories in the API docs (#6885)

* rename API categories

* fix

* update slugs

* rename files for consistency

* fix category ID

* try getting the right version

.github/workflows/readme_sync.yml

@@ -41,4 +41,4 @@ jobs:
         env:
           README_API_KEY: ${{ secrets.README_API_KEY }}
         with:
-          rdme: docs ./docs/pydoc/temp --key="$README_API_KEY" --version=2.0
+          rdme: docs ./docs/pydoc/temp --key="$README_API_KEY" --version=v2.0

docs/pydoc/config/whisper.yml → docs/pydoc/config/audio_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Transcribes audio files.
-  category_slug: haystack-classes
-  title: WhisperTranscriber API
-  slug: whisper-transcriber-api
+  category_slug: haystack-api
+  title: Audio
+  slug: audio-api
   order: 180
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: whisper_transcriber_api.md
+    filename: audio_api.md

docs/pydoc/config/builder.yml → docs/pydoc/config/builders_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Extract the output of a Generator to an Answer format, and build prompts.
-  category_slug: haystack-classes
-  title: Builder API
-  slug: builder-api
+  category_slug: haystack-api
+  title: Builders
+  slug: builders-api
   order: 5
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: builder_api.md
+    filename: builders_api.md

docs/pydoc/config/caching.yml → docs/pydoc/config/caching_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Checks if any document coming from the given URL is already present in the store.
-  category_slug: haystack-classes
-  title: CacheChecker API
+  category_slug: haystack-api
+  title: Caching
   slug: caching-api
   order: 7
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: caching_api.md
+    filename: cachings_api.md

docs/pydoc/config/classifier.yml → docs/pydoc/config/classifiers_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Detects the language of the Documents and routes them appropriately.
-  category_slug: haystack-classes
-  title: Classifier API
-  slug: classifier-api
+  category_slug: haystack-api
+  title: Classifiers
+  slug: classifiers-api
   order: 10
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: classifier_api.md
+    filename: classifiers_api.md

docs/pydoc/config/converter.yml → docs/pydoc/config/converters_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Extracts text from files in different formats and converts it into a unified Document format.
-  category_slug: haystack-classes
-  title: Converter API
-  slug: converter-api
+  category_slug: haystack-api
+  title: Converters
+  slug: converters-api
   order: 20
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: converter_api.md
+    filename: converters_api.md

docs/pydoc/config/dataclass.yml → docs/pydoc/config/data_classess_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Core classes that carry data through the system.
-  category_slug: haystack-classes
-  title: Data Classes API
+  category_slug: haystack-api
+  title: Data Classes
   slug: data-classes-api
   order: 30
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: data_classes_api.md
+    filename: data_classess_api.md

docs/pydoc/config/document_store.yml → docs/pydoc/config/document_stores_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Stores your texts and meta data and provides them to the Retriever at query time.
-  category_slug: haystack-classes
-  title: DocumentStore API
-  slug: document-store-api
+  category_slug: haystack-api
+  title: Document Stores
+  slug: document-stores-api
   order: 40
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: document_store.md
+    filename: document_stores_api.md

docs/pydoc/config/writer.yml → docs/pydoc/config/document_writers_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Writes Documents to a DocumentStore.
-  category_slug: haystack-classes
-  title: DocumentWriter API
-  slug: writer-api
+  category_slug: haystack-api
+  title: Document Writers
+  slug: document-writers-api
   order: 50
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: writer_api.md
+    filename: document_writers_api.md

docs/pydoc/config/embedder.yml → docs/pydoc/config/embedders_api.yml

@@ -24,13 +24,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Transforms queries into vectors to look for similar or relevant Documents.
-  category_slug: haystack-classes
-  title: Embedder API
-  slug: embedder-api
+  category_slug: haystack-api
+  title: Embedders
+  slug: embedders-api
   order: 60
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: embedder_api.md
+    filename: embedders_api.md

docs/pydoc/config/extractor.yml → docs/pydoc/config/extractors_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Extracts predefined entities out of a piece of text.
-  category_slug: haystack-classes
-  title: Extractor API
-  slug: extractor-api
+  category_slug: haystack-api
+  title: Extractors
+  slug: extractors-api
   order: 65
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: extractor_api.md
+    filename: extractors_api.md

docs/pydoc/config/fetcher.yml → docs/pydoc/config/fetchers_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Fetches content from a list of URLs and returns a list of extracted content streams.
-  category_slug: haystack-classes
-  title: LinkContentFetcher API
-  slug: fetcher-api
+  category_slug: haystack-api
+  title: Fetchers
+  slug: fetchers-api
   order: 80
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: fetcher_api.md
+    filename: fetchers_api.md

docs/pydoc/config/generator.yml → docs/pydoc/config/generators_api.yml

@@ -25,13 +25,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Enables text generation using LLMs.
-  category_slug: haystack-classes
-  title: Generator API
-  slug: generator-api
+  category_slug: haystack-api
+  title: Generators
+  slug: generators-api
   order: 70
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: generator_api.md
+    filename: generators_api.md

docs/pydoc/config/joiner.yml → docs/pydoc/config/joiners_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Routes data to the right component based on its file type or metadata.
-  category_slug: haystack-classes
-  title: Joiner API
-  slug: joiner-api
+  category_slug: haystack-api
+  title: Joiners
+  slug: joiners-api
   order: 75
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: joiner_api.md
+    filename: joiners_api.md

docs/pydoc/config/others.yml → docs/pydoc/config/others_api.yml

@@ -14,9 +14,9 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Other utility components for Haystack Pipelines.
-  category_slug: haystack-classes
-  title: Other Components API
-  slug: others
+  category_slug: haystack-api
+  title: Other Components
+  slug: others-api
   order: 85
   markdown:
     descriptive_class_title: false

docs/pydoc/config/pipeline.yml → docs/pydoc/config/pipeline_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Arranges components and integrations in flow.
-  category_slug: haystack-classes
-  title: Pipelines API
-  slug: pipelines-api
+  category_slug: haystack-api
+  title: Pipeline
+  slug: pipeline-api
   order: 90
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: pipelines_api.md
+    filename: pipeline_api.md

docs/pydoc/config/preprocessor.yml → docs/pydoc/config/preprocessors_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Normalizes white spaces, gets rid of headers and footers, cleans empty lines in your Documents, or splits them into smaller pieces.
-  category_slug: haystack-classes
-  title: PreProcessor API
-  slug: preprocessor-api
+  category_slug: haystack-api
+  title: PreProcessors
+  slug: preprocessors-api
   order: 100
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: preprocessor_api.md
+    filename: preprocessors_api.md

docs/pydoc/config/ranker.yml → docs/pydoc/config/rankers_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Reorders a set of Documents based on their relevance to the query.
-  category_slug: haystack-classes
-  title: Ranker API
-  slug: ranker-api
+  category_slug: haystack-api
+  title: Rankers
+  slug: rankers-api
   order: 110
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: ranker_api.md
+    filename: rankers_api.md

docs/pydoc/config/reader.yml → docs/pydoc/config/readers_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Takes a query and a set of Documents as input and returns ExtractedAnswers by selecting a text span within the Documents.
-  category_slug: haystack-classes
-  title: Reader API
-  slug: reader-api
+  category_slug: haystack-api
+  title: Readers
+  slug: readers-api
   order: 120
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: reader_api.md
+    filename: readers_api.md

docs/pydoc/config/retriever.yml → docs/pydoc/config/retrievers_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Sweeps through a Document Store and returns a set of candidate Documents that are relevant to the query.
-  category_slug: haystack-classes
-  title: Retriever API
-  slug: retriever-api
+  category_slug: haystack-api
+  title: Retrievers
+  slug: retrievers-api
   order: 130
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: retriever_api.md
+    filename: retrievers_api.md

docs/pydoc/config/router.yml → docs/pydoc/config/routers_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Routes data to the right component based on its file type or metadata.
-  category_slug: haystack-classes
-  title: Router API
-  slug: router-api
+  category_slug: haystack-api
+  title: Routers
+  slug: routers-api
   order: 140
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: router_api.md
+    filename: routers_api.md

docs/pydoc/config/sampler.yml → docs/pydoc/config/samplers_api.yml

@@ -14,13 +14,13 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Filters documents based on their similarity scores using top-p sampling.
-  category_slug: haystack-classes
-  title: TopPSampler API
-  slug: sampler-api
+  category_slug: haystack-api
+  title: Samplers
+  slug: samplers-api
   order: 150
   markdown:
     descriptive_class_title: false
     descriptive_module_title: true
     add_method_class_prefix: true
     add_member_class_prefix: false
-    filename: sampler_api.md
+    filename: samplers_api.md

docs/pydoc/config/websearch.yml → docs/pydoc/config/websearch_api.yml

@@ -14,8 +14,8 @@ processors:
 renderer:
   type: haystack_pydoc_tools.renderers.ReadmePreviewRenderer
   excerpt: Web search engine for Haystack.
-  category_slug: haystack-classes
-  title: Websearch API
+  category_slug: haystack-api
+  title: Websearch
   slug: websearch-api
   order: 170
   markdown: