Skip to content

docs(fallback): use fallback_providers list shape throughout - #30403

Closed
Aman113114-IITD wants to merge 1 commit into
NousResearch:mainfrom
Aman113114-IITD:docs/fallback-providers-canonical-shape
Closed

docs(fallback): use fallback_providers list shape throughout#30403
Aman113114-IITD wants to merge 1 commit into
NousResearch:mainfrom
Aman113114-IITD:docs/fallback-providers-canonical-shape

Conversation

@Aman113114-IITD

Copy link
Copy Markdown

The user-guide fallback-providers page primarily showed the legacy 'fallback_model:' singular key in every example, with only a small note pointing at the canonical top-level 'fallback_providers:' list. The code path (and 'hermes fallback' CLI) writes the list shape, and environment-variables.md was already cleaned up to reflect this.

Rewrite the page so every example uses 'fallback_providers' as a top- level list, invert the comparison note to describe 'fallback_providers' as canonical and 'fallback_model' as legacy back-compat, add a multi-entry example to show chaining, and fix the summary table row.

Refs #19691

What does this PR do?

Related Issue

Fixes #

Type of Change

  • 🐛 Bug fix (non-breaking change that fixes an issue)
  • ✨ New feature (non-breaking change that adds functionality)
  • 🔒 Security fix
  • 📝 Documentation update
  • ✅ Tests (adding or improving test coverage)
  • ♻️ Refactor (no behavior change)
  • 🎯 New skill (bundled or hub)

Changes Made

How to Test

Checklist

Code

  • I've read the Contributing Guide
  • My commit messages follow Conventional Commits (fix(scope):, feat(scope):, etc.)
  • I searched for existing PRs to make sure this isn't a duplicate
  • My PR contains only changes related to this fix/feature (no unrelated commits)
  • I've run pytest tests/ -q and all tests pass
  • I've added tests for my changes (required for bug fixes, strongly encouraged for features)
  • I've tested on my platform:

Documentation & Housekeeping

  • I've updated relevant documentation (README, docs/, docstrings) — or N/A
  • I've updated cli-config.yaml.example if I added/changed config keys — or N/A
  • I've updated CONTRIBUTING.md or AGENTS.md if I changed architecture or workflows — or N/A
  • I've considered cross-platform impact (Windows, macOS) per the compatibility guide — or N/A
  • I've updated tool descriptions/schemas if I changed tool behavior — or N/A

For New Skills

  • This skill is broadly useful to most users (if bundled) — see Contributing Guide
  • SKILL.md follows the standard format (frontmatter, trigger conditions, steps, pitfalls)
  • No external dependencies that aren't already available (prefer stdlib, curl, existing Hermes tools)
  • I've tested the skill end-to-end: hermes --toolsets skills -q "Use the X skill to do Y"

Screenshots / Logs

The user-guide fallback-providers page primarily showed the legacy
'fallback_model:' singular key in every example, with only a small
note pointing at the canonical top-level 'fallback_providers:' list.
The code path (and 'hermes fallback' CLI) writes the list shape, and
environment-variables.md was already cleaned up to reflect this.

Rewrite the page so every example uses 'fallback_providers' as a top-
level list, invert the comparison note to describe 'fallback_providers'
as canonical and 'fallback_model' as legacy back-compat, add a
multi-entry example to show chaining, and fix the summary table row.

Refs NousResearch#19691
@alt-glitch alt-glitch added type/docs Documentation improvements area/config Config system, migrations, profiles P3 Low — cosmetic, nice to have labels May 22, 2026
@alt-glitch

Copy link
Copy Markdown
Collaborator

Duplicate of #26017 / #23163 — both address the same fallback_providers docs alignment for #19691. Same file (fallback-providers.md), same change.

@teknium1

Copy link
Copy Markdown
Contributor

This looks implemented on current main by the earlier fallback-docs alignment work. Automated hermes-sweeper review.

Evidence:

@teknium1 teknium1 closed this Jun 21, 2026
@teknium1 teknium1 added the sweeper:implemented-on-main Sweeper: behavior already present on current main label Jun 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/config Config system, migrations, profiles P3 Low — cosmetic, nice to have sweeper:implemented-on-main Sweeper: behavior already present on current main type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants