能不能在命令注释处注释与易语言的区别和使用方法

飞扬工作室

朕的 发表于 2023-2-26 20:13
看个鸡8M，这么常用的基本功能都搞得这么复杂，为啥在命令注释里不直接注释了，咋使用的也找不到答案 ...

骂人警告一次,再犯禁言.

朕的

Xelloss0618 发表于 2023-2-26 20:42
类的方便之处，就是你从类跳过去看代码或帮助，里面有些什么方法一目了然。
学习使用一个类之前，最好看一 ...

画个标签弄个底图也要看帮助，我也是醉了

龙纹

飞扬工作室 发表于 2023-2-26 20:58
骂人警告一次,再犯禁言.

我虽然有些编程经验，但不得不承认的是有时我也会犯马虎。对于一个从没接触过的类库，即使碰到基础问题也难以立刻解决，此时对于他的吐槽我是感同身受的。
我觉得问题在于怎么让一个不熟悉命令的人知道他是怎样正确使用的，即上下文，现在的方式是选择方法时只有方法名，那么可供参考的信息只有也仅有方法名，这样十分考验方法的命名，很多时候是不能见名知意的。
比如下面这个命令

如果我马虎了，这样运行，但为什么没效果呢？查找问题时我就会去看注释，可惜的是我马虎的时候不会只犯一次错，我“忽略”了关键信息。

关键信息肯定是等待执行这几个字，但我并没有联想到其中的含义(事实上我认为这个注释不合格)，等到我认真去查看整个Redis数据库类的时候才发现这个命令下有个命令叫"取连续执行结果"，至此，问题解决，这是我个人使用火山时遇到的真实实例。
用户使用陌生命令时期望也需要第一时间能看到有用的信息，我认为可以在选择方法时提供更多的帮助信息，大概是下面这样：

红框中是我设想的"命令帮助窗口"，在选择方法时就尽可能地提供更多的信息，这对熟悉的命令，如分割文本自然是不需要的，但如果是第一次使用分割文本的用户，其实他期望的是分割子文本的效果，那么他在选择命令时就可以通过"命令帮助窗口"知道这不是自己期望的命令。

飞扬工作室

龙纹 发表于 2023-2-26 21:54
我虽然有些编程经验，但不得不承认的是有时我也会犯马虎。对于一个从没接触过的类库，即使碰到基础问题也 ...

是的,类库命名和注释确实需要加强.

创世魂

山梦 发表于 2023-2-26 20:21
有些，帮助页与注释都是4个参数，到实际只3个。不知道是我太菜没看清楚

https://doc.voldp.com/vol/lib.html#动态调用

所以看教程。看了就理解了。只是一种语法而已。。多数语法都可以通过帮助页识别调用。学会看帮助页，火山能掌握百分之五十。剩下就是多练了。

创世魂

Xelloss0618 发表于 2023-2-26 20:42
类的方便之处，就是你从类跳过去看代码或帮助，里面有些什么方法一目了然。
学习使用一个类之前，最好看一 ...

确实啊，一个新的东西肯定是要有学习成本的。。
如果这点耐心都没有，那就趁早放弃吧。

虽然有句话说的好，学会c语言，其它语言无师自通。但是这就是在扯犊子。
c语言的很多语法在其它语言上都不支持，转换学其它语言的时候都得学基本语法命令相关知识，才能换过去。

龙纹

飞扬工作室 发表于 2023-2-26 22:12
是的,类库命名和注释确实需要加强.

增强IDE也可以帮助"新手"尽快掌握命令，可以考虑选择命令时提供相关的信息，这样用户只要输入 "类实例." 就可以浏览当前类的各个方法了。比如选择命令时就提示如下信息，这样更人性化一点，不必在.v文件中跳来跳去就可以看到信息。

龙纹

创世魂 发表于 2023-2-26 22:26
确实啊，一个新的东西肯定是要有学习成本的。。
如果这点耐心都没有，那就趁早放弃吧。

反对你这个说法，学习一个东西有成本这件事是所有人都知道的事实，但我们正在讨论的不就是能不能、如何降低学习成本吗？不管三七二十一，只是告诉别人要适应，难道他发这个帖不值得你反思火山是否存在问题，有没有能改进的地方吗？

福寿

火山是火山，易语言是易语言，本来就是两种不同的语言，既然觉得易语言有多方便，直接用易语言不就行了，又不是用了火山就限制使用易语言了

朕的

福寿 发表于 2023-2-27 03:22
火山是火山，易语言是易语言，本来就是两种不同的语言，既然觉得易语言有多方便，直接用易语言不就行了，又 ...

用火山的有几个不是易语言来的。既然是易语言衍变来的，却别之处有提示是合情合理。