新的 Supabase 文档,基于 Next.js 构建

新的 Supabase 文档,基于 Next.js 构建

💡 原文英文,约1000词,阅读约需4分钟。
📝

内容提要

Supabase最近更新了文档,采用Next.js构建,解决了维护问题。新文档提供更好的导航和参考资料,所有功能集中在一页上,提升了可发现性。未来计划包括统一认证、互动教程和改进搜索功能,以提高开发者的使用效率。

🔎

延伸解读

从 Docusaurus 迁移到 Next.js 的动因

Supabase 文档原先基于 Docusaurus,但随着客户端库版本增多,维护复杂度上升,且与团队使用的 Next.js 和 Turborepo 技术栈不一致,导致贡献者难以参与。迁移到 Next.js 后,文档站点得以复用内部 UI 库和配置,统一了前端技术栈,解决了长期维护难题。

新文档如何提升可发现性

针对文档内容庞大导致的迷失问题,新文档将所有功能整合到单一侧边栏,让读者一眼就能看到 Supabase 提供的全部能力,无需层层点击。参考文档也改为每个库的所有函数集中在一页,方便开发者使用浏览器查找或搜索,降低了查找成本。

未来规划:更集成、更互动的文档体验

Supabase 计划实现统一认证,让登录 Dashboard 的用户自动登录文档,从而提供个性化内容和项目专属的代码片段,避免占位符。此外,还将探索可运行代码块、互动教程以及基于 Postgres 全文搜索的改进搜索功能,旨在让开发者更高效地使用文档。

❓

Q&A

Supabase的新文档有什么主要改进?

Supabase的新文档采用Next.js构建,提供了更好的导航和参考资料,所有功能集中在一页上,提升了可发现性。

为什么Supabase选择使用Next.js构建文档?

Supabase选择Next.js是为了提高维护性,解决之前Docusaurus带来的复杂性问题,并统一前端技术栈。

新文档的导航设计有什么特点?

新文档的导航设计采用了单一侧边栏布局,使用户可以一目了然地看到所有功能,避免了深层次的内容迷宫。

未来Supabase文档有哪些计划?

未来计划包括统一认证、互动教程和改进搜索功能,以提高开发者的使用效率。

新文档如何提升开发者的使用效率?

新文档通过集中所有函数在一页、改进搜索功能和提供个性化内容来提升开发者的使用效率。

Supabase文档的设计改进包括哪些方面?

设计改进包括新的UI组件、信息呈现的细致度提升,以及更好的参考文档布局。

🏷️

标签

➡️

继续阅读