鸿蒙的文档真是太有趣了

u96 · 发表于 2021-6-3 16:21

本帖最后由 u96 于 2021-6-3 16:22 编辑

燕山雪发表于 2021-6-3 15:30
主要原因大概是非码农多半看不明白主贴槽点在哪

风怒。

Nanachi · 发表于 2021-6-3 16:21

u96 发表于 2021-6-3 16:21
我不信这楼里全是码农。

好好好知道你不信了

Van夫膜开 · 发表于 2021-6-3 16:27

不说别的，华为在源码安全这块算是最上心了，无论是招博士搞方法，还是找各种地方合作，舍得给钱，还愿意让你探索新技术。

台球论坛网友 · 发表于 2021-6-3 16:37

提示: 作者被禁止或删除内容自动屏蔽

phorcys02 · 发表于 2021-6-3 16:45

你打开的姿势不对...

top层README.md 进去才是正常的索引

你不从索引进去，直接看文件列表...就是这个效果
QQ截图20210603164024.png

举个gcc的例子，随便进去一页
QQ截图20210603164420.png

看索引页

phorcys02 · 发表于 2021-6-3 16:46

Nanachi 发表于 2021-6-3 15:47
就在git里通过md格式管理文档，太糙了，而且这样没全文搜索功能吧。

虽说我整的s1帖子存档repo也是 ...

gitee 自带全文搜索阿
github也有的

phorcys02 · 发表于 2021-6-3 16:48

本帖最后由 phorcys02 于 2021-6-3 16:50 编辑

燕山雪发表于 2021-6-3 15:30
主要原因大概是非码农多半看不明白主贴槽点在哪

在下20年码农。。。觉得槽点是你自己...

开源项目靠目录做索引，不就是因为懒得维护目录页和索引页么

菊花人目录索引页不是做的挺好，无非就是没有“上一级和下一级”的链接，这文档也是开源项目，你可以可以提pull request么这也是小问题

反而不懂你这样仿佛抓到了什么大痛脚一样，无法理解

燕山雪 · 发表于 2021-6-3 16:56

jpcl 发表于 2021-6-3 15:56
linux不是微内核吧？

鸿蒙实际上是一块牌子两套班子，文宣刻意把两者混为一谈而已。Linux部分就是魔改ASOP，这个是闭源的，手机平板上跑的都是这个版本。微内核用于IOT，没法兼容现有安卓应用，跟昨晚吹的那些花哨玩意基本也没啥关系。

微内核代码好像是开源了，没细看，不过微内核部分的文档写的也很个性，API只列个函数名，参数列表都不全的那种……

燕山雪 · 发表于 2021-6-3 16:59

phorcys02 发表于 2021-6-3 16:48
在下20年码农。。。觉得槽点是你自己...

开源项目靠目录做索引，不就是因为懒得维护目录页和索引页么

对对对你说的都对，又不是不能用，什么gitbook什么doxygen都是歪门斜道，谁学谁傻逼

phorcys02 · 发表于 2021-6-3 17:04

燕山雪发表于 2021-6-3 16:59
对对对你说的都对，又不是不能用，什么gitbook什么doxygen都是歪门斜道，谁学谁傻逼 ...

so what

没用gitbook就是垃圾？
msdn好用还是 doxygen生成的没人看文档好用？

fukc · 发表于 2021-6-3 17:11

提示: 作者被禁止或删除内容自动屏蔽

Nanachi · 发表于 2021-6-3 17:12

phorcys02 发表于 2021-6-3 16:46
gitee 自带全文搜索阿
github也有的

对，我今天才发现左上角搜索默认是全文搜索的。这下就不用折腾什么gitbook什么wiki了

Damenly · 发表于 2021-6-3 17:16

phorcys02 发表于 2021-6-3 17:04
so what

没用gitbook就是垃圾？

没权限加鹅，虽然我是华为死黑，但是不得不承认你说的没错。

lazyboy · 发表于 2021-6-3 17:18

燕山雪发表于 2021-6-3 16:59
对对对你说的都对，又不是不能用，什么gitbook什么doxygen都是歪门斜道，谁学谁傻逼 ...

不懂就问，不是正经码农，没怎么接触过大的项目
就我仅有的一点经验知道doxygen是基于注释生成程序里代码说明、继承关系之类的工具。这个看起来和文档里的系统说明之类的不怎么符合
Gitbook也没用过，看起来大概是一个组织Markdown文档的工具，实现结果相比现在这个从Readme进去的目录有什么优势？

ryanz · 发表于 2021-6-3 17:26

lazyboy 发表于 2021-6-3 17:18
不懂就问，不是正经码农，没怎么接触过大的项目
就我仅有的一点经验知道doxygen是基于注释生成程序里代码 ...

