TC官方合作论坛

 找回密码
 立即注册
查看: 1267|回复: 2

[其他] 建议官方认真修订帮助文档

[复制链接]
发表于 2015-4-15 09:27:38 | 显示全部楼层 |阅读模式

马上加入TC

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
官方的帮助文档是很多人认识TC、学习TC的第一手资料,从一个初学者角度希望官方的帮助文档能够做到:
1,没有明显错误、更没有误导性错误!
    例如:1语法——3变量与常量——文末配图,内容作用域指示范围错误;
             部分示例代码运行出错(不一一列举)。
2,语言描述通顺正确,别像个**书一样多字、少字、缺标点的。
    例如:1语法——8流程语句,首段内容是变量与常量的概念。
             1语法——5运算符,最后一句明显没说完。
3,内容尽量详尽,示例代码可以备注运行结果(同时可作为对示例代码的验证),深入部分可以提供到官网文档库的链接或其它类似链接、或建议查阅的资料明目。
    例如:1语法——8流程语句,示例2与示例3是对比用的两段代码,如果加上适当的注释(如下)岂不让初学者更容易理解?
  1. //示例2:
  2. //if表达式语句示例
  3. function test_click()
  4.     var a = 50
  5.     var b = false
  6.     //在这个示例中 要注意 =号表达式 与&&表达式的优级级,要不然会得到你意想不到的结果
  7.     if((a = 40) && (b = true))
  8.         messagebox(a,"条件符合") //弹出消息框内容为40
  9.         messagebox(b)
  10.     end
  11.     messagebox(a)
  12. end
复制代码
  1. //示例3:
  2. //if表达式语句示例
  3. function test_click()
  4.     var a = 50
  5.     var b = false
  6.     //在这个示例中 要注意 =号表达式 与&&表达式的优级级,要不然会得到你意想不到的结果
  7.     if(a = 40 && (b = true)) //等效与 if(a = (40 && (b = true)))
  8.         messagebox(a,"条件符合") //弹出消息框内容为1
  9.         messagebox(b)
  10.     end
  11.     messagebox(a)
  12. end
复制代码
希望5.0正式版推出时,帮助文档也是正式版的。
回复

使用道具 举报

发表于 2015-4-15 09:37:52 | 显示全部楼层
确实是,文档里面有许多小的错误描述
回复 支持 反对

使用道具 举报

发表于 2015-4-15 10:42:50 | 显示全部楼层
文档里面小错误有很多,什么函数介绍颠倒啊,函数名错误啊,漏下一个函数未介绍啊什么的,太多了
回复 支持 反对

使用道具 举报

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

本版积分规则

关闭

推荐上一条 /2 下一条

关闭

小黑屋|TC官方合作论坛 (苏ICP备18045623号)

GMT+8, 2024-5-19 21:15 , Processed in 0.044760 second(s), 22 queries .

Powered by 海安简单软件服务部

© 2008-2019 版权所有 保留所有权利

快速回复 返回顶部 返回列表