Discussão sobre a documentação MQL4 - página 9

 
O que é interessante, vi a seguinte linha na documentação
Como os índices começam com zero, o tamanho da dimensão é 1 a mais do que o maior índice.
Eu pensei... É interessante até mesmo para "meros mortais" (aqueles que não estão familiarizados com programação) que não sabem que as matrizes são numeradas a partir de 0. :)
 

Sim, a frase "Como os índices são baseados em zero, o tamanho da dimensão é 1 maior do que o maior índice" me fez pensar muito sobre seu significado oculto, embora eu geralmente leia a documentação MQL4 em inglês sem nenhum dicionário...

Esta é uma situação interessante. Os desenvolvedores, como eu o entendo, são russos, e a documentação embutida está em inglês. Talvez o problema esteja no tradutor? OK, veja aqui: https://docs.mql4.com/ru/array/ArrayRange, tudo está em russo. O equivalente russo da frase é o seguinte:

Como os índices começam de zero, o tamanho da dimensão é 1 a mais do que o maior índice.

"Que o maior índice" - de quê? E como, afinal, os tamanhos das dimensões são indexados - com 0 ou com 1? Aqui também, a frase é igualmente pouco clara, infelizmente. Talvez o problema não seja com o tradutor, afinal de contas? O tradutor traduziu a frase original para o inglês com precisão, sem acrescentar ou omitir nada.

Agora, eu me colocaria no lugar do tradutor. Se eu encontrasse tal frase na descrição de uma linguagem de programação, tentaria primeiro entendê-la corretamente e depois traduzi-la. Eu não ficaria atrás do autor da descrição russa até compreender o significado desta frase para mim mesmo 100%. Talvez o problema esteja nele, o tradutor da documentação? Não é que ele traduza de forma imprecisa, mas que o tradutor deve ter pelo menos uma compreensão básica de programação, para que possa corrigir quaisquer ambiguidades na descrição original russa?

P.S. Novamente a mesma falha do fórum que apontei em"Ajude-me a consertar a EA ?!

Xeon, obrigado, entendi tudo, só nunca mudei para o russo porque não precisava fazê-lo.

 
Um link para o tópico :-) + sobre "o que alguns executivos pensam dos programadores" :-)

http://www.ashmanov.com/pap/obspro.phtml

O programa está bem documentado em C.

Comentário: uma piada de um programador "para seus próprios", refletindo o triste fato de que ninguém tem comentários e documentação escrita para programas e não o fará a menos que seja forçado por uma mão firme.
 
 
Renat:
Meu entendimento é o seguinte:
  • disponibilidade de documentação integrada sobre MQL4 (em dois idiomas) no MetaEditor
  • desenvolvimento do website da comunidade de programação MQL4 em três idiomas (russo, inglês e chinês)
  • Pagar pelos artigos de comerciantes independentes na MQL4
  • Organizando o Campeonato Automatizado de Comércio
  • manutenção da biblioteca on-line Codebase com acesso direto do MetaEditor
  • Suporte técnico e consultoria permanente de comerciantes pelos desenvolvedores em nossos fóruns
é justo:

Esta é a abordagem do programador soviético como: "Nós escrevemos um sistema super-genial e auto-explicativo, e você, tolo, não consegue entender isso.

Não faça uma substituição tão óbvia do conceito. Eu não chamei a abordagem do programador soviético de uma lista das realizações de sua empresa, mas a frase que você expressou inadequadamente: "Isto é divertido". Não quero estudá-lo, mas estou pronto para culpar você pela falta de documentação".

Não nego que você está fazendo muito para melhorar sua documentação, mas não fique preso à idéia de "você não pode agradar a todos de qualquer maneira, especialmente porque todos são preguiçosos demais para estudar". Não tome os participantes deste tópico como usuários caprichosos que não sabem o que eles mesmos querem.

Eu pessoalmente comecei a me familiarizar com a MQL desde o último fim de semana e agora posso dizer que já tenho tudo planejado, e posso escrever a qualquer especialista, basta olhar através da ajuda e encontrar as funções necessárias. É uma boa conquista de sua documentação e eu lhe sou grato por isso. Mas neste tópico eu apenas dei algumas sugestões de natureza metodológica, que eu acho que podem ser interessantes para vocês, pois podem facilitar a vida de muitos outros que querem aprender MQL. No entanto, como Yurixx corretamente assinalou: "E neste fio foram expressos alguns (apenas alguns !) desejos específicos sobre o assunto. A implementação desses desejos resultaria em uma qualidade completamente nova de oportunidades de aprendizagem MQL para esses mesmos iniciantes. No entanto, você não disse nada sobre isso".