以RT-Thread为例，这个是readme进去的 https://gitee.com/rtthread/docs- ... /rt-thread-standard 这个是生成的网页 https://www.rt-thread.org/docume ... ead-standard/README 应该能肉眼看出不同

自旋 · 发表于 2021-6-3 17:37

提示: 作者被禁止或删除内容自动屏蔽

peh · 发表于 2021-6-3 17:37

可码农不看你干了几年啊
大佬们可以晒出自己的github来互怼啊

ohi · 发表于 2021-6-3 17:42

提示: 作者被禁止或删除内容自动屏蔽

d2loader · 发表于 2021-6-3 18:54

ohi 发表于 2021-6-3 17:42
只支持js? 合着这个OS就是个浏览器？

—— 来自 S1Fun

不是只支持JS

菊花做了个叫ACE的东西，类似用JS的flutter

以后界面就用它来写

—— 来自 Xiaomi Mi 10, Android 11上的 S1Next-鹅版 v2.4.3

燕山雪 · 发表于 2021-6-3 18:55

lazyboy 发表于 2021-6-3 17:18
不懂就问，不是正经码农，没怎么接触过大的项目
就我仅有的一点经验知道doxygen是基于注释生成程序里代码 ...

doxygen的例子可以看opencv，支持索引，分类，跳转，检索等等。gitbook可以参考这个，编辑方便格式清爽，目录、prev、next这些“不重要”的功能都是自动生成的，几乎不需要工作量。总之现代开发者写文档不借助工具的已经很少了，可能华为码农都还停留在msdn年代吧……

升职加薪 · 发表于 2021-6-3 19:05

提示: 作者被禁止或删除内容自动屏蔽

jbjack1215 · 发表于 2021-6-3 19:12

fukc 发表于 2021-6-3 17:11
所以谷歌究竟是怎么看待这个事情的？是认为“该行为长线看会导致安卓阵营分裂和脱离自己掌控 ”还是“战五 ...

gms支持鸿蒙吗？

升职加薪 · 发表于 2021-6-3 19:14

提示: 作者被禁止或删除内容自动屏蔽

燕山雪 · 发表于 2021-6-3 19:33

升职加薪发表于 2021-6-3 19:14
或者更通俗的例子
GVIM是非常古老的编辑器
原生的GVIM简陋不堪

果然非码农看不懂主楼的槽点……这么说吧，所谓工具，影响的是服务态度好不好摆盘是否漂亮，而那堆文档的主要问题是他端上来的是一坨shit……

燕山雪 · 发表于 2021-6-3 19:35

升职加薪发表于 2021-6-3 19:14
或者更通俗的例子
GVIM是非常古老的编辑器
原生的GVIM简陋不堪

另外非码农不要说vim简陋不堪这种话，容易引仇恨或者说被鄙视……

PPStream · 发表于 2021-6-3 19:38

红都剧院24排4号发表于 2021-6-3 11:39
魅族用鸿蒙，是不是可以看成乔布斯回归苹果时认微软做大哥

魅族当年被谷歌高通都整过
肯定劈腿的啊
233

tillnight · 发表于 2021-6-3 19:39

咋没见楼主一一纠正按照自己错误理解(被刻意引导)的方向兴高采烈的人呀。一口一个你不懂，却没管黑错方向的人嗷。

ryanz · 发表于 2021-6-3 19:40

燕山雪发表于 2021-6-3 19:35
另外非码农不要说vim简陋不堪这种话，容易引仇恨或者说被鄙视……

有的IC前端 vnc + gvim 开多个窗口写代码的方式，你见过就知道了，槽点真的很多，只会hjkl dd y wq，连vimrc都没动过，我见过好几个，有追求早就换换 ssh + tmux + vim 一套了 =。=

燕山雪 · 发表于 2021-6-3 19:45

ryanz 发表于 2021-6-3 19:40
有的IC前端 vnc + gvim 开多个窗口写代码的方式，你见过就知道了，槽点真的很多，只会hjkl dd y wq，连vi ...

所以vscode支持ssh简直功德无量啊2333，拯救太多vim苦手了（包括我_(:3 ⌒ﾞ)_）

ToTheGlory · 发表于 2021-6-3 20:08

所以看下来就是楼主兴高采烈的怼了两页让后被行内人怼翻车了

—— 来自 HUAWEI ELS-AN10, Android 10上的 S1Next-鹅版 v2.4.4.1

Dreki · 发表于 2021-6-3 20:18

u96 发表于 2021-6-3 15:15
泥潭也开始同温层了，这个贴跟鸿蒙那贴见到的id都不怎么重合。

