本帖最后由 u96 于 2021-6-3 16:22 编辑
燕山雪 发表于 2021-6-3 15:30
主要原因大概是非码农多半看不明白主贴槽点在哪
风怒。
u96 发表于 2021-6-3 16:21
我不信这楼里全是码农。
好好好知道你不信了
不说别的，华为在源码安全这块算是最上心了，无论是招博士搞方法，还是找各种地方合作，舍得给钱，还愿意让你探索新技术。
你打开的姿势不对...
top层README.md 进去才是正常的索引
你不从索引进去，直接看文件列表...就是这个效果
举个gcc的例子，随便进去一页
看索引页
Nanachi 发表于 2021-6-3 15:47
就在git里通过md格式管理文档，太糙了，而且这样没全文搜索功能吧。
虽说我整的s1帖子存档repo也是 ...
gitee 自带全文搜索阿
github也有的
本帖最后由 phorcys02 于 2021-6-3 16:50 编辑
燕山雪 发表于 2021-6-3 15:30
主要原因大概是非码农多半看不明白主贴槽点在哪
在下20年码农。。。觉得槽点是你自己...
开源项目靠目录做索引，不就是因为懒得维护 目录页和索引页么
菊花人目录索引页不是做的挺好，无非就是没有“上一级和下一级”的链接，这文档也是开源项目，你可以可以提pull request么这也是小问题
反而不懂你这样仿佛 抓到了什么大痛脚一样，无法理解
jpcl 发表于 2021-6-3 15:56
linux不是微内核吧？
鸿蒙实际上是一块牌子两套班子，文宣刻意把两者混为一谈而已。Linux部分就是魔改ASOP，这个是闭源的，手机平板上跑的都是这个版本。微内核用于IOT，没法兼容现有安卓应用，跟昨晚吹的那些花哨玩意基本也没啥关系。
微内核代码好像是开源了，没细看，不过微内核部分的文档写的也很个性，API只列个函数名，参数列表都不全的那种……
phorcys02 发表于 2021-6-3 16:48
在下20年码农。。。觉得槽点是你自己...
开源项目靠目录做索引，不就是因为懒得维护 目录页和索引页么
对对对你说的都对，又不是不能用，什么gitbook什么doxygen都是歪门斜道，谁学谁傻逼
燕山雪 发表于 2021-6-3 16:59
对对对你说的都对，又不是不能用，什么gitbook什么doxygen都是歪门斜道，谁学谁傻逼 ...
so what
没用gitbook就是垃圾？
msdn好用还是 doxygen生成的没人看文档好用？
phorcys02 发表于 2021-6-3 16:46
gitee 自带全文搜索阿
github也有的
对，我今天才发现左上角搜索默认是全文搜索的。这下就不用折腾什么gitbook什么wiki了
phorcys02 发表于 2021-6-3 17:04
so what
没用gitbook就是垃圾？
没权限加鹅，虽然我是华为死黑，但是不得不承认你说的没错。
燕山雪 发表于 2021-6-3 16:59
对对对你说的都对，又不是不能用，什么gitbook什么doxygen都是歪门斜道，谁学谁傻逼 ...
不懂就问，不是正经码农，没怎么接触过大的项目
就我仅有的一点经验知道doxygen是基于注释生成程序里代码说明、继承关系之类的工具。这个看起来和文档里的系统说明之类的不怎么符合
Gitbook也没用过，看起来大概是一个组织Markdown文档的工具，实现结果相比现在这个从Readme进去的目录有什么优势？
lazyboy 发表于 2021-6-3 17:18
不懂就问，不是正经码农，没怎么接触过大的项目
就我仅有的一点经验知道doxygen是基于注释生成程序里代码 ...
以RT-Thread为例，这个是readme进去的 https://gitee.com/rtthread/docs-online/tree/master/rt-thread-version/rt-thread-standard这个是生成的网页 https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/README 应该能肉眼看出不同
可码农不看你干了几年啊
大佬们可以晒出自己的github来互怼啊
ohi 发表于 2021-6-3 17:42
只支持js? 合着这个OS就是个浏览器？
—— 来自 S1Fun
不是只支持JS
菊花做了个叫ACE的东西，类似用JS的flutter
以后界面就用它来写
—— 来自 Xiaomi Mi 10, Android 11上的 S1Next-鹅版 v2.4.3
lazyboy 发表于 2021-6-3 17:18
不懂就问，不是正经码农，没怎么接触过大的项目
就我仅有的一点经验知道doxygen是基于注释生成程序里代码 ...
doxygen的例子可以看opencv，支持索引，分类，跳转，检索等等。gitbook可以参考这个，编辑方便格式清爽，目录、prev、next这些“不重要”的功能都是自动生成的，几乎不需要工作量。总之现代开发者写文档不借助工具的已经很少了，可能华为码农都还停留在msdn年代吧……
fukc 发表于 2021-6-3 17:11
所以谷歌究竟是怎么看待这个事情的？是认为“该行为长线看会导致安卓阵营分裂和脱离自己掌控 ”还是“战五 ...
gms支持鸿蒙吗？
升职加薪 发表于 2021-6-3 19:14
或者更通俗的例子
GVIM是非常古老的编辑器
原生的GVIM简陋不堪
果然非码农看不懂主楼的槽点……这么说吧，所谓工具，影响的是服务态度好不好摆盘是否漂亮，而那堆文档的主要问题是他端上来的是一坨shit……
升职加薪 发表于 2021-6-3 19:14
或者更通俗的例子
GVIM是非常古老的编辑器
原生的GVIM简陋不堪
另外非码农不要说vim简陋不堪这种话，容易引仇恨或者说被鄙视……
红都剧院24排4号 发表于 2021-6-3 11:39
魅族用鸿蒙，是不是可以看成乔布斯回归苹果时认微软做大哥
魅族当年被谷歌高通都整过
肯定劈腿的啊
233
咋没见楼主一一纠正按照自己错误理解(被刻意引导)的方向兴高采烈的人呀。一口一个你不懂，却没管黑错方向的人嗷。
燕山雪 发表于 2021-6-3 19:35
另外非码农不要说vim简陋不堪这种话，容易引仇恨或者说被鄙视……
有的IC前端 vnc + gvim 开多个窗口写代码的方式，你见过就知道了，槽点真的很多，只会hjkl dd y wq，连vimrc都没动过，我见过好几个，有追求早就换换 ssh + tmux + vim 一套了 =。=
ryanz 发表于 2021-6-3 19:40
有的IC前端 vnc + gvim 开多个窗口写代码的方式，你见过就知道了，槽点真的很多，只会hjkl dd y wq，连vi ...
所以vscode支持ssh简直功德无量啊2333，拯救太多vim苦手了（包括我_(:3 ⌒ﾞ)_）
所以看下来就是楼主兴高采烈的怼了两页 让后被行内人怼翻车了
—— 来自 HUAWEI ELS-AN10, Android 10上的 S1Next-鹅版 v2.4.4.1
u96 发表于 2021-6-3 15:15
泥潭也开始同温层了，这个贴跟鸿蒙那贴见到的id都不怎么重合。
关注重点也不一样吧，我一开始点进来是想看技术上哪拉垮了，结果一看是文档，都没啥想回复的，甚至不知道前排在高潮啥
纯外行，楼主为什么不回复#45呀
这帖子看完不是和nga一个尿性么
楼主只挑能回复的回复字里行间透露着你不懂
233比尼姑庵还恶臭
stillwmxz 发表于 2021-6-3 22:21
纯外行，楼主为什么不回复#45呀
因为55楼的回复已经指出差异了，可能是你看不出来吧。
你们不用总强调自己是外行，多说几句我们能看出来。
另外这个帖子已经偏了，楼主说这个文档有两个问题
1是存在大量莫名其妙的内容，比如买本书学炒鸡蛋，给你讲20页鸡蛋的构成与来历凑页数，这是主要问题。
2是文档组织形式不够与时俱进，这个其实无所谓，表面功夫嘛。
现在话题完全被搅到2上去了，楼主已经输了。
phorcys02 发表于 2021-6-3 16:46
gitee 自带全文搜索阿
github也有的
咦，怎么全文搜索，我之前试了一下只搜出一堆名字里带关键词的仓库
device-dev不就是硬件开发，工程师可能上一个项目用的还是gd32
所谓的双标现场呗
YoumuChan 发表于 2021-6-4 00:10
咦，怎么全文搜索，我之前试了一下只搜出一堆名字里带关键词的仓库
要点进 repo，点进 repo 之后左上角默认是当前 repo 的全文