Written by
Fuma Nama
At
Thu May 16 2024
500颗星
Fumadocs 的前 500 颗星
当我第一次看到Web Dev Cody 的视频时,我感到很惊讶,感觉自己终于做出了值得一提的东西,而不是又一个无人关心的被忽视的副项目。
🌐 It was surprising when I first saw the video from Web Dev Cody, it felt like I had finally built something worth mentioning, instead of another neglected side project that nobody cares about.
到目前为止,我在这个项目上工作了大约一年,这对我来说是一次宝贵的经历。这是你在大学里找不到的最佳讲座。
🌐 So far I've worked on this project for about 1 year, and it is a precious experience to me. The best lecture that you can't find in a university.
开源
🌐 Open Source
我收到了很多反馈、问题和疑问。有些反馈直接且尖锐,比如“请修复它,求你了”“请支持XXX”。有些则很友善且有帮助,愿意提供PR。我感受到了开源的好与坏两面。
🌐 I received much feedback, issues and questions. Some are brutal but straightforward, like "please fix it, help me please" "Support XXX please". Some are kind and helpful, willing to provide a PR. I felt both the good and bad sides of open source.
有时,人们因为压力而变得急切和冲动,可能会将他们的沮丧转嫁到库维护者身上。即使是我自己,也可能受到压力或坏情绪的影响。
🌐 Sometimes, people are being eager and impulsive because of stress and may spread their frustration on the library maintainers. Even myself, can be affected by stress or a bad mood.
人们可能希望立即得到答案,而维护者将面临像“你为什么要逃避我的问题?”这样的质问。我理解一个库表现不佳会浪费你宝贵的时间,但即使我们投入所有努力去维护这个库,它也不可能完美无缺。
🌐 People may hope for instant answers, and maintainers will face questions like "Why are you running away from my questions?". I understand a library performing bad can cause your precious time to be wasted, but even if we put all our efforts in maintaining the library, it can't be flawless.
从那以后,我感觉自己对开源项目的维护者更加尊重了。至少,在我在别人的 Github 仓库提 issue 之前,我会先检查自己,并尽量用我有限的语言能力表现出应有的尊重。
🌐 Since then, I feel I'm way more respectful to open-source project maintainers.
At least, I'll check my before before firing an issue on somebody else's Github repository, and try to be as respectful as I can with my poor language skills.
问题
🌐 Issues
我最喜欢的开发者是 Anthony Shew,我提到他是因为 他提出的问题 是我在开源生涯中见过的最好的问题。他真的关心我对 API 设计的愿景和意见,并给出了一个非常简明且建设性的功能请求。
🌐 My favourite dev was Anthony Shew, I mentioned him because the issue he opened is the best I've ever seen in my open-source career. He actually cared about my vision and opinion about the API design, and gave a really concise and constructive feature request.
显然,我既不完美,也不是一个有经验的库开发者。Fumadocs 无法做到很多事情,但像这样得到清晰解释的功能请求和想法是非常有力的。他的热情令人鼓舞。
🌐 Obviously, I was not a perfect, neither an experienced library dev. Fumadocs wasn't capable of many things, such a well-explained feature request and idea is powerful. His passion is inspiring.
在设置 YAML 问题模板之前,实际按照问题模板提交的问题非常少,大多数甚至没有提供可复现的仓库或解释。
🌐 Before setting up the YAML issue template, there were very few issues that actually followed the issue template, most of them don't even provide a reproducible repository, or an explanation.
提出一个正式的问题,按照说明操作,并给予维护者一些积极的反馈。 这是你在不花钱的情况下,能给予维护者的最大动力。
文档
🌐 Docs
在 fumadocs 上编写文档很有趣。在最初构建它的时候,我在撰写文档和教程内容方面几乎没有经验。通过阅读开发者的反馈,最常见的问题是他们找不到某些内容的文档。
🌐 It's fun to work on the docs of fumadocs. When first building it, I had very little experience on authoring documentation and tutorial content. Reading through the feedback from developers, the most common problem is that they can't find the docs of something.
我意识到整个文档对于初学者来说不太友好,我的朋友们是资深的 Next.js 开发者,当然他们没问题。不过,并不是每个开发者都能理解这些文档。
🌐 I realized the entire docs is unfriendly for beginners to start with, my friends are senior Next.js devs, and of course they are fine with that. However, not every dev can understand the docs.
所以最近,我开始重写其中的一些部分,使其对初学者更容易理解和更有吸引力。欢迎在 Github 讨论区分享你的反馈!
🌐 So recently, I started to re-write some of the sections, making it easier and appealing for beginners. Welcome to share your feedback on Github Discussions!
下一步是什么?
🌐 What is Next?
网页开发是一个不断发展的行业,但我相信开源精神不会消失。 我不知道将来我会开发什么,但那并不重要。 让我们一起建设一个更好的网络吧!
🌐 Web Development is an ever-evolving industry, but I believe the spirit of open source won't disappear. I don't know what I will be building in the future, and that doesn't matter. Let's build a better web!