Add troubleshooting hardhat (new IA) #1201
Conversation
nhussein11
added
B0 - Needs Review
nhussein11
temporarily deployed
to
n8n-sending
GitHub Actions
Inactive
There was a problem hiding this comment.
Pull Request Overview
This PR adds a comprehensive troubleshooting guide for developers using Hardhat on Polkadot Hub and removes the placeholder "verify a contract" page since no block explorer is currently available. The guide covers common issues across installation, compilation, deployment, testing, and contract interaction with practical solutions for each problem.
- Adds detailed troubleshooting documentation with solutions for common Hardhat issues
- Removes the verify-a-contract.md placeholder file since block explorers are not available
- Updates navigation and AI-generated files to reflect the new content structure
Reviewed Changes
Copilot reviewed 9 out of 9 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| smart-contracts/dev-environments/hardhat/troubleshooting.md | Comprehensive troubleshooting guide covering installation, compilation, testing, deployment, and contract interaction issues |
| smart-contracts/dev-environments/hardhat/verify-a-contract.md | Removed placeholder file for contract verification |
| smart-contracts/dev-environments/hardhat/.nav.yml | Updated navigation to remove verify page and include troubleshooting |
| llms.txt | Added troubleshooting page to AI-generated documentation index |
| llms-full.jsonl | Updated with full troubleshooting content for AI training |
| .ai/site-index.json | Updated site index with troubleshooting page metadata |
| .ai/pages/smart-contracts-dev-environments-hardhat-troubleshooting.md | AI-formatted version of troubleshooting guide |
| .ai/categories/tooling.md | Added troubleshooting content to tooling category |
| .ai/categories/smart-contracts.md | Added troubleshooting content to smart contracts category |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
nhussein11
temporarily deployed
to
n8n-receiving
GitHub Actions
Inactive
brunopgalvao
left a comment
brunopgalvao
left a comment
There was a problem hiding this comment.
I do not really see a need for this troubleshooting page. Most of the content is related to HardHat troubleshooting and not specific to underlying Polkadot issues. Nowadays with AI at our finger tips, a quick generative response can resolve most/all of the troubleshooting issues on this page.
Other than that the document looks good.
Note: I removed the verify contracts page since there is no block explorer available.
📝 Description
Provide a clear and concise description of your changes.
🔍 Review Preference
Choose one:
🤖 AI-Ready Docs
If content changed, regenerate AI files:
python3 scripts/generate_llms.py✅ Checklist