## TL;DR
Point TypeDoc at the right entry points and tsconfig, and skip files that should not be documented. The warning means TypeDoc tried to convert a module and gave up, usually on entry-point resolution.

## Error
```text
Warning: Converting one or more modules failed.
```

## Steps
1. Run TypeDoc with `--logLevel Verbose` to see which modules failed and why. Expected: the log names the failing entry points.
2. Check the entryPoints setting in typedoc.json or the CLI args: they must resolve to real files. A stale entry pointing at a deleted file fails conversion. Expected: every entry point exists.
3. Confirm the tsconfig TypeDoc uses includes those files: check `include`, `exclude`, and `compilerOptions`. A file excluded from the program cannot be converted. Expected: entry points are inside the tsconfig program.
4. Re-run `npx typedoc`. Expected: the warning is gone and the modules appear in the output.

## When to use
- TypeDoc emits the converting-modules-failed warning
- Entry points were renamed or the project was restructured
- A docs agent wrote the typedoc.json with guessed entry points

## When not to use
- TypeDoc reports TypeScript compile errors (fix the code or set skipErrorChecking)
- The output is empty (entry points resolve to nothing at all)
- The failure is a crash, not a warning

## Tool compatibility
TypeDoc 0.24 through 0.28. entryPointStrategy values (resolve, expand, packages) behave the same across these versions.

### Variant phrasings
### warning appears only for one package in a monorepo
That package's entry point or tsconfig reference is wrong. Fix it in the package's own typedoc config.

### modules fail after a TypeScript upgrade
TypeDoc versions track TypeScript versions. Upgrade TypeDoc to one that supports your TypeScript release.

## Why it happens
TypeDoc builds a TypeScript program from your config and converts each entry point. Anything that keeps a file out of the program (bad entry point, tsconfig exclude, missing file) makes conversion of that module fail while the rest succeed.

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_IeoAx84AsGs-VpzWNfOXKw