Xiaobo, Pls. convert all your articles into markdown format first, and share us your repository on GitHub.
Thanks, -Ian. On Thu, Dec 6, 2018 at 2:02 PM Ian Luo <[email protected]> wrote: > Xiaobo, > > I think this is a good proposal. Pls. create a new section 'source code > guide' under docs, and let's build it together. > > Thanks, > -Ian. > > > On Wed, Dec 5, 2018 at 8:57 PM 田 小波 <[email protected]> wrote: > >> Hi community, >> >> I noticed that people in the WeChat group said that Dubbo's comments are >> too few and unfriendly to beginners. I just wrote some source analysis >> articles about Dubbo in the past. I have a lot of comments and analysis on >> the Dubbo source in the article. I think these articles can help beginners >> learn Dubbo. The list of articles is as follows: >> >> 时间 文章 >> 2018-10-01 Dubbo 源码分析 - SPI 机制< >> https://www.cnblogs.com/nullllun/p/9758682.html> >> 2018-10-13 Dubbo 源码分析 - 自适应拓展原理< >> https://www.cnblogs.com/nullllun/p/9788319.html> >> 2018-10-31 Dubbo 源码分析 - 服务导出< >> https://www.cnblogs.com/nullllun/p/9887190.html> >> 2018-11-12 Dubbo 源码分析 - 服务引用< >> https://www.cnblogs.com/nullllun/p/9950361.html> >> 2018-11-17 Dubbo 源码分析 - 集群容错之 Directory< >> https://www.cnblogs.com/nullllun/p/9980247.html> >> 2018-11-20 Dubbo 源码分析 - 集群容错之 Router< >> https://www.cnblogs.com/nullllun/p/9991413.html> >> 2018-11-24 Dubbo 源码分析 - 集群容错之 Cluster< >> https://www.cnblogs.com/nullllun/p/10018429.html> >> 2018-11-29 Dubbo 源码分析 - 集群容错之 LoadBalance< >> https://www.cnblogs.com/nullllun/p/10041964.html> >> 未完成 Dubbo 源码分析 - 并发模型<https://www.cnblogs.com/nullllun/> >> 未完成 Dubbo 源码分析 - 编解码<https://www.cnblogs.com/nullllun/> >> >> If you are interested, you can review it. If you feel good, I can submit >> these articles to dubbo-website. If you feel that writing is not good, you >> are welcome to give some advice. >> >> 我注意到有人在微信群里说 Dubbo 的注释太少，对初学者不友好。我正好在过去一段时间内写了一些关于 Dubbo 的源码分析文章，我在文章中对 >> Dubbo 源码进行了大量的注释和分析，我觉得这些文章可以帮助初学者学习 Dubbo。大家如果有兴趣，可以进行 >> review。如果觉得还不错，我可以将这些文章提交给 dubbo-website。如果觉得写的不好，也欢迎多多指教。 >> >> Regards >> Xiaobo >> >> 在 2018年12月5日，下午1:56，Ian Luo <[email protected]> 写道： >> >> What I suggest is to revisit and enhance the existing javadoc/comments >> before consider to add more: >> 1. Enhance JavaDoc for all API. For this part, we may need some helps from >> native speakers >> 2. Revisit the current existing comments, and make it easier to understand >> >> Just my two cents, >> -Ian. >> >> On Tue, Dec 4, 2018 at 5:10 PM yuhang xiu <[email protected]> wrote: >> >> Recently dubbo held an offline meetup. When discussing with many >> participants, many people have suggested that dubbo has very few comments. >> >> Comments are very important for us to understand the code. If our comments >> are few, it is very unfriendly for new developers. >> >> I created a new issue[1] to track this. We need more developers to >> contribute notes. I will continue to follow up on this matter. >> >> [1] https://github.com/apache/incubator-dubbo/issues/2884 >> >> >>
