DEV Community

Cover image for Nextra: 10 Minute Docs Audit
DocumentWrite
DocumentWrite

Posted on

Nextra: 10 Minute Docs Audit

Nextra is Next.js's site generator. It comes with mdx functionality out of the box, and has server capabilities(just like Next.js). Developers can use Nextra to create websites and documentation portals.

I run a technical documentation business specializing in writing and editing documentation. I made this series to share my insights and help projects craft impactful documentation.

What's The Criteria?
3- Excellent
2 - OK
1 - Poor

Purposeful: Does the QuickStart explain what problem it's trying to solve? Who is the intended audience?

UX Experience: How seamless is the experience? Must the user create an account to get through the Quickstart? Does the Quickstart elicit a sense of joy and achievement?

Accurate: Are the instructions correct? Are they complete?

The Results

Not going to lie. Wanted to LOVE Nextra. The first two minutes started off as a lovefest for Nextra. The landing page discussed the benefits of Nextra for the developer and the content writer. Nice.

However, the trouble started when I tried to run Nextra locally on my computer. I downloaded all the dependencies and got this weird error Error: spawn ENOENT. Tried to remedy it but failed.

I had high hopes for Nextra, but not getting a sample app running on my computer was a big letdown and a poor and frustrating experience.

Score
Purposeful 3
UX Experience 1.5
Accurate 1

Are you interested in a FREE Quickstart audit for your company? Start here.

Top comments (1)

Collapse
 
Sloan, the sloth mascot
Comment deleted