能否增加文档类型的教程示例

现在教学的大多是视频教学,一些在帮助文档里重要的函数知识点,只有在视频教学里完整的说明,但是文档类型的教学示例却缺失。只在帮助手册里提及概念。具体如何使用,只能耐心听完几个小时的视频。

可能视频教学更符合潮流,教学新颖,但是不是适合所有的学员。听一份视频教学经常要花费几个小时,但是如果用一份认真的文档,可能花10分钟就领悟了。

个人建议,仅供参考。

1  视频教学更适用年轻一代,比如B站,涉及文史,政法类的教学。强调轻松有趣。但实际效果有限,对于我们这类中老年学员,给一份详细的帮助文档,和认真编写的文档教程。可能花10分钟就读完,自己就可以编写。但是视频教学,要耗费几个小时,而且视频教学中方很多无关的课间闲聊,课外干扰都打断教学进度。视频中的教学文档,经常找不到全文。要完整复制下来,只能耐心听完几个小时,按照视频一个个的敲打代码。非常的费劲,而且课程中间参杂大量无用时间,实际上是降低了学习效率。

2   涉及软件使用,功能流程的教学,建议还是用视频教学,因为涉及菜单工具条 功能转换,视频教学更直接。但是涉及交易理念,函数接口,还是用文档方式更有效率。在学校那些学习最大进步的是自学的学生,不是在课堂上认真听讲的学生。现在教辅改的乱七八糟,完全没法自学,只能被动听课,上培训班。希望开拓者团队能把精力放在教材自学上,而不是视频授课上。

所有对于传播来说,视频教学更新颖,吸引年轻人听课,但大多听完就走,未必能深入研究。但对于想深入了解,喜欢自学的学员,提供一份详细的帮助手册(你们已经做到)和针对手册的辅助的文档教学示例(希望你们提供),要比视频教学更实际和有效。

希望老师们以后再推出视频教学的同时,也能相应的提供一份文档教学。

tb编程说明文档里面“Position-持仓:对象类型”到处找不到示例
使用帮助文档中的示例双均线交易策略报错
TBquant 监控器能否增加一个“暂停”的按扭
TBQ3 在线帮助文档中函数示例代码显示异常
自动优化教程请求
想用A函数策略参与集合竞价挂单,无从下手,能否搞一个示例,多谢
基础数据变量Dic能否存储map类型数据?
系统类型的基础数据是否相当于是Global的?(另外疑似文档有错)
软件增加功能的建议
自编函数支持回朔的示例

这个帖子跟这个评论对比看 ,有点好玩 哈哈哈哈哈

作为一个此前完全不会写代码也看不懂的人来说,如果侧重文档而较少演示,真的哭

可能这就是有基础和没有基础的差距


直观的感受在教学视频中学到很重要的一点

是写作习惯和解决bug的思考方式

0基础课从介绍指标开始以及实战案例视频,像一个宝藏,内涵了很多非平台义务的分享,

比如量化思维、技术分析理论、市场观察等等,甚至是一些底层的思考,而这些内容是在通用平台付费都很难听到真话的领域(要么懂的人遮遮掩掩说一半留一半,要么是一些半桶水在以其昏昏使人昭昭)。

好吧 再说下去 感觉我很像雇来的水军了😄😄😄


这是23年的帖子,现在的文档应该好很多了吧

不过是想过,如果在文档旁边加一个评论功能(如果影响阅读可以默认关闭,只有点击才打开的那种)

学生在日常学习过程中,如果对应的地方不理解可以针对性的问

或者有人对这个函数有愿意分享的技巧、心得 也可以写

之后的人看到这个函数,也可能会有相同的疑问,就省去了一些重复回答

(不过这好像和社区的部分功能重了,会增加老师的工作量,可能就还需要考虑与社区和视频的交互以减轻老师的重复劳动,但这又成倍增加了维护成本.........好了,当我没说)

大赞。按道理我的阅读文档能力不差的,可是当我开始阅读TB的帮助文档的时候,有点差意思。其实帮助里面能优化的文档内容真不少,缺的部分现在就是老师们视频里面需要讲的,不然大家都不懂。😅

现在视频区的评论是我推动了两年多,现在才加上的。

之前也提到过,帮助文档,函数手册,最好都加个评论。

😁

我也认为应该把教学重心放在文档上,而视频教学作为补充。文档一个最显著的好处就是可搜索查找感兴趣的关键字、关键功能。

