Since ...」とはどういう意味ですか?以前はどこで規定されていたのですか?どこにもない!なぜなら、これは特定の関数であり、測定値に番号を振る変数range_index は、他のどこにも現れないからです。つまり、測定値のナンバリングは0から始まり、測定値番号(サイズではありません!)は変数range_index の最大値(「インデックス」ではありません)より1多い、ということにすればいいのです。さらに言えば、1つの文章にすべてを詰め込まず、2~3つの文章で一貫してわかりやすく説明することです。
すべてが理解でき、ドキュメントがあり、例があり、Roshがすべてを書いています。
唯一不満なのは、ドキュメントの例です。だから、これらの例の多くは、すでにこのサイトに書かれており、ドキュメントは相変わらず、間抜けなものです :(
私は、サイトのオンラインドキュメントに、自分のコメントを 追加できるようにすることを提案します(3回目だと思います)。これは他のIT技術でもうまく活用されている。
ここでは、そのような関数の説明の例です:基本的な、プラスサードパーティの開発者の下にコードの準備片 - 取る、コピーします。
例えば、特定できない識別子でエラーが発生しましたが、すでに修正済みです。
Jhonny wrote (a):
ところで、ドキュメントについてですが、ドキュメントのOBJPROP_FIBOLEVELSプロパティでF1 キーを押すと、何か変なことになるというか、ほとんど何も起きないことに気がつきました。
しかし、すべてのケースについて最も詳細なドキュメントを用意したいということであれば、残念ながらそれは無理です。MSDNアナログを端末に挿入するのは難しいでしょう。何を書いても、疑問は残る。また、記事、コードライブラリ、フォーラム、検索エンジンなど、これらすべてを備えていても、必ずしも役立つとは限りません。
このスレッドの話題で、私は長年の思いをはっきりと形にすることができました。良いドキュメント・本をくれれば世界を変える」という理論的なアプローチだけでは不十分です。強制的に、そして自主的にレーキを踏むという練習が必要です。
当社での実践事例:
私たちは以前からソフトウェア開発の方法論を改良してきましたが、ISO9000の認証取得の準備も進めています。ここ数年、このテーマに関する本を何十冊も購入し、たくさん読み直しましたが、どの本も導入の必要性については同意しています。しかし、理論だけでは十分ではありません。とことん突き詰めて、やるしかない。それを一歩一歩進めています。
それはビジネスでも同じです。本だけ読んでいると、「自分を信じて、奮起して、開業して、すべてがうまくいった」と、単純に思えてしまうのです。人生はいろいろ。難しいですね。本を読んだ後は、頭の中がぐちゃぐちゃになります。今こそ「ドキュメントはダメだ」と叫びに行くべき時なのだ。すぐに「コンサルタントを呼ぼう」と思い、ここですべてを任せることにしました。しかし、理性は、コンサルタントの水臭い報告書を読むだけでなく、自分たちで理解して変えていかなければならないことを教えてくれるのです。
ドキュメントに関する当社の見解。
つまり、私たちの教育課題は、最も単純なビルトイン・ドキュメントよりもはるかに広いのです。例えば、昨日は中国でのMetaTraderのプロモーションのために事務所を開設した上海から飛んできました。今後数ヶ月の間に、私たちのサイトの中国語の部分に大きな変更が加えられる予定です。
。
私たちがどのように行っているか、もっと広い視野で見てみましょう。
私は、ホームページのオンラインドキュメントに、自分のコメントを付け られるようにすることを提案します(3回目かな)。これは、他のIT技術でもうまく使われている。
ここでは、そのような機能の説明の例です:基本的な、さらにサードパーティの開発者から以下のコードの既製の部分 - それを取るとコピーします。
私たちはMQL4サイトの制作を続けており、さまざまなアイデアを持っています。明日、ウェブサイト用の新しいエディターのベータ版をリリースします。そして、進化した「関連トピック」機能の新バージョンが登場します。
もちろん、コメントは後から見たのですが、お目当ての記事はほぼ一番上にあったので、すぐに気がつかなかったというわけです。
もう一つ言いたいのですが、このトピックは初心者を Roshaの 記事に送ることが多いのですが、私もよく訪問しますが、Alpariのサイトが少し変わって、ここからのリンク「Roshの記事:MetaTrader 4 experts」はすべて404エラーになるので、しばらくやってませんでした。そこで、これらのリンクを修正する必要があります。
ユリックス、具体的にドキュメントのどこが問題なんだ?エラーの内容を明確にお伝えいただければ、修正いたします。
あらゆる場面で最も詳細なドキュメントを用意したい場合は、残念ながらうまくいかないでしょう。端末にMSDNアナログを挿入することが困難になります。何を書いても、疑問は残る。また、記事、コードライブラリ、フォーラム、検索エンジンなど、これらすべてを備えていても、必ずしも役立つとは限りません。
このスレッドの話題で、私は長年の思いをはっきりと形にすることができました。良いドキュメント・本をくれれば世界を変える」という理論的なアプローチだけでは不十分です。そのためには、強制的に、かつ自主的にレーキを踏む練習が必要です。
ドキュメントに関する当社の見解。
alex_ant さんが書かれているように、MQLプログラムの動作の仕組みを説明する章があるはずです。これは、プログラミングを初めて学ぶトレーダーであれば、言語を学ぶ前でも理解できることです。そして、この説明は取引のプロセスと結びついていなければならず、インジケーター、スクリプト、Expert Advisorの違い、ティックキューとの関係、取引サーバーとの関係、互いとの関係などについても説明することができます。
MQLプログラムの構造、その主な構成要素であるinit()、start()、deinit()関数にはもっと注意を払う必要があります。これらの関数はMQLと他の言語の大きな違いであり、ドキュメントではほとんど数行のスペースしか与えられていません。
辞書の全項目に目を通し、間違いや誤字をなくすだけでなく、用語を共通項にすることができれば、とても素晴らしいことだと思います。関数や手続きのパラメータが同一または類似しているにもかかわらず、全く異なる用語で記述され、その意味が説明されていないことが非常に多い。その結果、記述は可能だが、一部のパラメーターの意味や使い方は、実験で検討する必要がある。
例題を一直線に持ってくることはとても重要 です(4x4everと 全く同じ意見です)。辞書に載っている例文の大半は、何も説明せず、何も教えない。 実際、1行の例文は例文とは言えないのだ !通常の教科書では、例題を見れば、パラメータの意味と、手続き・関数の使用順序と結果の両方を理解することができます。そして、そのために自分でプログラムを書く必要はない。IMHO:MQL Dictionaryの例の弱さは、ドキュメントの主な欠点の1つです。
正直言って、少ないですね。。
レナート 君のドキュメンテーションに対するスタンスには敬意を表する。ただし、挙げていただいたポイントの中に、ドキュメントに直接関係する項目は一つもありませんので、ご注意ください。どれも良いものですが、基礎となるのは、誰もがMQLを学び、プログラミングをするための素材です。現在、これらは、第一に辞書(=文書)、第二にWebサイトでの公開です。アドオンを機能させるためには、しっかりとした土台作りが必要です。つまり、MQL Referenceを目的の 品質に近づけることです。
レナートは(a)を書きました。
Yurixxさん、具体的にドキュメントのどこが間違っているのでしょうか?エラーの内容を明確にお伝えいただければ、修正いたします。
レナート 君のドキュメントに対するスタンスは尊敬に値する。ただし、挙げていただいた点の中で、ドキュメントに直接関係するものは一つもありませんので、ご注意ください。どれも良いものですが、基礎となるのは、誰もがMQLを学び、プログラミングするための材料です。現在、これらは、第一に辞書(=文書)、第二にWebサイトでの公開です。アドオンを機能させるためには、しっかりとした土台作りが必要です。つまり、MQL Referenceを目的の 品質に近づけることです。
そのため、明らかなエラーは表示されないと理解しています。残念なことです。
明らかな誤りの指摘はないのですね。それは残念なことです。
通常このような場合、具体的なエラーを探すのに苦労しない ように、GOST、SNiPs、ISOなどの数ページにわたるリファレンスを提供し、指定されたリストに従って製品を提供することを提案しています。番号を覚えていないのが残念だし、探す気も起きない。そうでなければ、リストを投げつけてやりたいくらいだ;)
冗談のような話です。
レナートさん、以前、発売を予定していた新サイトのエディターは何ですか?
レナートさん、以前ここでおっしゃったサイトの新しいエディター、立ち上げの予定とは?
新機能のひとつに(まだ搭載されていませんが)ビデオクリップの挿入が予定されています。自作のクリップも、YouTubeからのクリップも。おそらく、月曜日に公開テスト用ベータ版を開始することになるでしょう。
レナートは(a)を書きました。
明らかなエラーは表示されないと理解しています。それは残念なことです。Yurixxさん、具体的にドキュメントのどこが間違っているのでしょうか?エラーの明確な指摘をいただければ、修正します。
レナトさん、結論を急ぎすぎです。どうやら、迷惑な "評論家 "を手間をかけずに追い出したいようですね。 これだけ美しく宣言しておきながら、実はその裏には、ユーザーの意向を聞き入れようとしない姿勢があるのでしょう。確かに、MQ自身は何をどうすればいいのか分かっているのだから、ユーザーがどうこう言う必要はない。
あなたは誤解していると断言できます。改善すべき点を明確に示すことができるのは非常に良いことです。でも、その前にはっきりさせておきたいことがあります。この文言は、「間違いを指摘してくれれば修正するが、自分ではドキュメントに目を通さない」ということを示唆しています。 また、「明らかな誤り」という文言も示唆的です。 2年間のデバッグの間に、このフォーラムのメンバーの協力のおかげで、「明らかな誤り」の数は最小限に抑えられ、今も減少し続けています。しかし、それでもあなたはこのフレーズで、「明白」ではない他のエラーについての情報には興味がないことを明らかにしています。そして、悪い例やわかりにくい説明文などには、あまり興味がないのですね。
さらに、すべての ドキュメントエラーについて指示を出す必要があるのでしょうか?Renatはありません、すみません。MQLのマニュアルを作らないのは構いませんが、その言語に関するドキュメントは改訂 しなければなりません。そうです、そうでなければならないのです言語の作成者以外の誰がそれを文書化しなければならないのでしょうか?プログラマーがこの言語を使えるようになるには、このドキュメントをベースにするしかないのでは?
そこで、杞憂に終わることなく、典型的な例を挙げてみます。 もし、あなたがドキュメントの品質に興味がないのなら、私が書いたことがなぜゴミなのか、必ず分かるはずです。この会話に少しでも建設的な要素があれば、間違いなく私の言っていることが理解できるはずです。でも、もうお分かりですね。
とはいえ、ここでは一例をご紹介します。
通常、インデックスとは配列の要素に番号を付ける変数のことです。この場合、インデックスではなく、インデックス番号になります。 ただし、「インデックスは0から始まるので、ディメンションサイズは最大のインデックスより1大きい」という表現から、「ディメンションサイズは0から始まるので、ディメンションサイズは最大のインデックスより1大きい」となります。「これも何もかもが理解できない。特に初心者の方には。
Since ...」とはどういう意味ですか?以前はどこで規定されていたのですか?どこにもない!なぜなら、これは特定の関数であり、測定値に番号を振る変数range_index は、他のどこにも現れないからです。つまり、測定値のナンバリングは0から始まり、測定値番号(サイズではありません!)は変数range_index の最大値(「インデックス」ではありません)より1多い、ということにすればいいのです。さらに言えば、1つの文章にすべてを詰め込まず、2~3つの文章で一貫してわかりやすく説明することです。
説明にある例は、Handbookの名作です。何を明らかにできるのか?何もない!?レナートさん、どうあるべきかわからない方は、このページの最初の投稿の写真を見てください。 少なくとも、例であげた演算結果のプリントアウトがあるはずです。また、その結果、dim_size 変数はどのような値をとるようになったのでしょうか?知っていると思いますが、言語スターターは知っているのでしょうか?
また、仮にdim_size=10と 書かれていたとしても、それで誰かが何かを理解できるでしょうか?この例の作者は、たぶんユーモアのつもりで、配列の3次元すべてに10番 を入れたのでしょう。
ここでは、ドキュメントを書く姿勢の一例を紹介します。態度」という言葉のエピテーゼを自分で考えてみてください。
ここで「明らかな」ミスをいくつ数えたのだろう。一本もない、と思う。
しかし、私は断言できます。このような記事は、明らかな間違いはないものの、ハンドブックに含まれる文書の質を大きく低下させるものがたくさんあるのです。