TC官方合作论坛
标题:
建议官方认真修订帮助文档
[打印本页]
作者:
贪吃蛇
时间:
2015-4-15 09:27
标题:
建议官方认真修订帮助文档
官方的帮助文档是很多人认识TC、学习TC的第一手资料,从一个初学者角度希望官方的帮助文档能够做到:
1,没有明显错误、更没有误导性错误!
例如:1语法——3变量与常量——文末配图,内容作用域指示范围错误;
部分示例代码运行出错(不一一列举)。
2,语言描述通顺正确,别像个**书一样多字、少字、缺标点的。
例如:1语法——8流程语句,首段内容是变量与常量的概念。
1语法——5运算符,最后一句明显没说完。
3,内容尽量详尽,示例代码可以备注运行结果(同时可作为对示例代码的验证),深入部分可以提供到官网文档库的链接或其它类似链接、或建议查阅的资料明目。
例如:1语法——8流程语句,示例2与示例3是对比用的两段代码,如果加上适当的注释(如下)岂不让初学者更容易理解?
//示例2:
//if表达式语句示例
function test_click()
var a = 50
var b = false
//在这个示例中 要注意 =号表达式 与&&表达式的优级级,要不然会得到你意想不到的结果
if((a = 40) && (b = true))
messagebox(a,"条件符合") //弹出消息框内容为40
messagebox(b)
end
messagebox(a)
end
复制代码
//示例3:
//if表达式语句示例
function test_click()
var a = 50
var b = false
//在这个示例中 要注意 =号表达式 与&&表达式的优级级,要不然会得到你意想不到的结果
if(a = 40 && (b = true)) //等效与 if(a = (40 && (b = true)))
messagebox(a,"条件符合") //弹出消息框内容为1
messagebox(b)
end
messagebox(a)
end
复制代码
希望5.0正式版推出时,帮助文档也是正式版的。
作者:
zhujun8469
时间:
2015-4-15 09:37
确实是,文档里面有许多小的错误描述
作者:
忆辰辅助
时间:
2015-4-15 10:42
文档里面小错误有很多,什么函数介绍颠倒啊,函数名错误啊,漏下一个函数未介绍啊什么的,太多了
欢迎光临 TC官方合作论坛 (http://bbs.52tc.co/)
Powered by Discuz! X3.1