论坛上经常同一问题被反复提问,通常是很基础的知识,部分原因就是人很难为了一个小问题去看20分钟视频。甚至看完一个后发现不是相关解释,又要去找下一个。

另一个优势就是当软件的版本更新或功能更改后,可以准确的对比前后的不同之处,利于对自己策略的修改。

现在的TBQ文档给我的感觉是开拓者公司的技术开发“随手”写的,对于不是程序员科班出身的来说很多地方语焉不详,考虑的场景过于简单。

0基础,学量化系列课程,老师讲的都是实用技巧,和老师多年做量化的经验,没有废话的。

做量化就要看这种视频才能提高。你说的看文档10分钟就能领悟,你真是太小看TBQuant的功能了。

@zhaoyue 我说了,如果认真写文档的话,看文档一样可以替代视频,老师在视频里讲的确实都是真金白银,都是量化的要点,这些我不否认。但是这些知识点用文档表现出来,就听不懂了?完全莫名其妙。哪里有必须视频才能懂,文档就不懂的知识传播。
@zhaoyue 我举了例子,onsignal,在帮助手册里,只有定义,和没多少注释的代码片段。确实让人不知所云。然后官方的各种教程里也查不到onslgnal的用法。只有视频里才有两段王老师和刘老师的讲解。看了视频才明白onsignal的用法,也确实明白老师的良苦用心。但是如果把这些要点用文档写出来,说的再直白一些,就是视频里讲解要点,直接文档表现,我一样能看懂,你看不懂?你必须看视频才能懂?天底下哪里有这种荒谬的理论?你喜欢看视频,不能强迫别人都和你一样看视频吧。同样的知识点,用视频和文档同时公示出来,满足不同需求人群,有什么错? 非要较真,请老师把onslgbal的用法,用文档写出来,然后公示,统计一下看不懂的人有多少?看视频能看懂的有多少?看文档用时和看视频用时,统计时间。
@zhaoyue 我再举一个例子,两年前王老师讲了一个高频交易的视频,用了三堂课。后来特意精简又重新讲了一边,还是三堂课。我反复看了六堂客,每节课一个半小时。六堂课就是接近10个小时。看完还要总结,复习。花费的时间更多。但是最后其实总结成一个精简的文档,一样可以达到传播高频的目的。总结也容易,就是onbar里启动初次发单,然后用状态变量控制不再重发。onfill里查询成交单,如果成交就跳几个点发止盈单。形成一个最简单的高频交易闭环循环。ontimer里监控止损单并撤单。onorder检测撤单消息,重新发单。写一个最简单的高频示例,把核心思路理清楚。用文档真的可以十分钟理解。至于编外环节,各种后续处理。学员可以自行发挥。根据核心示例,自己改写。根本不用多讲。非要用视频教学,学习效率并不一定提高。而且非常浪费时间,直播时学员可能觉得各种活跃课堂气氛的插科打诨。对于后面要深入研究的学生来说就是浪费时间。还不如一篇认真总结的精简文档更有效。那些只能看认真视频,却看不懂文档的学生,真的怀疑他们是否真的在听课,居然能讲出,只能看视频,文档看不懂的这种匪夷所思的话?

主要是个人能力有限,有些概念不通过演示过程和效果的方式来展示的话,很难讲清楚。你觉得你看文档能看得懂,但是我觉得我不一定能把文档写明白。如果单纯只是把代码丢出来,那又失去了做教程的意义。模型开发是一个重操作实战的技能,没有一个人是靠读代码学会开发的。

学习了👍

文档帮助中心不是有吗

做视频就是因为说看不懂文档才做的

其实想学好模型开发,重要的不是看文档和看视频,是多看实例代码,多仿写,多尝试写。

代码是手艺活,不是说天天看教程最后就能看成开发高手

@kyover 比如onsingal帮助手册里只有基本定义,和一个基本没注释的代码片段。光看手册根本不知所云,在tb教学和其他教程里也搜索不到任何关于onsingal的说明。只有视频教学里有两段相关视频。需要看视频教学里两段视频才能理解onsingal的用法。如果能根据视频教学,整理出对应的文档,可能更适合那些没时间看视频的学员吧。请相信学员的理解能力,绝对没有看文档看不明白,看视频反而能理解的范例。只要用心写清楚。文档一样能替代视频,作为教学模式。更有利推广。

你的意思是研发工程师给的文档不够全面,需要补充是吗