Repito, o problema com sua documentação não é que haja dados desatualizados ou faltando em algum lugar, mas que ela não introduza passo a passo o iniciante. Ou seja, trata-se de um problema metodológico. Quando você começa a aprender uma nova área de conhecimento, a primeira coisa que você precisa fazer é descobrir porque você precisa dela, que benefícios ela trará, que seções existem nessa área de conhecimento, que papel essas seções desempenham e porque a divisão é do jeito que é. E só então, quando você conhece suas metas e objetivos, quando você tem tudo organizado e estruturado em sua cabeça, você começa a rotina - o estudo direto das informações, o estudo de fórmulas e tabelas. Você tem as informações, mas nenhuma introdução.

Você também não tem exemplos no espírito de "vamos escrever um simples Expert Advisor com você: clique aqui, faça isto, escreva aquilo, nós fizemos tudo porque... parabéns, você tem um Expert Advisor, você pode executá-lo assim".

Não é preciso dinheiro ou tempo para criar tanto o primeiro (entrada) quanto o segundo (alguns exemplos iniciais). Escrever estes documentos é uma semana de trabalho para uma pessoa da sua equipe. Se você tem tudo isso, eu pessoalmente passaria 3 horas, e não dias, para estudar MQL.

Também, uma idéia para acrescentar comentários à documentação publicada na Internet foi sugerida aqui. Essa é uma idéia sensata! Poderíamos até mesmo fazer documentação como base de conhecimento à maneira das redes sociais da Web 2.0. Para cada artigo na documentação, deixar os usuários acrescentarem comentários construtivos em estilo de microartigo (1-2 parágrafos), classificar uns aos outros, discutir os artigos e fazer perguntas uns aos outros. Faça uma classificação do usuário, e deixe os usuários escreverem sua própria documentação "necessária pela sociedade" para o respeito e reconhecimento de seus pares.

Entendo que você tem um fardo de responsabilidade, muitos outros problemas e todos os conselhos aqui listados não são tão fáceis de implementar. Você pode ter medo de aumentar a complexidade de seu produto, que vem com a tentativa de agradar a todos, e isso é louvável. Entretanto, nós como usuários também temos o direito de sugerir algumas coisas conceituais que podem tornar seu produto mais claro e mais acessível. Consulte qualquer especialista no campo da educação ou da usabilidade, tenho certeza de que eles apoiarão as reflexões aqui expressas, especialmente sobre a forma como as informações são apresentadas.
 
xeon:
Um link para o tópico :-) + sobre "o que alguns executivos pensam dos programadores" :-)

http://www.ashmanov.com/pap/obspro.phtml
:)))
 
Yurixx, por favor, aponte o erro real. O que você citou não é nem remotamente um erro.

A descrição que você deu na linha de ajuda é perfeitamente normal e clara.
 
Não há necessidade de fazer uma substituição tão óbvia do conceito. Eu não chamei a abordagem do programador soviético de uma lista das realizações de sua empresa, mas a frase que você expressou inadequadamente: "É divertido fazer. Não quero estudá-lo, mas estou pronto para culpá-lo pela falta de documentação" <br / translate="no">.
Não há substituição. Estou falando proativamente e apontando o estado real da documentação para deter a agressão excessiva em meio a uma falta de consciência. Foi você quem fez explicitamente a declaração acusatória "Esta é a abordagem do programador soviético dentro do espírito de ...".

Minha experiência e conhecimento são suficientes para explicar conscientemente às pessoas que a programação é uma coisa complicada, e nenhuma pressa teórica (aprender uma linguagem em 3 horas!) não fará de você um programador. Mas algumas pessoas não querem entender isto, desligar a cabeça, pendurar o slogan "O cliente está sempre certo" na bandeira e declarar literalmente o seguinte:

Entenda, se as pessoas estão tendo dificuldades para descobrir sem um livro didático, o problema é seu e somente seu

É quase o mesmo que dizer à lei da gravidade: "Entenda, é ruim para as pessoas se moverem, esse é o seu problema! Por que você não entende?" A propósito, como você se sentiria ao se tornar um físico a partir de um livro e melhor em 3 horas, 7 dias no máximo?

Sou a favor do bom senso, de uma abordagem consciente da programação (programação é difícil), de material factual (não há necessidade de acusações vazias ou ofuscadas) e de não chorar por não querer entender (sim, é difícil).

Nada pessoal - isto é sem reverência cortês e direto ao ponto.
 
Tenho uma sugestão construtiva - complemente cada indicação de documentação insuficiente com sua própria versão detalhada. E um artigo escrito livremente seria uma contribuição significativa para a seriedade do autor. A propósito, para ver quem e quanto já foi escrito, basta clicar no nome do autor.

Quem estaria disposto a contribuir para a expansão da documentação?
 
alex_ant:
....
Você também não tem exemplos na veia de "vamos escrever uma simples EA com você: clique aqui, faça isto, escreva aquilo, nós fizemos tudo porque... parabéns, você tem uma EA, execute-a assim".
...
Um dos primeiros artigos no site:Exemplo de criação de um consultor especializado
O artigo, é claro, está um pouco ultrapassado, mas dá uma visão da estrutura de um simples Expert Advisor.
Razão: