Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Majella add networks comparison #951

Merged
merged 15 commits into from
Sep 24, 2020
Merged

Conversation

MajellaH
Copy link
Contributor

Fixes Issue #628
New web page with comparisons between Polkadot and Kusama networks

@Swader
Copy link
Contributor

Swader commented Sep 14, 2020

@w3fbot prettify please

@MajellaH I would recommend linking to Kusama's resources:

@MajellaH
Copy link
Contributor Author

@Swader Links added

@Swader
Copy link
Contributor

Swader commented Sep 14, 2020

If you click on View File, you can preview how your links look if you're only editing online (in Github's UI) rather than locally on your machine. You will notice the links are rendered in order one after the other, and not as a list, one under the other. To get a list, you put an asterisk or a dash in front of every new line, like so:

- one
- two
- three

Also, you should never omit the protocol in links (https://) because you never know how a link is set up server-side, it might not be equipped to auto-redirect from http (default when omitted) to https (desired). Last but not least, you should always test your links (the View File function will help) - you'll notice that the last one, dotapps, does not work. Instead, it redirects to Polkadot's dotapps, not Kusama's. For best results, use the links exactly as I gave them in the comments, i.e. do not change the URLs.


There are a few important distinctions to be made.

![polkadot_vs_kusama](/img/polkadot_vs_kusama.png)
Copy link
Contributor

Choose a reason for hiding this comment

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

I would recommend here to place the image inside the assets folder. Logan's new img optimizer will be optimizing the images inside that folder.


## What the two networks have in common

Kusama was released as an early version of the same code to be used in Polkadot, which means they share the same underlying architecture: a multichain, heterogeneously-sharded design based on nominated proof of stake (NPoS).
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Kusama was released as an early version of the same code to be used in Polkadot, which means they share the same underlying architecture: a multichain, heterogeneously-sharded design based on nominated proof of stake (NPoS).
Kusama was released as an early version of the same code to be used in Polkadot, which means they share the same underlying architecture: a multichain, heterogeneously-sharded design based on Nominated Proof of Stake (NPoS).

just a nitpick =)

## What the two networks have in common

Kusama was released as an early version of the same code to be used in Polkadot, which means they share the same underlying architecture: a multichain, heterogeneously-sharded design based on nominated proof of stake (NPoS).
Both networks also share key innovations like on-chain governance, hot-swappable runtimes for forkless, on-chain upgrades, and cross-chain message passing (XCMP) for interoperability.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Both networks also share key innovations like on-chain governance, hot-swappable runtimes for forkless, on-chain upgrades, and cross-chain message passing (XCMP) for interoperability.
Both networks also share key innovations like on-chain governance, hot-swappable runtimes for forkless, on-chain upgrades, and Cross-Chain Message Passing (XCMP) for interoperability.

@Swader
Copy link
Contributor

Swader commented Sep 17, 2020

@w3fbot prettify

@MajellaH MajellaH closed this Sep 17, 2020
@Swader
Copy link
Contributor

Swader commented Sep 17, 2020

@MajellaH why did you close this?
@lsaether what's up with the bot, it won't prettify? Is this because of #944?

@MajellaH MajellaH reopened this Sep 17, 2020
@MajellaH
Copy link
Contributor Author

Sorry - closed in error.

@lsaether
Copy link
Contributor

@Swader No I think it's just glitching on this branch since the check-format CI is not running.

sidebar_label: Comparing Polkadot and Kusama
---

# What is the difference between Polkadot and Kusama?
Copy link
Contributor

Choose a reason for hiding this comment

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

This will cause the page to have two header titles since the title is taken from the metadata above. So it would end up rendering like the below. I would recommend changing the title field in the metadata and deleting the first header.

Comparing Polkadot and Kusama

What is the difference between Polkadot and Kusama?

Although they are built...

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Changed


# What is the difference between Polkadot and Kusama?

Although they are built on nearly the same codebase, Polkadot and Kusama are independent, standalone networks with different priorities.
Copy link
Contributor

Choose a reason for hiding this comment

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

Technically they are built from the same codebase so it may be better to rephrase this as saying they "share many parts of their code".

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Changed

docs/learn-kusama-vs-polkadot.md Outdated Show resolved Hide resolved
docs/learn-kusama-vs-polkadot.md Outdated Show resolved Hide resolved
docs/learn-kusama-vs-polkadot.md Outdated Show resolved Hide resolved
@lsaether lsaether merged commit 8eb3a96 into master Sep 24, 2020
@lsaether lsaether deleted the majella_add_networks_comparison branch September 24, 2020 19:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants