feat: Restructure the documentation

[popzxc]

PR is in draft state: Some links are broken, highlight of active section in header is broken, redirects from old pages to new ones are not added.

The content, however, is in place and fully reviewable.

---

This PR restructures the ZKsync Era documentation.

Warning

No nitpick territory! Restructuring is highly subjective, and bikeshedding about big restructuring may introduce delays in getting this PR merged. Let's focus on critical issues here, and fix everything else in follow-up PRs.

New structure

I will not describe what moved where exactly. Instead, I invite reviewers to check the preview and try to find the information they care about. If it's hard to do and the place is not intuitive -- probably the restructuring doesn't work as intended.

However, here're some highlights:

• Documentation is majorly restructured into three sections:
  • ZKsync Era: Everything about building on Era (or any other chain). Highly practical, focused on dApp developers.
  • ZK Stack: Everything about running your own stack. Again, focused on actions rather than on theory.
  • ZKsync Protocol: Theoretical information about the protocol.
• SDK docs were embedded into the documentation instead of hosting them as another top-level category.

New content

I've tried to minimize the amount of new content, but in some places I felt that the sections are too incomplete (mostly in ZK Stack section). I've added a few new pages with minimum new information, just so that we close the gaps in the narrative. These are to be extended later.

Content added:

• Changed the description of the sequencer in ZK Stack and added a link to the core book.
• Changed the description of the prover in ZK Stack and added a link to the prover book.
• Added a page about node framework.

Removed pages

Some of the pages have been removed. It mostly includes pages that either provide no information, pages that were copy-pasted from other pages, and pages that are not relevant for ZKsync (e.g. information available elsewhere).
Removed pages:

• Elliptic Curve Precompiles -- this is an overview of precompiles that are not yet available on ZKsync.
• L2->L1 Communication Before Boojum -- no longer relevant
• Migrating ZKsync Era into the ZK chain -- no longer relevant
• Batches and L2 Blocks on ZKsync -- mostly focuses on virtual blocks, no longer relevant, covered by Blocks and Batches
• L1-L2 interoperability -- no substance, covered by L1 <-> L2 communication
• FAQ -- I doubt that many of those questions are actually frequently asked. This section is useful, but we need to rework it to be more up-to-date and well structured.
• Community channels -- This information is available on the main page
• Most of the Node section -- instead I provide the link to the much more up-to-date section of the core book.

[popzxc]

OK, it turns out that the preview cannot be deployed with broken links :harold:

[github-actions]

Visit the preview URL for this PR (updated for commit b01d096):

https://zksync-docs-staging-5eb09--pr278-popzxc-docs-reorg-1kbbudz0.web.app

_{(expires Fri, 13 Dec 2024 06:46:17 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: bfaafba5fa82d4f63473aaa76a21fabf1fbb3a11}

[hedgar2017]

Do we still want to keep Differences from L1 separately?
A lot of things there are describing EraVM, so we could merge the two sections.

[popzxc]

Do we still want to keep Differences from L1 separately?

@hedgar2017 Yes, I think so. This section must be easily discoverable, so I want to have it as a top-level item.

[arose00]

Elliptic Curve Precompiles -- this is an overview of precompiles that are not yet available on ZKsync.

These precompiles are available. They are deployed as smart contracts though (were deployed during v24 IIRC).

The circuit based versions are not yet deployed.

[popzxc]

These precompiles are available. They are deployed as smart contracts though (were deployed during v24 IIRC).

I see. Still, I'd argue that the contents do not match the spirit of docs, so it doesn't make much sense to keep them. What would work better is an overview of precompiles in general, but it's related to the content (so out of scope here)

[Romsters]

LGTM, like the structure.

[github-actions]

🎉 This PR is included in version 1.47.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