diff --git a/haystack/components/embedders/azure_document_embedder.py b/haystack/components/embedders/azure_document_embedder.py
index 83153e22b06..4183b15edae 100644
--- a/haystack/components/embedders/azure_document_embedder.py
+++ b/haystack/components/embedders/azure_document_embedder.py
@@ -36,7 +36,7 @@ class AzureOpenAIDocumentEmbedder(OpenAIDocumentEmbedder):
     ```
     """
 
-    def __init__(  # noqa: PLR0913 (too-many-arguments)
+    def __init__(  # noqa: PLR0913, PLR0917 (too-many-arguments, too-many-positional-arguments)
         self,
         azure_endpoint: str | None = None,
         api_version: str | None = "2023-05-15",
diff --git a/haystack/components/embedders/openai_document_embedder.py b/haystack/components/embedders/openai_document_embedder.py
index 9005a7760d0..dbc2b932e50 100644
--- a/haystack/components/embedders/openai_document_embedder.py
+++ b/haystack/components/embedders/openai_document_embedder.py
@@ -39,7 +39,7 @@ class OpenAIDocumentEmbedder:
     ```
     """
 
-    def __init__(  # noqa: PLR0913 (too-many-arguments)
+    def __init__(  # noqa: PLR0913, PLR0917 (too-many-arguments, too-many-positional-arguments)
         self,
         api_key: Secret = Secret.from_env_var("OPENAI_API_KEY"),
         model: str = "text-embedding-ada-002",
diff --git a/pyproject.toml b/pyproject.toml
index a6579bdc1a4..f5a1c4cb670 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -207,7 +207,9 @@ module = ["haystack.testing.*"]
 disallow_incomplete_defs = false
 
 [tool.ruff]
-exclude = ["e2e/**", "proposals"]
+# "*.md": ruff formats Python code blocks inside Markdown; our docs (including the generated
+# docs-website API reference) are not managed by ruff.
+exclude = ["*.md", "e2e/**", "proposals"]
 line-length = 120