refactor: chain terminology

Author: Daanvdplas

pop-cli-for-appchains/README.md

@@ -6,4 +6,4 @@ Build custom blockchain that can operate as solo chains or connect to Polkadot f
 
 Start building with the [Polkadot documentation](https://docs.polkadot.com/).
 
-**Ready to build your first chain?** [Start here!](guides/create-a-new-parachain/)
+**Ready to build your first chain?** [Start here!](guides/create-a-new-chain.md)

pop-cli-for-appchains/SUMMARY.md

@@ -11,13 +11,13 @@
 ## GUIDES
 
 * [Create a new chain](guides/create-a-new-chain.md)
-* [Build](guides/build-your-parachain.md)
+* [Build](guides/build-your-chain.md)
   * [Build your chain specification](guides/build-spec.md)
   * [Build your runtime deterministically](guides/build-deterministic-runtime.md)
 * [Test runtime upgrades](guides/test-runtime-upgrades.md)
 * [Benchmarking](guides/benchmarking/benchmarking-pallets-and-extrinsics.md)
 * [Deploy](guides/launch-a-chain/README.md)
-  * [Launch a Chain in Development](guides/launch-a-chain/running-your-parachain.md)
+  * [Launch a Chain in Development](guides/launch-a-chain/running-your-chain.md)
   * [Launch a Known Chain](guides/launch-a-chain/launch-a-known-chain.md)
   * [Launch a Chain to Paseo](guides/launch-a-chain/launch-a-chain-to-paseo.md)
     * [Launch Paseo](guides/launch-a-chain/launch-paseo.md)

pop-cli-for-appchains/guides/build-your-parachain.md renamed to pop-cli-for-appchains/guides/build-your-chain.md

@@ -1,17 +1,17 @@
-# Build your parachain
+# Build your chain
 
-To build your parachain using Pop CLI
+To build your chain using Pop CLI
 
 ```shell
-cd my-appchain
+cd my-chain
 pop build
 ```
 
 ```
-┌   Pop CLI : Building a parachain
+┌   Pop CLI : Building a chain
 │
-   Compiling parachain-template-runtime v0.1.0 (/Users/pop/src/my-appchain/runtime)
-   Compiling parachain-template-node v0.1.0 (/Users/pop/src/my-appchain/node)
+   Compiling parachain-template-runtime v0.1.0 (/Users/pop/src/my-chain/runtime)
+   Compiling parachain-template-node v0.1.0 (/Users/pop/src/my-chain/node)
     Finished release [optimized] target(s) in 1m 20s
 
 └  Build Completed Successfully!
@@ -20,25 +20,26 @@ pop build
 If you are outside the project's directory, you can specify the path
 
 ```shell
-pop build -p ./my-appchain
+pop build -p ./my-chain
 ```
 
-If you are building the parachain with the intent to onboard the parachain to a Polkadot Relay chain then you can run the following build command:
+If you are building the chain with the intent to onboard to a Polkadot Relay chain then you can run the following build command:
 
 ```
-pop build -p ../my-appchain --para_id 2000
+pop build -p ../my-chain --para_id 2000
 ```
 
-This command will build your parachain and generate the chain spec, WebAssembly runtime for the parachain, and generate the parachain genesis state needed for registering and onboarding a parachain onto the Relay chain.
+This command will build your chain and generate the chain spec, the WebAssembly runtime, and generate the chain genesis state needed for registering and onboarding onto the Relay chain.
 
 #### Learning Resources
 
 * 🧑‍🏫 To learn about Polkadot in general, [Polkadot.network](https://polkadot.network/) website is a good starting point.
-  * ⭕ Learn more about parachains [here](https://wiki.polkadot.network/docs/learn-parachains).
+  * ⭕ Learn more about chains [here](https://wiki.polkadot.network/docs/learn-parachains).
 * 🧑‍🔧 For technical introduction, [here](https://github.com/paritytech/polkadot-sdk#-documentation) are the Polkadot SDK documentation resources.
 
 **Technical Support**
 
 * [Polkadot Stack Exchange](https://polkadot.stackexchange.com/)
   * Create a question and tag it with "[`pop`](https://substrate.stackexchange.com/tags/pop/info)"
-  * Share the StackExchange question in our [Pop Support Telegram channel](https://t.me/pop\_support)
+  * Share the StackExchange question in our [Pop Support Telegram channel](https://t.me/pop_support)
+

pop-cli-for-appchains/guides/create-a-new-chain.md

@@ -18,6 +18,8 @@ Available templates:
 - Parity
   - Polkadot SDK's Parachain Template
 
+> Note: Some upstream template names and binaries still say "parachain", this is a Polkadot Chain.
+
 **Need help?**
 
 Ask on [Polkadot Stack Exchange](https://polkadot.stackexchange.com/) (tag it [`pop`](https://substrate.stackexchange.com/tags/pop/info)) or drop by [our Telegram](https://t.me/onpopio). We're here to help!

pop-cli-for-appchains/guides/launch-a-chain/README.md

@@ -6,7 +6,7 @@ description: The following guides show how to launch a chain on Polkadot.
 
 A typical development workflow for launching a chain on Polkadot: 
 
-1. [Launch a Development Network](running-your-parachain.md) with predefined chains.
+1. [Launch a Development Network](running-your-chain.md) with predefined chains.
 2. [Launch a Known Chain](launch-a-known-chain.md)
 3. [Launch a Chain on Paseo](launch-a-chain-to-paseo.md).
 4. [Deploy a Chain With Polkadot Deployment Portal](deploy-a-chain-polkadot-deployment-portal.md).

pop-cli-for-appchains/guides/launch-a-chain/launch-a-chain-to-paseo.md

@@ -69,7 +69,7 @@ Request PAS tokens on [Paseo Faucet](https://faucet.polkadot.io/).
 For the sake of this exercise, let's create a new chain project:
 
 ```
-pop new parachain my-chain
+pop new chain my-chain
 ```
 
 > The folder includes a `network.toml` file which can be ignored. This is to launch a network with the chain already onboarded.

pop-cli-for-appchains/guides/launch-a-chain/running-your-parachain.md renamed to pop-cli-for-appchains/guides/launch-a-chain/running-your-chain.md

@@ -1,20 +1,17 @@
 # Launch a Chain in Development
 
-To run your parachain, you will need to spin up a local network with your parachain configuration.
+To run your chain, you will need to spin up a local network with your chain configuration.
 
 The `pop up` command can help with this.
 
 ```shell
 pop up network --help
 ```
 
-> [!TIP]
-> For Pop CLI versions <`0.7.0` the `pop up network` command is `pop up parachain`
-
-Say we want to spin up a local network for your parachain. First we need to define a [zombienet](https://github.com/paritytech/zombienet) network configuration file. You can do this in the root of your project.
+Say we want to spin up a local network for your chain. First we need to define a [zombienet](https://github.com/paritytech/zombienet) network configuration file. You can do this in the root of your project.
 
 ```
-cd my-appchain
+cd my-chain
 touch network.toml
 ```
 
@@ -42,9 +39,9 @@ default_command = "./target/release/parachain-template-node"
 name = "collator-01"
 ```
 
-> This network configuration will launch a relay chain using a `paseo-local` instance of Polkadot with two validator nodes to run the network: `alice` and `bob`. It will also run `parachain-template-node` with one collator node named `collator-01`.
+> This network configuration will launch a relay chain using a `paseo-local` instance of Polkadot with two validator nodes to run the network: `alice` and `bob`. It will also run `parachain-template-node` (the upstream binary name) with one collator node named `collator-01`.
 
-Cool. Let's spin this up, ensuring that your parachain binary has been built using `pop build parachain`.
+Cool. Let's spin this up, ensuring that your chain binary has been built using `pop build`.
 
 ```shell
 pop up ./network.toml
@@ -55,7 +52,7 @@ If this is the first time you are running the `pop up` command, it will prompt y
 Once all the binaries are sourced, you should have output similar to this.
 
 ```
-┌   Pop CLI : Deploy a parachain
+┌   Pop CLI : Deploy a chain
 │
 ◇  🚀 Network launched successfully - ctrl-c to terminate
 │  ⛓️ paseo-local
@@ -72,17 +69,18 @@ Once all the binaries are sourced, you should have output similar to this.
 │
 ```
 
-Congrats! You have now spun up a network with your parachain running!
+Congrats! You have now spun up a network with your chain running!
 
 > Under-the-hood, Pop CLI uses zombienet to spin up the network.\
 > For more advanced network configurations and options consult the [zombienet repo](https://github.com/paritytech/zombienet)
 
 #### Learning Resources
 
 * 🧑‍🏫 To learn about Polkadot in general, [Polkadot.network](https://polkadot.network/) website is a good starting point.
-  * ⭕ Learn more about parachains [here](https://wiki.polkadot.network/docs/learn-parachains).
+  * ⭕ Learn more about Polkadot Chains [here](https://wiki.polkadot.network/docs/learn-parachains).
 * 🧑‍🔧 For technical introduction, [here](https://github.com/paritytech/polkadot-sdk#-documentation) are the Polkadot SDK documentation resources.
 
 **Need help?**
 
 Ask on [Polkadot Stack Exchange](https://polkadot.stackexchange.com/) (tag it [`pop`](https://substrate.stackexchange.com/tags/pop/info)) or drop by [our Telegram](https://t.me/onpopio). We're here to help!
+

welcome/hackathon-guide.md

@@ -99,10 +99,10 @@ pop up
 ```
 
 ##### Handy Links
-- [Launch a Chain in Development](../pop-cli-for-appchains/guides/launch-a-chain/running-your-parachain.md)
-- [Launch a Chain to Paseo](../pop-cli-for-appchains/guides/launch-a-chain/launch-a-chain-to-paseo.md)
-- [Deploy a chain with Polkadot Deployment Portal](../pop-cli-for-appchains/guides/launch-a-chain/deploy-a-chain-polkadot-deployment-portal.md)
-- [Securely Sign Transactions from CLI](../pop-cli-for-appchains/guides/securely-sign-transactions-from-cli.md)
+- [Launch a Chain in Development](../pop-cli-for-chains/guides/launch-a-chain/running-your-chain.md)
+- [Launch a Chain to Paseo](../pop-cli-for-chains/guides/launch-a-chain/launch-a-chain-to-paseo.md)
+- [Deploy a chain with Polkadot Deployment Portal](../pop-cli-for-chains/guides/launch-a-chain/deploy-a-chain-polkadot-deployment-portal.md)
+- [Securely Sign Transactions from CLI](../pop-cli-for-chains/guides/securely-sign-transactions-from-cli.md)
 
 
 ### Support & Contribute