4 Star 47 Fork 14

WeHarmony / weharmonyos.com

Create your Gitee Account
Explore and code with more than 8 million developers,Free private repositories !:)
Sign up
Clone or Download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
README.md

颜渊死,门人欲厚葬之,子曰:“不可。”门人厚葬之。子曰:“回也视予犹父也,予不得视犹子也。非我也,夫二三子也。” 《论语》:先进篇

百篇博客分析.本篇为: (静态站点篇) | 码农都不爱写注释和文档

前因后果相关篇为:

一键部署

直接下载或clone本项目到web服务器指定目录即可.

git clone https://gitee.com/weharmony/weharmony.git

码农都不爱写注释和文档

程序员都不愿意代码写注释和文档,自己也是一路这么过来的,面对海量代码却没有文档,痛苦不堪,追问文档往往换来一句 "代码就是最好的文档",读源百遍,其意自现.这是一句正确的废话,背后得烧掉了多少时间.等一番寒彻苦,搞懂了之后同样也是不愿写文档,没时间没必要,用同样的话去回应新人对文档要求,何其相似.

点赞鸿蒙的文档

2020/9/10 鸿蒙正式开源后自己用业余时间对鸿蒙内核源码项目kernel_liteos_a_note进行中文注解,高频的接触官方文档,看网上有不少喷官方文档的,往往以偏概全,发现个错误就放大,须知鸿蒙生态何其庞大,有失误和错漏很正常,坦白说鸿蒙文档做的挺不错的,点赞,内容更新也很频繁,因 weharmonyos.com 每周都会同步官方文档,所以很清楚每次都有大的调整,希望多用欣赏的眼光来看鸿蒙,换位思考 u can u up , 你来未必能做的比现在好. 不要手里拿个锤子看什么都像钉子,干就完了.

为什么会有 weharmonyos.com

  • 在给鸿蒙内核加注和写博客期间需要不断的查找资料,觉得官方目前资料展示方式并不能满足自己的需求,浪费了很多宝贵的时间,所以在想能不能将官方文档(md格式)做个静态站点出来,即方便别人更方便自己,这是一劳永逸,利己利他的事干嘛不做的,刚好五一有成块的时间,本来也想出去走走,结果哪都没去,期间遇到不少问题,但基本都解决了,

  • 目前保持每周一次的频率同步官方文档,也想过做成实时更新,但难度很大,因官方文档还不能直接生成静态页面,编译通不过,需要手动去核对和修改.另外导航栏和侧边栏在官方文档的基础上做了索引优化和结构调整,但内容没有做任何的更改,放心使用.

  • 鸿蒙研究站的另外一部分是对百篇博客的实时输出,百篇博客内容在其他主流技术站点也有输出,但因各平台的规则不同,更新会较慢,weharmonyos.com上的内容是最新的.其它平台输出如下,感谢这些平台一直以来的支持:

  • 这里必须要感谢下这套主题的作者 Mr.hope ,人非常的nice, 一直帮着解决问题.再次感谢!!! 主题地址:vuepress-theme-hope 有兴趣的可以去了解下,一个功能强大的 vuepress 主题.

还要啥自行车啊, 赶紧去体验weharmonyos.com吧!

关注不迷路.代码即人生

Repository Comments ( 0 )

Sign in to post a comment

About

百图画鸿蒙 | 百文说内核 |百万注源码 的内容输出站点,鸿蒙官方文档静态站点,汇集众多的学习资料。鸿蒙研究站定位做一个专注而靠谱的技术站,没有广告,永远简洁,落落大方,一步部署到web服务器。 expand collapse
HTML
MulanPSL-2.0
Cancel

Releases

No release

weharmonyos.com

Contributors

All

Activities

Load More
can not load any more
HTML
1
https://git.oschina.net/weharmony/weharmony.git
git@git.oschina.net:weharmony/weharmony.git
weharmony
weharmony
weharmonyos.com
master

Search

103111 552b83b3 1850385 103110 ed87a847 1850385