关注重点也不一样吧，我一开始点进来是想看技术上哪拉垮了，结果一看是文档，都没啥想回复的，甚至不知道前排在高潮啥

搜索 · 发表于 2021-6-3 21:54

提示: 作者被禁止或删除内容自动屏蔽

stillwmxz · 发表于 2021-6-3 22:21

纯外行，楼主为什么不回复#45呀

韭菜 · 发表于 2021-6-3 22:44

这帖子看完不是和nga一个尿性么
楼主只挑能回复的回复字里行间透露着你不懂

233 比尼姑庵还恶臭

defer · 发表于 2021-6-3 23:53

stillwmxz 发表于 2021-6-3 22:21
纯外行，楼主为什么不回复#45呀

因为55楼的回复已经指出差异了，可能是你看不出来吧。
你们不用总强调自己是外行，多说几句我们能看出来。

另外这个帖子已经偏了，楼主说这个文档有两个问题
1是存在大量莫名其妙的内容，比如买本书学炒鸡蛋，给你讲20页鸡蛋的构成与来历凑页数，这是主要问题。
2是文档组织形式不够与时俱进，这个其实无所谓，表面功夫嘛。

现在话题完全被搅到2上去了，楼主已经输了。

YoumuChan · 发表于 2021-6-4 00:10

phorcys02 发表于 2021-6-3 16:46
gitee 自带全文搜索阿
github也有的

咦，怎么全文搜索，我之前试了一下只搜出一堆名字里带关键词的仓库

wuuuuuud · 发表于 2021-6-4 01:13

device-dev不就是硬件开发，工程师可能上一个项目用的还是gd32

沛吖沛 · 发表于 2021-6-4 01:30

所谓的双标现场呗

Heliko · 发表于 2021-6-4 06:44

YoumuChan 发表于 2021-6-4 00:10
咦，怎么全文搜索，我之前试了一下只搜出一堆名字里带关键词的仓库

要点进 repo，点进 repo 之后左上角默认是当前 repo 的全文

墨圣 · 发表于 2021-6-4 07:34

提示: 作者被禁止或删除内容自动屏蔽

		自动登录	找回密码
密码			立即注册

[屁股] 鸿蒙的文档真是太有趣了

评分

评分

评分

台球论坛网友台球论坛网友当前离线禁止发言精华 \| 战斗力鹅 \| 回帖 0 注册时间 2008-4-17 头像被屏蔽	发表于 2021-6-3 16:37 来自手机 \| 显示全部楼层提示: 作者被禁止或删除内容自动屏蔽

	回复使用道具举报

fukc fukc 当前离线禁止发言精华 \| 战斗力鹅 \| 回帖 0 注册时间 2019-8-14 头像被屏蔽	发表于 2021-6-3 17:11 \| 显示全部楼层提示: 作者被禁止或删除内容自动屏蔽

	回复使用道具举报

自旋自旋当前离线禁止发言精华 \| 战斗力鹅 \| 回帖 0 注册时间 2012-8-24 头像被屏蔽	发表于 2021-6-3 17:37 来自手机 \| 显示全部楼层提示: 作者被禁止或删除内容自动屏蔽

	回复使用道具举报

ohi ohi 当前离线禁止发言精华 \| 战斗力鹅 \| 回帖 0 注册时间 2016-10-28 头像被屏蔽	发表于 2021-6-3 17:42 \| 显示全部楼层提示: 作者被禁止或删除内容自动屏蔽

	回复使用道具举报

升职加薪升职加薪当前离线禁止发言精华 \| 战斗力鹅 \| 回帖 0 注册时间 2020-9-28 头像被屏蔽	发表于 2021-6-3 19:05 \| 显示全部楼层提示: 作者被禁止或删除内容自动屏蔽

	回复使用道具举报

升职加薪升职加薪当前离线禁止发言精华 \| 战斗力鹅 \| 回帖 0 注册时间 2020-9-28 头像被屏蔽	发表于 2021-6-3 19:14 \| 显示全部楼层提示: 作者被禁止或删除内容自动屏蔽

	回复使用道具举报

搜索搜索当前离线禁止发言精华 \| 战斗力鹅 \| 回帖 0 注册时间 2020-6-4 头像被屏蔽	发表于 2021-6-3 21:54 \| 显示全部楼层提示: 作者被禁止或删除内容自动屏蔽

	回复使用道具举报

墨圣墨圣当前离线禁止发言精华 \| 战斗力鹅 \| 回帖 0 注册时间 2021-1-27 头像被屏蔽	发表于 2021-6-4 07:34 来自手机 \| 显示全部楼层提示: 作者被禁止或删除内容自动屏蔽

	回复使用道具举报