The new Optimism documentation
•
We're excited to announce that the Optimism documentation has undergone a complete transformation!
Why we made the switch
As the Optimism ecosystem continues to grow rapidly, with thousands of developers building on the Superchain, our documentation needed to evolve to match the sophistication of what you're building. We recognized that our community deserved something more powerful, more interactive, and more aligned with modern developer expectations. Developers need better search, interactive examples, and easier feedback tools- features that Mintlify makes native.
The numbers speak for themselves: Our documentation receives over 50,000 monthly visits from developers worldwide, and we wanted to ensure every single interaction was as smooth and productive as possible.
What's new: features that will change how you build
AI-Powered documentation assistant
Say goodbye to endless scrolling through docs. Our new AI chat assistant is trained on the entire Optimism documentation and can answer complex questions about:
OP Stack architecture and components
Smart contract deployment strategies
Cross-chain messaging patterns
Troubleshooting common issues
Try asking:
“How do I deploy a custom L2 using op-deployer?”
and get an instant, tailored walkthrough
Lightning-fast search with context
Our enhanced search doesn't just find keywords, it understands intent. Whether you're looking for:
Configuration examples
Tutorial steps
Contract addresses
The new search delivers contextual results in milliseconds, with smart highlighting and relevant code snippets.
Mobile-first design
Built for developers on the go. Whether you're debugging on your phone during a hackathon or reviewing docs on your tablet, the new responsive design ensures a perfect experience across all devices.
Enhanced code examples
Every code snippet now includes:
One-click copy functionality
Multiple language examples (Solidity, JavaScript, Python, Go)
Context-aware suggestions based on your current page
Direct feedback buttons to report issues or suggest improvements
Instant issue reporting & feedback
This is a game-changer for documentation quality. Now you can:
Report issues directly from any documentation page with a single click
Flag incorrect code snippets and suggest corrections inline
Leave actionable feedback on specific sections or examples
Track resolution status of your reported issues
Contribute improvements without needing to navigate to GitHub
Every page now has contextual feedback options that help us maintain accuracy and relevance across our entire documentation suite.
AI-powered content actions
Take your documentation experience to the next level with built-in AI integrations:
Suggest an edit using AI assistance for any section
Copy entire pages or sections directly to ChatGPT for further analysis
Send content to Claude for detailed explanations
Export full pages with one click for offline reference or team sharing
Try it today
The new documentation is live at docs.optimism.io with all your favorite content, now supercharged with Mintlify's powerful features.
Getting started recommendations:
Try the new search – Search for anything you’ve looked for before and notice the difference
Chat with our AI assistant – Ask complex questions about the OP Stack
Report an issue – Find a typo or outdated code? Report it directly from the page and help us improve
We want your feedback
This migration represents our commitment to providing world-class developer resources, but we know there’s always room for improvement.
Share your experience:
Join the conversation in Optimism Discord
Send feedback directly to our docs team
Tweet us @OptimismFND
Ready to build?
The future of Optimism development starts with great documentation.
Whether you're deploying your first smart contract, spinning up a new L2, or building the next generation of decentralized applications, our new docs are here to support you every step of the way.
Start exploring: docs.optimism.io