欢迎您光临博庭社区!

 找回密码
 立即注册
楼主: foxar

欢迎大家对帮助文档提出宝贵意见!   [复制链接]

Rank: 3Rank: 3

发表于 2013-6-14 13:04:16 |显示全部楼层
Mrdeng 发表于 2013-6-13 15:52
谢谢各位的大力支持!我们争取在2周内先出第一版公式系统说明,之后围绕第一版的框架,逐步加入更详细的说 ...

好的!!期待!!可以参考一下其他软件的公式说明

使用道具 举报

Rank: 2

发表于 2013-6-16 00:11:54 |显示全部楼层
本帖最后由 lancewoo 于 2013-6-16 22:50 编辑
Mrdeng 发表于 2013-6-5 08:51
大家好!

我是博庭帮助文档编写的负责人。目前我们的帮助文档还比较粗糙,也有很多用户提出很多意见,所以 ...

至少要有两套文档:入门文档(Guide)和参考文档(Reference)。

1、要有一个基本的入门文档,能把整个编程语言总体讲一遍,支持什么,不支持什么,一般用法,语法等等,这个文档应该类似于一个编程语言的教程;
2、要有函数参考文档,这是用来编程时随时查阅的内容。函数参考文档要把每个函数的参数设置、使用等都说明白,最好每个函数都配有示例,否则有些函数还是需要使用者自己摸索。

另外,不管对于入门文档还是函数参考文档,对于比较隐晦难懂的地方最好还是配图~!

这方面建议参考MT4的文档。越详细越好!

点评

fantasynew  说得好,最好提供chm和pdf  发表于 2013-9-28 21:24
newhi  好  发表于 2013-6-20 00:13

使用道具 举报

Rank: 6Rank: 6

发表于 2013-6-18 05:37:47 |显示全部楼层

使用道具 举报

Rank: 3Rank: 3

发表于 2013-6-18 15:33:03 |显示全部楼层
一定要从普通用户的思维角度来编写,适用,多举一些例子,常用的思路多列举一些,有文字,有例子,最好根据需要配上图,这样更直观,

使用道具 举报

Rank: 1

发表于 2013-6-19 08:48:15 |显示全部楼层
难得好贴,赞一个,继续努力啊












瑞士手表网 ewacth.com

使用道具 举报

Rank: 6Rank: 6

发表于 2013-6-20 06:13:02 |显示全部楼层
公共函数能出个文档不,不然里面的函数很多都不知道是做什么用的

使用道具 举报

Rank: 8Rank: 8

发表于 2013-6-21 14:39:33 |显示全部楼层
谢谢给位朋友的建议!

我这边计划下周会出第一版说明,目前文档基础内容已完成,不过整理成册还需要点时间。
由于内容比较多,第一个版本可能会粗糙些,以后会在这个版本上不断的添加新的内容和实用例子。

使用道具 举报

Rank: 6Rank: 6

激情奖

发表于 2013-6-22 08:46:34 |显示全部楼层
有下面几个建议
1。公式语言部分,除了讲语法规则,金语言中类型讲和c的接口中类型对应关系,还有运算符的含义,关键词的用法和含义
2。用c角度看计算机制,比如好几种run模式,用典型例子说明,比较他们的不同
3。几个容易混淆的问题单独放到单元,序列和单值的关系,特别是序列的问题,没有合理显式的说明他参与计算时是做为单值还是序列,在逐行和逐根下容易混淆,还有序列的下标引用问题,在逐行和逐根下也比较含糊,还有一些特殊情况,比如-1的下标。总之,以前的逐行和现在的逐根在语法上在序列问题上有很多的模糊,我觉得语言设计不好,没有c那么明确,比如逐行模式序列参与计算也可以做为单值,问题多多
4。函数库的使用,说明适合两种计算模式那一种,要举例说明,如果适合两种模式,这个就要比较同样个函数在不同的计算模式下的不同,要有典型例子说明
5。自定义函数部分,给出调用方法和例子,最好把金语言中类型都用到,好巩固说明
6。建立类似msdn中索引,关键词
7。语言扩展方面,最后用kt的新数据接口来开发dll,现在还是老接口,而目前脚本执行效率还是低的无法和dll相比,希望能开发出强大的数据接口,可以引用任意股票任意周期的数据这终极目标。
8。数据库的扩展,还函数库增加数据库操作的api,对一些关键序列读写库
9。如果有够强大的实力,就开发金语言的虚拟机,公式脚本不再是解释运行,而是编译成金语言虚拟机的机器代码,像java或c#那样的类编译语言,真正从语言的角度兼容以前的公式
10。目前的自定义函数也要支持逐行模式,最好给出逐行模式下公式转逐根下的方法和实例,比如zig函数在逐根下的实现

使用道具 举报

Rank: 6Rank: 6

激情奖

发表于 2013-6-22 08:47:06 |显示全部楼层
Mrdeng 发表于 2013-6-5 08:51
大家好!

我是博庭帮助文档编写的负责人。目前我们的帮助文档还比较粗糙,也有很多用户提出很多意见,所以 ...

有下面几个建议
1。公式语言部分,除了讲语法规则,金语言中类型讲和c的接口中类型对应关系,还有运算符的含义,关键词的用法和含义
2。用c角度看计算机制,比如好几种run模式,用典型例子说明,比较他们的不同
3。几个容易混淆的问题单独放到单元,序列和单值的关系,特别是序列的问题,没有合理显式的说明他参与计算时是做为单值还是序列,在逐行和逐根下容易混淆,还有序列的下标引用问题,在逐行和逐根下也比较含糊,还有一些特殊情况,比如-1的下标。总之,以前的逐行和现在的逐根在语法上在序列问题上有很多的模糊,我觉得语言设计不好,没有c那么明确,比如逐行模式序列参与计算也可以做为单值,问题多多
4。函数库的使用,说明适合两种计算模式那一种,要举例说明,如果适合两种模式,这个就要比较同样个函数在不同的计算模式下的不同,要有典型例子说明
5。自定义函数部分,给出调用方法和例子,最好把金语言中类型都用到,好巩固说明
6。建立类似msdn中索引,关键词
7。语言扩展方面,最后用kt的新数据接口来开发dll,现在还是老接口,而目前脚本执行效率还是低的无法和dll相比,希望能开发出强大的数据接口,可以引用任意股票任意周期的数据这终极目标。
8。数据库的扩展,还函数库增加数据库操作的api,对一些关键序列读写库
9。如果有够强大的实力,就开发金语言的虚拟机,公式脚本不再是解释运行,而是编译成金语言虚拟机的机器代码,像java或c#那样的类编译语言,真正从语言的角度兼容以前的公式
10。目前的自定义函数也要支持逐行模式,最好给出逐行模式下公式转逐根下的方法和实例,比如zig函数在逐根下的实现

点评

fantasynew  赞同你的看法  发表于 2013-9-28 21:26

使用道具 举报

Rank: 3Rank: 3

发表于 2013-6-22 16:10:08 |显示全部楼层
支持一下

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

bottom

Archiver|http://www.patiosoft.com

GMT+8, 2017-12-11 12:24 , Processed in 0.124439 second(s), 10 queries .

花生网 Copyrigh©2012

和讯信息科技有限公司 ALL Rights Reserved 版权所有 复制必究

回顶部