https://github.com/0xpolygon/devrel-docs
https://github.com/0xpolygon/devrel-docs
Last synced: 11 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/0xpolygon/devrel-docs
- Owner: 0xPolygon
- License: mit
- Created: 2024-07-12T13:56:01.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-03T06:08:46.000Z (about 1 year ago)
- Last Synced: 2025-04-16T18:20:12.648Z (about 1 year ago)
- Language: Shell
- Size: 5.48 MB
- Stars: 4
- Watchers: 1
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Learn platform
In progress material for Polygon Docs' Learn section. Content managed by the
[Polygon DevRel team](https://polygon.technology/community/meet-the-devrel).
## Content
External contributors should feel at home grabbing some incomplete topics and
sending in PRs with drafts. If you run into a tutorial about Polygon's tech
stack in the wild that isn't mentioned here, please feel free to
[open an issue](https://github.com/0xPolygon/devrel-docs/issues). Alternatively,
[reach out](https://polygon.technology/community/meet-the-devrel) to discuss
adding it.
Please note that if you PR some of your content in, we can't guarantee its
publication. If we do accept it, we will be modifying it to fit the style of the
rest of the site. You will get full credit for your work.
### Getting your feet wet
- General Concepts
- [x] The Polygon stack: Clarifying the choice
- Agglayer
- [x] Overview
- [x] Trust Levels Between AggLayer Chains
- [ ] Learn AggLayer: A comprehensive list of external resources
- [x] A day in the life of an AggLayer tx
- [x] Pessimistic Proof
- [x] Unified Liquidity
- [x] Understand Exit and Balance Trees
- [ ] Block building in AggLayer
- [ ] Network parameters and contract addresses
- [ ] Detailed look at AggLayer L1 contracts
- PoS
- [x] Overview
- [ ] A Day in the Life of a Polygon PoS TX
- [ ] Block building in Polygon PoS
- [ ] Network parameters and contract addresses
- [ ] Detailed Look at Polygon PoS L1 Contracts
- [ ] Let’s deploy a contract to Polygon PoS!
- [ ] The gas costs implications of advanced contracts
- zkEVM
- [x] Overview
- [ ] A Day in the Life of a Polygon zkEVM TX
- [ ] Block building in Polygon zkEVM
- [ ] Network parameters and contract addresses
- [ ] Detailed Look at Polygon zkEVM L1 Contracts
- [ ] Let’s deploy a contract to Polygon zkEVM!
- [ ] The gas costs implications of advanced contracts and L1 settlements
- Miden Basic
- [x] Overview
- [ ] A Day in the Life of a Miden TX
- [x] Notes and Their Features
- [x] Note Types
- [ ] Block building in Miden
- [ ] Network parameters
- [ ] Miden Use Cases
- [ ] Writing Miden Contracts
- [ ] Miden Assembly Crash Course 1: Hello World
- [ ] Miden Assembly Crash Course 2: Counter
- [ ] Miden Rust Crash Course
- [ ] Deploying to Production
- [ ] Coin flip Step by Step
- [ ] Rock Paper Scissors Step by Step
### Going for a swim
A section for those who passed the basics of dapp development on the Polygon
stack and are ready to take full advantage of some Polygon stack USPs.
- Miden advanced
- [ ] Deep dive into Miden architecture
- [ ] Advanced contract development techniques
- [ ] Call logic across multiple notes
- [ ] Developing multi-contract dapps
- [ ] Using Miden for privacy-preserving applications
- Advanced dapp development
- [ ] Let’s build a private-voting DAO step-by-step
- [ ] Ensuring security and privacy: implications and tradeoffs
- CDK
- [ ] Deep dive into CDK architecture
- [ ] Sequencer: CDK Erigon Breakdown
- [ ] Prover: esp Capacity (zkCounter), Full Execution Proof
- [ ] Data Availability
- [ ] Features: Rollback Sequence (banana) & Sovereign upgrades
- [ ] How does it work with AggLayer?
- [ ] CDK CLI interface example
- AggLayer
- [ ] Chaining cross-chain calls with `BridgeAndCall`
- [ ] CCIP vs AggLayer for cross chain calls
- [ ] Sequencing: centralization tradeoffs and future solutions
- Gaming supercase
- [ ] Simple game design
- [ ] Simple marketplace on Polygon PoS
- [ ] Characters on Polygon zkEVM
- [ ] Equipping game items across chains with `BridgeAndCall`
### Deep dive
- Plonky3
- [x] Overview
- [x] Fibonacci in Plonky3 - Introduction to Plonky3
- [x] Range Check in Plonky3 - Constrain Degree Design & Intermediate Variables
- [ ] Merkle Tree Tutorial
- [ ] Plonky3 Configuration Walkthrough - how to configure your Plonky3 Backend
- [ ] zkVM Step by Step Guide
- [ ] zkML Step by Step Guide
- CDK
- [ ] Kurtosis CDK
- [ ] Validium vs Calldata Rollup
- [ ] The issue of EIP4844 (blob) support
- [ ] Launching your own L2
- [x] [Launching your own L2 with Presto](https://blog.jarrodwatts.com/build-your-own-layer-2-blockchain-using-polygon-cdk)
- [x] [Quick and dirty DAC integration with your chain](https://docs.polygon.technology/cdk/how-to/integrate-da/)
- [ ] L2 + setting up a whitelisted DAC
- [ ] L2 + setting up an open and incentive-driven DAC
- [ ] Going bare metal
- [ ] Launching each part of the Kurtosis CDK separately
- [ ] …
- [ ] …
### 🏆 Buildooors
- [ ] Shipper directory
- [ ] Shipper A case study
- [ ] Shipper B case study
- [ ] …
---
## Community
Join the community in the [R&D Discord](https://discord.gg/0xpolygonrnd), or
[Meet the DevRel](https://polygon.technology/community/meet-the-devrel).
To further explore Polygon's educational content, see the
[YouTube channel](https://www.youtube.com/@0xPolygonTV) and the
[Polygon blog](https://polygon.technology/blog).
Long-form persisted discussions happen in the
[Developer Forum](https://forum.polygon.technology/c/developers/25).
### Repo translations
Please [get in touch](https://polygon.technology/community/meet-the-devrel) if
you want to help translate this into other languages.
- [x] English
- [ ] Chinese
- [ ] Thai
- [ ] Croatian/Serbian
- [ ] Klingon
## Contributing
The process below will help you run the docs locally.
### Prerequisites
1. [Python 3.12](https://www.python.org/downloads/).
2. Install [`virtualenv`](https://pypi.org/project/virtualenv/):
```sh
pip3 install virtualenv
```
### Setup
1. Clone the repository to your local machine.
2. Navigate to the root directory of the cloned repository:
```sh
cd devrel-docs
```
3. Ensure the `serve_docs.sh` script is executable by running:
```sh
chmod +x serve-docs.sh
```
4. To serve the documentation, run the following command:
```sh
./serve_docs.sh
```
5. Once the script executes, the documentation site will be available at:
.
If it runs and renders well here, it will render correctly on the Knowledge
Layer. If there are any unfixed errors breaking the local build, it will
probably break on import to the Knowledge Layer.
## Commands
- `mkdocs new [dir-name]` - Create a new project.
- `mkdocs serve` - Start the live-reloading docs server.
- `mkdocs build` - Build the documentation site.
- `mkdocs -h` - Print help message and exit.
### Linting
This repo offers a linting script at `./prettier.sh` which you can run if you
have Prettier installed. The `.prettierrc` file configures Prettier and should
work with most modern IDEs and build processes.
Main rules:
- use 2 spaces for indentation
- use 80 characters for line length
## Style guide
[Vale](https://vale.sh/) enforces a consistent style throughout the repository.
To install Vale, run the following command:
```sh
brew install vale
```
To run Vale, use the following command:
```sh
vale [file]
```
Since Vale is very opinionated, you may want to run it file by file, not
globally. As you write a document, run Vale on just that file to not get
overwhelmed.
e.g.
```sh
vale README.md
```
Vale will check the file for any violations of the style guide and print them to
the console. It enforces Microsoft's style guide and a WriteGood style guide.
You *must* fix errors, and you *may* fix warnings and suggestions.