apply feedback

Author: 0xlukem

develop/smart-contracts/block-explorers/index.md

@@ -5,12 +5,12 @@ description: Access PolkaVM explorers like Subscan, BlockScout, and Routescan to
 
 # Block Explorers
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Introduction
 
 Block explorers serve as comprehensive blockchain analytics platforms that provide access to on-chain data. These web applications function as search engines for blockchain networks, allowing users to query, visualize, and analyze blockchain data in real time through intuitive interfaces.
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## Core Functionality
 
 These block explorers provide essential capabilities for interacting with smart contracts in Polkadot Hub:

develop/smart-contracts/connect-to-polkadot.md

@@ -5,14 +5,14 @@ description: Explore how to connect to Polkadot Hub, configure your wallet, and
 
 # Connect to Polkadot
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 <div class="button-wrapper">
     <a href="#" class="md-button connectMetaMask" value="passetHub">Connect to Polkadot Hub TestNet</a>
 </div>
 
 For more information about how to connect to Polkadot Hub, please check the [Wallets for Polkadot Hub](/develop/smart-contracts/wallets/){target=\_blank} guide.
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## Networks Details
 
 Developers can leverage smart contracts across diverse networks, from TestNets to MainNet. This section outlines the network specifications and connection details for each environment.

develop/smart-contracts/dev-environments/hardhat.md

@@ -5,6 +5,8 @@ description: Learn how to create, compile, test, and deploy smart contracts on P
 
 # Hardhat
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 <div class="grid cards" markdown>
 -   :octicons-code-16:{ .lg .middle } __Test and Deploy with Hardhat__
 
@@ -19,8 +21,6 @@ description: Learn how to create, compile, test, and deploy smart contracts on P
 
 --8<-- 'text/smart-contracts/code-size.md'
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## Overview
 
 Hardhat is a robust development environment for Ethereum-compatible chains that makes smart contract development more efficient. This guide walks you through the essentials of using Hardhat to create, compile, test, and deploy smart contracts on Polkadot Hub.

develop/smart-contracts/dev-environments/index.md

@@ -6,10 +6,10 @@ template: index-page.html
 
 # Dev Environments
 
-Explore the tools and frameworks available for building and testing smart contracts on the Polkadot network. These environments streamline the development process, from writing and compiling to testing and deploying smart contracts. The guides in this section will help you evaluate each tool's strengths, making it easier to choose the best fit for your project based on complexity, team expertise, and specific requirements.
-
 --8<-- 'text/smart-contracts/polkaVM-warning.md'
 
+Explore the tools and frameworks available for building and testing smart contracts on the Polkadot network. These environments streamline the development process, from writing and compiling to testing and deploying smart contracts. The guides in this section will help you evaluate each tool's strengths, making it easier to choose the best fit for your project based on complexity, team expertise, and specific requirements.
+
 ## What to Consider
 
 Consider the following when evaluating development environments for your workflow:

develop/smart-contracts/dev-environments/remix.md

@@ -5,6 +5,8 @@ description: Explore the smart contract development and deployment process on As
 
 # Remix IDE
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 <div class="grid cards" markdown>
 -   :octicons-code-16:{ .lg .middle } __Deploy NFTs Using Remix IDE__
 
@@ -28,8 +30,6 @@ description: Explore the smart contract development and deployment process on As
 !!! warning
     The Polkadot Remix IDE's contract compilation functionality is currently limited to Google Chrome. Alternative browsers are not recommended for this task.
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## Overview
 
 Remix IDE is a robust browser-based development environment for smart contracts. This guide will walk you through the essentials of the [Polkadot Remix IDE](https://remix.polkadot.io/){target=\_blank} to understand the processes of compiling, developing, and deploying smart contracts on Asset Hub.

develop/smart-contracts/faqs.md

@@ -5,6 +5,8 @@ description: Find answers to common questions about smart contract development,
 
 # Smart Contracts FAQs
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## General Questions
 
 ### What are the different types of smart contracts I can build on Polkadot?
@@ -35,8 +37,6 @@ Choose a parachain if:
 
 Polkadot Hub uses [PolkaVM](/polkadot-protocol/smart-contract-basics/polkavm-design){target=\_blank} instead of traditional EVM:
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 - **Performance**: RISC-V register-based architecture vs. stack-based EVM.
 - **Resource metering**: Three dimensions (`ref_time`, `proof_size`, `storage_deposit`) vs. single gas metric.
 - **Memory management**: Hard memory limits per contract vs. gas-based soft limits.

develop/smart-contracts/index.md

@@ -6,12 +6,12 @@ template: index-page.html
 
 # Smart Contracts
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 Polkadot allows scalable execution of smart contracts, offering cross-chain compatibility and lower fees than legacy L1 platforms. Polkadot provides developers with flexibility in building smart contracts, supporting both Solidity contracts executed by the [PolkaVM](/polkadot-protocol/smart-contract-basics/polkavm-design#polkavm){target=\_blank} (a Polkadot-native virtual machine for programming languages that can be compiled down to RISC-V) and EVM (Ethereum Virtual Machine), as well as Wasm-based contracts using ink! (written in Rust).
 
 This section provides tools, resources, and guides for building and deploying smart contracts on parachains. [Parachains](/polkadot-protocol/architecture/parachains/overview/){target=\_blank} are specialized blockchains connected to the relay chain, benefiting from shared security and interoperability. Depending on your language and environment preference, you can develop contracts using Wasm/ink! or EVM-based solutions.
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## Smart Contract Development Process
 
 Follow this step-by-step process to develop and deploy smart contracts in the Polkadot ecosystem:

develop/smart-contracts/json-rpc-apis.md

@@ -5,6 +5,8 @@ description: JSON-RPC APIs guide for Polkadot Hub, covering supported methods, p
 
 # JSON-RPC APIs
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Introduction
 
 Polkadot Hub provides Ethereum compatibility through its JSON-RPC interface, allowing developers to interact with the chain using familiar Ethereum tooling and methods. This document outlines the supported [Ethereum JSON-RPC methods](https://ethereum.org/en/developers/docs/apis/json-rpc/#json-rpc-methods){target=\_blank} and provides examples of how to use them.
@@ -15,8 +17,6 @@ This guide uses the Polkadot Hub TestNet endpoint:
 https://testnet-passet-hub-eth-rpc.polkadot.io
 ```
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## Available Methods
 
 ### eth_accounts

develop/smart-contracts/libraries/ethers-js.md

@@ -5,14 +5,14 @@ description: Learn how to interact with Polkadot Hub using Ethers.js, from compi
 
 # Ethers.js
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Introduction
 
 [Ethers.js](https://docs.ethers.org/v6/){target=\_blank} is a lightweight library that enables interaction with Ethereum Virtual Machine (EVM)-compatible blockchains through JavaScript. Ethers is widely used as a toolkit to establish connections and read and write blockchain data. This article demonstrates using Ethers.js to interact and deploy smart contracts to Polkadot Hub.
 
 This guide is intended for developers who are familiar with JavaScript and want to interact with Polkadot Hub using Ethers.js.
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## Prerequisites
 
 Before getting started, ensure you have the following installed:

develop/smart-contracts/libraries/index.md

@@ -6,12 +6,12 @@ template: index-page.html
 
 # Libraries
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 Explore the key libraries for interacting with smart contracts on Polkadot-based networks. These libraries simplify contract calls, event listening, and transaction handling.
 
 This section provides setup instructions, usage examples, and a comparison to help you select the right tool for your project.
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## Library Comparison
 
 Consider the following features when choosing a library for your project: