diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
index 8ed9568a..da6666e0 100644
--- a/DEVELOPMENT.md
+++ b/DEVELOPMENT.md
@@ -24,3 +24,10 @@ See JSON files in `tools/codegen/base` directory for examples of the manifest.
 3\. Add tool name to test matrix in `.github/workflows/ci.yml`.
 
 4\. Add tool name to the table in ["Supported tools" section in `README.md`](https://github.com/taiki-e/install-action#supported-tools).
+
+## Troubleshooting
+
+If one of the CI builds fails due to an bin path or release asset_name, fix the problem in the base
+manifest, and re-run the manifest tool to regenerate the manifest json file. The base manifest
+supports overriding the bin path per platform by adding the `"bin"` / `"asset_name"` to the platform
+object.