Skip to content

Conversation

@dfokina
Copy link
Contributor

@dfokina dfokina commented Dec 9, 2025

Proposed Changes:

Fixing the Vale prose linter workflow that wasn't working due to configuration issues.

  • Added vale_flags: "--config=docs-website/.vale.ini" to point to the correct config file location
  • Changed from multi-path to single path (docs-website/docs) to fix path parsing error
  • Turned off some rules which generated false positives for technical documentation
  • Refined the rules to better match Haystack Writing Guidelines
  • Fixed regex issues causing duplicate comments
  • Removed duplicate rules

How did you test it?

First experimented in #10210, you can see the final testing done in this PR below, with the Vale comments

Notes for the reviewer

This will be helpful for the engineering team to keep the documentation pages clean

Checklist

  • I have read the contributors guidelines and the code of conduct.
  • I have updated the related issue with new insights and changes.
  • I have added unit tests and updated the docstrings.
  • I've used one of the conventional commit types for my PR title: fix:, feat:, build:, chore:, ci:, docs:, style:, refactor:, perf:, test: and added ! in case the PR includes breaking changes.
  • I have documented my code.
  • I have added a release note file, following the contributors guidelines.
  • I have run pre-commit hooks and fixed any issue.

@vercel
Copy link

vercel bot commented Dec 9, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
haystack-docs Ready Ready Preview Comment Dec 9, 2025 7:31pm


`CustomEmbedder` generates dense vector representations of text. The user can configure the model and its parameters during initialization.

This component supports multiple embedding providers, e.g. OpenAI, Cohere, and local models.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] reported by reviewdog 🐶
[Google.Latin] Use 'for example' instead of 'e.g. '.


### In a Pipeline

Please initialize the embedder before adding it to a pipeline:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[MyStyle.AvoidPlease] Avoid 'please' in instructions—it can make actions seem optional. Use imperative instead.


| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `model_name` | `str` | Required | The embedding model to utilize |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[MyStyle.WordChoice] Use 'use' instead of 'utilize'.

| `model_name` | `str` | Required | The embedding model to utilize |
| `batch_size` | `int` | `32` | Number of texts to process at once |

Export your configuration to a json file for reproducibility.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[MyStyle.FileExtensions] Use uppercase for file extensions: 'JSON' → 'json'.

@dfokina dfokina requested a review from anakin87 December 9, 2025 19:36
@dfokina dfokina marked this pull request as ready for review December 9, 2025 19:36
@dfokina dfokina requested a review from a team as a code owner December 9, 2025 19:36
Copy link
Member

@anakin87 anakin87 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@dfokina dfokina merged commit 5efa691 into main Dec 10, 2025
15 checks passed
@dfokina dfokina deleted the vale-fix branch December 10, 2025 09:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants