Skip to content

Import Tezos X doc - #436

Open
NicNomadic wants to merge 17 commits into
mainfrom
import-tx-doc
Open

Import Tezos X doc#436
NicNomadic wants to merge 17 commits into
mainfrom
import-tx-doc

Conversation

@NicNomadic

Copy link
Copy Markdown
Collaborator

Import the doc prepared in the Tezos X repo into the current repo to keep the exact same old Etherlink style.

@vercel

vercel Bot commented Aug 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-etherlink Ready Ready Preview Aug 4, 2026 4:09pm

Request Review

@NicNomadic NicNomadic changed the title Import tx doc Import Tezos X doc Aug 3, 2026
Comment thread docs/overview/index.md Outdated

Etherlink<!--TX--> is a fast, non-custodial execution layer enshrined in the Tezos protocol, which settles back to the Tezos consensus layer (Tezos Layer 1) for security.

Since kernel upgrade 7, Etherlink<!--TX--> exposes a **single blockchain** that is **addressable through two interfaces**: an **EVM interface** (available since early 2024 under the name "Etherlink") and a new **Michelson interface** (previously called Tezlink).

@lthms lthms Aug 4, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Since kernel upgrade 7, Etherlink<!--TX--> exposes a **single blockchain** that is **addressable through two interfaces**: an **EVM interface** (available since early 2024 under the name "Etherlink") and a new **Michelson interface** (previously called Tezlink).
Etherlink<!--TX--> exposes a **single blockchain** that is **addressable through two interfaces**: an **EVM interface** and a **Michelson interface**.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Sure, we can just say what Etherlink is now, but in order to explain to current users why there are so many changes, isn't it useful to say that the whole changes are brought in this upgrade? So people can distinguish the Etherlink-before and the Etherlink-now.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Maybe makes more sense in the new minimal-changes version, take a look.

Comment thread docs/overview/index.md Outdated
Comment thread docs/overview/index.md
Etherlink<!--TX--> is a fast, non-custodial execution layer enshrined in the Tezos protocol, which settles back to the Tezos consensus layer (Tezos Layer 1) for security.

Since kernel upgrade 7, Etherlink<!--TX--> exposes a **single blockchain** that is **addressable through two interfaces**: an **EVM interface** (available since early 2024 under the name "Etherlink") and a new **Michelson interface** (previously called Tezlink).
In that, kernel upgrade 7 constituted an important milestone in the Tezos X roadmap, securing the way to the near-term Tezos X launch.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
In that, kernel upgrade 7 constituted an important milestone in the Tezos X roadmap, securing the way to the near-term Tezos X launch.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

François (I cannot find his tag here) suggested to mention this as a milestone, check with him, I'm open to any suggestions.

Comment thread docs/overview/index.md Outdated
Since kernel upgrade 7, Etherlink<!--TX--> exposes a **single blockchain** that is **addressable through two interfaces**: an **EVM interface** (available since early 2024 under the name "Etherlink") and a new **Michelson interface** (previously called Tezlink).
In that, kernel upgrade 7 constituted an important milestone in the Tezos X roadmap, securing the way to the near-term Tezos X launch.

To enable the seamless integration of the two ecosystems in this single blockchain, Etherlink<!--TX--> provides **Native Atomic Composability** (sometimes shortened as NAC): smart contracts in one interface can call contracts in the other within a single atomic transaction. From an economical perspective, the interface used to interact with the chain doesn't matter, it becomes only a technical detail.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Why “economical perspective”?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

François's phrasing, open to change, but check with him. I understand it as: the two worlds share the same native token. (this is explicit in the next sentence)

Comment thread docs/overview/index.md
@@ -0,0 +1,96 @@
---
title: What is Etherlink? # tx

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I think this is changing the index of the doc too much tbh and i'm not sure to understand why.

You should have changed the first paragraph to generalize it and be done with it IMO.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

I can minimize the changes WRT the old version, just mentioning the dual interface and the NAC here, and leaving the details for the other pages in this Overview section. It depends if we want to emphasize continuity (via minimal changes) or the new features. I'm open to both, maybe anybody else has an opinion?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Check the last commit "minimize changes to the landing page"


For current and historical status information for Etherlink{/* TX */}, see https://status.etherlink.com.

This page contains information for connecting to the public Etherlink{/* TX */} networks via the Michelson interface.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

EVM interface, no?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Sure. Fixed, thanks

Comment thread docs/overview/get-started.md Outdated
Comment thread docs/overview/accounts-and-aliases.md Outdated
Comment thread docs/overview/accounts-and-aliases.md Outdated
Comment thread docs/overview/accounts-and-aliases.md Outdated
Co-authored-by: Thomas Letan <lthms@nomadic-labs.com>
Co-authored-by: Thomas Letan <lthms@nomadic-labs.com>
Co-authored-by: Thomas Letan <lthms@nomadic-labs.com>
Co-authored-by: Thomas Letan <lthms@nomadic-labs.com>
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.

2 participants