当前调查有8人投票
选择最多的是“没有能力”,不知道是不是真的,但是您可以
- 分享笔记(若有)
- 分享经验(若有)
- 阅读现有文档(不会定期更新的HTML版),指出有错/难以理解的部分
没有时间/精力无解(
选择第四多的是“不清楚贡献方式”
当前团队只有一人,这意味着不确定性(例如成员忙/因故重伤这是可以说的吗)
owner invitation已发给 nesteiner & johnnychen94 ,也欢迎申请
成员可以做的包括但不限于
- 贡献
- 处理相关pull request
- 挂名啥都不干
- 吐槽
我觉得贡献的方式好复杂,本来是简单的一个Roadmap,用Mindmap或者流程图就能搞定,越写越多了
正好我已经提前解决好了学校的一堆作业,这周我就看看,准备一下
还有个问题,你这个 roadmap 怎么导出
看了好几天github都没看见readme里给出一个网页,也不知道怎么贡献。
如果你说的是像那种一看就是svg的,看起来壮观的图,那么需要指出的是:
- 这样的图我见过,可能会保存,但不会拿去用
思维导图是用来讲的,不是用来学的
- 我们提到过,如果希望回答各种需求,那么这样的图会很杂乱; 如果是希望方便地处理包工作,那么已经有至少3个功能完善的平台了(;之后会放一个searchbytag.html)
关于“越写越多”,一方面仅仅给外部链接会使点过于零散化,不同的语言/风格/上下文(可以看到的是,至少在basic和advanced章节中文档顺序与中文文档不同);另一点是可以在恰当的位置插入相关的资料/经验(例如写到if-else底的时候我希望链接到一篇“分支预测”,而不是让用户在链接列表里猜是否相关、是否要读);可以不断完善(不同于中文文档严格进行翻译)
话说你们是不是没看packages部分?(
还有个问题,你这个 roadmap 怎么导出
隔壁HTMLify仓库
看了好几天github都没看见readme里给出一个网页,也不知道怎么贡献。
不知道什么“给出一个网页”什么意思……我应该放了CONTRIBUTING的链接
ZMAlt
5
1 个赞
Roadmap 是一份指南,你这里的内容使用链接,指向别人的教程就可以了
这是隔壁的
project-based-learning ,他们的是简单的目录加内容的形式,其中内容是引用他人的链接
Ailuj
10
@Rratic 抱歉非计软的科班,很多东西莫名看不懂,感觉不够接地气呀,比如阵列Array吧,如果称为数组,好像就只能是数项元素了,但实际上也可以是字符等类型,而且也没解释什么是阵列,直接就上例子了,还有最后的!!! note 数组的数组与多维数组是不同的,读起来有点绕,为什么不直接说嵌套与多维不同?
Rratic
12
如果称为数组,好像就只能是数项元素了
在大部分语言中都是翻译“数列”的吧
也没解释什么是阵列
有人建议过暂时不必让文档适合所有人
之后可能会在knowledge模块添加what is …
还有最后的!!! note
我有空改下
Rratic
13
指向别人的链接会消耗额外的网络资源,而且操作麻烦(虽然设了target=_blank
)
内容可以根据CC协议抄,并没有增大很多工作量
Rratic
17
补充一下,可以贡献的不仅是文档
可以是修改这样的svg
也可以做icon(以下是我刚刚做的错误示范)
Rratic
19
有一部分(主要是advanced的一部分)我已经打算先复制中文文档了(就是找原markdown有点麻烦)