Skip to content

Conversation

@nhussein11
Copy link
Collaborator

πŸ“ Description

Provide a clear and concise description of your changes.

πŸ” Review Preference

Choose one:

  • βœ… I have time to handle formatting/style feedback myself
  • ⚑ Docs team handles formatting (check "Allow edits from maintainers")

πŸ€– AI-Ready Docs

If content changed, regenerate AI files:

  • βœ… I ran python3 scripts/generate_llms.py
  • ⚑ Docs team will regenerate (check "Allow edits from maintainers")

βœ… Checklist

@nhussein11 nhussein11 self-assigned this Nov 4, 2025
@nhussein11 nhussein11 requested a review from a team as a code owner November 4, 2025 21:26
Copilot AI review requested due to automatic review settings November 4, 2025 21:26
@nhussein11 nhussein11 added B0 - Needs Review Pull request is ready for review C1 - Medium Medium priority task A0 - New Content Pull request contains new content pages labels Nov 4, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR updates the Remix IDE documentation to reflect the migration from Polkadot-specific Remix IDE (remix.polkadot.io) to the standard Ethereum Remix IDE (remix.ethereum.org) for use with Polkadot Hub. The changes update references, wallet providers, and add comprehensive troubleshooting documentation.

  • Migrated from Polkadot Remix IDE to standard Ethereum Remix IDE
  • Updated wallet provider from Talisman to MetaMask as the primary example
  • Added comprehensive troubleshooting guide with common issues and solutions

Reviewed Changes

Copilot reviewed 4 out of 21 changed files in this pull request and generated 4 comments.

File Description
troubleshooting.md Added new comprehensive troubleshooting guide covering compilation, wallet connection, deployment, contract interaction, and browser issues
get-started.md Updated to reference remix.ethereum.org and MetaMask instead of Polkadot-specific IDE and Talisman; removed deployment/interaction sections (moved to separate file)
deploy-a-contract.md Added new guide focused on contract deployment and interaction using wallet providers
.nav.yml Commented out "Verify a Contract" navigation item with TODO note

πŸ’‘ Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated style guide suggestions (1-15 of 15)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@dawnkelly09
Copy link
Collaborator

Handled robot feedbacks. Once this gets tech review, I'll run through it one more time.

Copy link
Contributor

@brunopgalvao brunopgalvao left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Left one comment.

@dawnkelly09
Copy link
Collaborator

I updated the formatting on the Troubleshooting page to use the FAQ interface style admonitions. You'll need to serve it with: papermoonio/polkadot-mkdocs#173 to see the correct formatting.

@dawnkelly09 dawnkelly09 requested a review from eshaben November 11, 2025 18:26
Copy link
Collaborator

@dawnkelly09 dawnkelly09 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ready for a sanity check by Erin. Needs mkdocs PR: papermoonio/polkadot-mkdocs#173 for proper styling of troubleshooting/faq page

Copy link
Collaborator

@eshaben eshaben left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

gahhhhhh I commented on the AI pages πŸ€¦β€β™€οΈ - no going back now haha, sorry

categories: Smart Contracts, Tooling
---

# Remix IDE Troubleshooting and FAQs
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's no FAQs on this page so this title just doesn't really fit


This guide provides solutions to common issues you may encounter when using Remix IDE with Polkadot Hub. If you're experiencing problems with compilation, deployment, or contract interaction, you'll likely find the solution here.

## Problem: Contract fails to compile or shows errors in the terminal.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Keep headers consistent please and remove Problem or keep it. Also I would remove the punctuation at the end of all these

@@ -0,0 +1,205 @@
---
title: Troubleshooting and FAQs
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remember this is for SEO purposes and is what shows up on search engines, so what's going to differentiate this title on google compared to the Hardhat Troubleshooting page?

@@ -0,0 +1,205 @@
---
title: Troubleshooting and FAQs
description: Solutions to common issues when developing, compiling, and deploying smart contracts using Remix IDE on Polkadot Hub.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

3 characters too short.


Learn how to deploy and interact with smart contracts using Remix.

[:octicons-arrow-right-24: Get Started](/smart-contracts/dev-environments/remix/deploy-a-contract)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Trailing slashes missing

- A web browser with [MetaMask](https://metamask.io/){target=\_blank} extension installed.
- Basic understanding of Solidity programming.
- Some WND test tokens to cover transaction fees (easily obtainable from the [Polkadot faucet](https://faucet.polkadot.io/westend?parachain=1000){target=\_blank}).
- Some DOT test tokens to cover transaction fees (easily obtainable from the [Polkadot faucet](/smart-contracts/faucet/){target=\_blank}).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

DOT? Is this right?

Comment on lines 38 to 40
3. Write your Solidity code in the editor.

You can use the following code as an example:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This spacing looks a little weird, can we just move it to one line?


1. Navigate to the **Solidity Compiler** tab (third icon in the left sidebar).
2. Select **Compile** or use `Ctrl+S`.
1. Navigate to the **Solidity Compiler** tab (third icon in the left sidebar).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking at the gif, looks like the 4th icon now. I don't think we should callout the order in which it appears, cause we can't predict when that will change

1. After compiling your contract, you can navigate to the **File Explorer** tab (first icon in the left sidebar) and check that:
1. The `artifact` folder is present.
3. After compiling your contract, you can navigate to the **File Explorer** tab (first icon in the left sidebar) and check that:
1. The `artifacts` folder is present.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a UI element = bold

## Where to Go Next

The Polkadot Remix IDE offers an environment for developing, compiling, and deploying smart contracts on Asset Hub. Its intuitive interface allows developers to easily write Solidity code, compile contracts, and interact with them directly in the browser.
The Remix IDE offers an environment for developing, compiling, and deploying smart contracts on the Polkadot Hub. Its intuitive interface allows developers to easily write Solidity code, compile contracts, and interact with them directly in the browser.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The Remix IDE offers an environment for developing, compiling, and deploying smart contracts on the Polkadot Hub. Its intuitive interface allows developers to easily write Solidity code, compile contracts, and interact with them directly in the browser.
Remix offers an environment for developing, compiling, and deploying smart contracts on Polkadot Hub. Its intuitive interface allows developers to easily write Solidity code, compile contracts, and interact with them directly in the browser.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A0 - New Content Pull request contains new content pages B0 - Needs Review Pull request is ready for review C1 - Medium Medium priority task

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants