Restructure network documentation for Ethereum L2 migration#127
Merged
kingsleydon merged 4 commits intomainfrom Nov 21, 2025
Merged
Restructure network documentation for Ethereum L2 migration#127kingsleydon merged 4 commits intomainfrom
kingsleydon merged 4 commits intomainfrom
Conversation
This commit updates the network documentation structure to reflect the migration from Phala Parachain to Ethereum L2 with GPU-based compute providers.
## Changes:
### Navigation Structure
- Added new `/network/overview/` section with key pages:
- phala-network: Core network overview
- phala-staking: Staking information for the new L2
- phala-governance: Governance mechanisms
- phala-treasury: Treasury details
- get-pha-and-transfer: Token acquisition guide
- block-explorers: Explorer resources
### Compute Providers
- Simplified structure focusing on GPU compute:
- Added `introduction.mdx`: Comprehensive guide on GPU mining, tokenomics, vPHA, and reward mechanisms
- Added `run-GPU-on-phala/`: New directory for GPU deployment
- `gpu-deployment-guide.mdx`: Step-by-step GPU deployment instructions
- `register-work-onchain.mdx`: On-chain registration guide
### Removed Legacy Content
- Removed old parachain-specific documentation:
- basic-info/ (8 files)
- gatekeeper/ (2 files)
- run-workers-on-phala/ (7 files)
- tech-specs/blockchain/ (4 files)
- references/ subdirectories (26 files)
### Redirects
- Added 45 new redirect rules to ensure seamless user experience:
- Old compute-provider pages → new GPU deployment guides
- Old reference pages → network index or corresponding new pages
- Special redirects for block-explorers and token transfer guides
### Legacy Documentation
- Preserved old parachain documentation under "Legacy Parachain Documentation" group for reference
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Adjusted the order of pages in the Overview section to match the specified numbering: - 2.1: phala-network - 2.2: get-pha-and-transfer - 2.3: block-explorers - 2.4: phala-staking - 2.5: phala-treasury - 2.6: phala-governance 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
Updated 82 redirect rules to point to valid destinations: - Old archived-projects, references, tech-specs pages → /network/index - Old compute-provider pages → /network/compute-providers/introduction or GPU guides - Old basic-guidance pages → /network/overview/get-pha-and-transfer - Old khala worker pages → /network/compute-providers/run-GPU-on-phala/gpu-deployment-guide This fixes all validation errors where redirects were pointing to non-existent pages. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
Added redirect from /network/compute-providers/gatekeeper to /network/compute-providers/introduction to fix the uncovered link warning. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR restructures the network documentation to reflect Phala Network's migration from Parachain to Ethereum L2 with GPU-based compute providers.
Key Changes
📁 New Documentation Structure
Overview Section (
/network/overview/):Compute Providers (
/network/compute-providers/):🗑️ Removed Legacy Content
🔄 Redirects (129 rules updated)
All removed pages now redirect to appropriate new locations:
Redirect destinations:
/network/indexor corresponding new sections/network/overview/get-pha-and-transfer/network/compute-providers/introduction📚 Legacy Documentation Preserved
Old parachain documentation remains accessible under "Legacy Parachain Documentation" group for historical reference.
Impact
Navigation Structure
Testing Checklist
Commits
2c3c980- Restructure network documentation for Ethereum L2 migration6bd6426- Reorder navigation structure based on numbering scheme2002944- Fix invalid redirects to point to existing pages (82 fixes)fceb2b1- Add redirect for uncovered gatekeeper link🤖 Generated with Claude Code