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

 
Renat:
Mas algumas pessoas não querem entender que, desligue a cabeça, pendure o slogan "O cliente está sempre certo" na bandeira e declare literalmente o seguinte:

Entenda que se as pessoas estão tendo dificuldade de entender sem um livro didático, você e somente você tem um problema

É 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 em um livro e melhor em 3 horas, 7 dias no máximo?
Acho que entendo o que você quer dizer. Concordo com você em parte. Não concordo que se existe a possibilidade de simplificar o processo de aprendizagem, isso não deve ser feito apenas porque "é impossível e contradiz as leis da física". Não estou pedindo que você faça o impossível, sei que os ideais são inalcançáveis. Mas é sempre possível fazer um pouco melhor. Sou a favor de não negar a priori este "pouquinho". E em geral, em termos práticos, não me importa qual será sua documentação, pois já descobri tudo o que quero, meus cargos neste tópico são simplesmente um ato de boa vontade e um desejo de ajudar as pessoas.

Renat:
Quem está pronto para contribuir para a expansão da documentação?
Contribuirei quando chegar o momento.

MetaCotações:
Um dos primeiros artigos no site:Exemplo de criação de um consultor especializado
O artigo, é claro, é um pouco ultrapassado, mas permite compreender a estrutura de um simples Expert Advisor.
Obrigado (risos) Nunca tinha visto isto antes.
 
alex_ant:
MetaCotações:
Um dos primeiros artigos no site:Exemplo de criação de um consultor especializado
O artigo é, naturalmente, um pouco ultrapassado, mas permite que você compreenda a estrutura de um simples Expert Advisor.
Obrigado. Nunca tinha visto isso antes.


A propósito, este artigo foi a única base para que eu entendesse o que é um Expert Advisor e como programá-lo há dois anos.
Em geral, as pessoas se acostumam muito rapidamente às coisas boas e o processo de "emperramento" começa inevitavelmente, independentemente do estado atual das coisas. Acontece em todas as partes da sociedade. As pessoas só precisam de um tipo de luta constante e da realização de objetivos, por mais efêmeros que sejam, que não mudam nada em princípio. Caso contrário, como disse um de meus conhecidos (um milionário, a propósito), torna-se simplesmente desinteressante viver ;o).
 
Renat:
Minha experiência e conhecimento são suficientes para explicar conscientemente às pessoas que a programação é uma coisa complicada e nenhuma quantidade de teoria (aprender uma linguagem em 3 horas!) fará de você um programador. Mas algumas pessoas não querem entender isso, desligar a cabeça, pendurar o slogan "O cliente está sempre certo"...
Eu também gostaria de citar alguns fatos em minha defesa.

Há uma revista para os jovens entusiastas de TI: "Hacker". Às vezes, eles conseguem mostrar a um leitor em um espalhado o básico de uma linguagem (por exemplo, PHP, ASP ou Object Pascal) e mostrar como se pode escrever um programa simples. Não se pode dizer depois deste artigo que se conhece PHP, mas se tem uma certa base. Ele pode escrever um programa pronto, e mudá-lo e melhorá-lo à medida que seu conhecimento cresce. Uma pessoa que domina uma linguagem de programação não precisa de mais nada para começar.

Há um jogo chamado Colobot onde você pode controlar robôs em C. O aprendizado da linguagem é baseado em tarefas muito simples e descomplicadas, e em apenas algumas missões, o jogador aprende toda a sintaxe C, princípios gerais de programação, e muito mais.

Em resumo, não concordo com você.

Além disso, há uma opinião bem fundamentada de que os criadores de produtos (programadores) não podem avaliar objetivamente os resultados de seu trabalho. Como eles vêem o sistema do ponto de vista de seu programador. Portanto, se você é um programador e criador do MT 4 e MQL, estamos falando idiomas diferentes com você. As empresas de software ocidentais há muito tempo contratam empresas terceirizadas e especialistas para estudar as necessidades dos consumidores em relação a um produto e avaliar objetivamente sua usabilidade e funcionalidade. Não me cabe a mim ensiná-los, é claro, mas só quero que entendam meu ponto de vista.
 
Renat:
É quase o mesmo que dizer à lei da gravidade: "Entenda, as pessoas não se movem bem, 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.
As pessoas têm lutado contra a gravidade desde o início dos tempos. A mudança de uma pá para um trator também é uma luta contra as leis da natureza. Por que você reage tão dolorosamente ao fato de que as pessoas querem arar com um trator em vez de cavar com uma pá? "Antes de cavar com uma pá, então não fique esperto e preguiçoso! Cava!"


Você está certo de que, em princípio, existe documentação suficiente para resolvê-la no final. Mas por que não tornar mais fácil para os novatos pegarem o jeito? Com base em um simples livro didático em C, pode-se escrever seu próprio livro didático, apenas esclarecendo a sintaxe, removendo o desnecessário e acrescentando as funções e exemplos necessários?

 
Renat:
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.

Bem, se o que eu escrevi não é suficiente ... Vá em frente.

1. O significado da variável range_index e sua conexão com o número de medição é descrito de forma incompreensível (para não dizer incompreensível).
2. Falta o resultado da amostra dada, o que torna impossível entender o que a função descrita faz. Geralmente, a saída dos resultados do exemplo é a melhor maneira de entender este exemplo e, portanto, o artigo de documentação. Portanto, esta produção deve estar presente sempre que possível.
3. Os dados do exemplo são tais que, mesmo com a saída dos resultados, não é possível entender o significado da função que está sendo descrita.

Todos estes são erros de documentação reais (embora não "explícitos"). Note que quando o programador usa palavras de linguagem reservada de forma incorreta, o programa não funciona. E quando o documentador não consegue expressar sua idéia corretamente no idioma em que está escrevendo a documentação, ela ainda funciona, mas muito pior.

Então o programador, enquanto depura o programa, modifica-o de acordo. Mas os usuários de documentação estão em uma situação pior. Eles, é claro, também aperfeiçoam sua compreensão da linguagem no processo de discussão com seu criador, mas, infelizmente, não podem forçá-lo a fazer a documentação completa. E se ele pensa: "Tudo bem, afinal eles vão descobrir. Então e se for difícil? Eles vão descobrir", então a situação é um beco sem saída.

Quanto tempo e esforço é desperdiçado de ambos os lados como resultado!!!
 
alex_ant:
Gostaria também de mencionar alguns fatos em minha defesa.

Há uma revista para jovens entusiastas de TI chamada "Hacker". Às vezes, esta revista consegue mostrar a um leitor, em uma única difusão, o básico de uma linguagem (por exemplo, PHP, ASP ou Object Pascal) e mostrar como se pode escrever um programa simples. Não se pode dizer depois deste artigo que se conhece PHP, mas se tem uma certa base. Ele pode escrever um programa pronto, e mudá-lo e melhorá-lo à medida que seu conhecimento cresce. Uma pessoa que domina uma linguagem de programação não precisa de mais nada para começar.

Há um jogo chamado Colobot onde você pode controlar robôs em C. O aprendizado da linguagem é baseado em tarefas muito simples e descomplicadas, e em apenas algumas missões, o jogador aprende toda a sintaxe C, princípios gerais de programação, e ainda mais.

Em resumo, não concordo com você.

Além disso, há uma opinião bem fundamentada de que os criadores de produtos (programadores) não podem avaliar objetivamente os resultados de seu trabalho. Porque eles vêem o sistema do ponto de vista de seu programador. Portanto, se você é um programador e criador do MT 4 e MQL, estamos falando idiomas diferentes com você. As empresas de software ocidentais há muito tempo contratam empresas terceirizadas e especialistas para estudar as necessidades dos consumidores em relação a um produto e avaliar objetivamente sua usabilidade e funcionalidade. Não me cabe a mim ensiná-los, é claro, mas só quero que entendam meu ponto de vista.
Peço desculpas de imediato por citar demais, mas todos estes são exemplos em defesa da MQ. Para Hacker não é um desenvolvedor PHP e Colobot não é um desenvolvedor C. Além disso, o consumidor paga dinheiro pelo Hacker e Colobot, há uma demanda solvente para PHP e C. Não há praticamente nenhuma demanda efetiva por livros didáticos, treinamentos e outras coisas de MQL. Há alguns comerciantes que não se preocupam com a documentação e pagam a um programador para fazer tudo. E há toda uma multidão de freeloaders que não querem gastar dinheiro, ou seja, não criam demanda efetiva, ou seu tempo e mão-de-obra para estudar o que está disponível, mas estão dispostos a chutar o desenvolvedor para fazer mais. A posição é sempre vencedora - exigir "mais" no abstrato é possível mesmo no paraíso.
 
Dmitrich:
Você está certo de que a documentação é, em princípio, suficiente para que, eventualmente, se apodere dela. Mas por que não tornar mais fácil para os novatos pegarem o jeito? Podemos escrever nosso próprio livro didático com base em algum livro simples em C, apenas esclarecendo a sintaxe, removendo funções e exemplos desnecessários e acrescentando as funções e exemplos necessários?
Porque o tutorial C mais simples é um projeto comercial, exigindo tempo e esforço. Nada nesta vida é livre, como já lhe foi dito muitas vezes. Você está pessoalmente pronto para trabalhar de graça em benefício de outros? Pode até estar em sua profissão principal, ou seja, apenas transferir todo o seu salário para uma conta de criação de livros didáticos. Conheço alguns editores de orçamento bastante baixo em Moscou que poderiam ajudá-lo a organizar o processo, os lucros da venda do livro didático seriam seus. Bem? Não? Alguém mais tem que pagar por você?

A propósito, "escreva seu próprio livro didático com base em algum livro simples em C, apenas refinando sua sintaxe, removendo funções desnecessárias e acrescentando exemplos e exemplos necessários" é chamado de roubo.
 
Yurixx:
Normalmente, um índice é uma variável que numera os elementos de uma matriz. Neste caso, não é um índice, mas um número índice. No entanto, a partir da frase "Como os índices começam de zero, o tamanho da dimensão é 1 a mais do que o maior índice. "nem isto nem nada mais pode ser compreendido. Especialmente para um iniciante.
Não sei como é "normalmente", mas soa compreensível em russo e para um iniciante. Há variáveis em um array, cada uma delas tem um código postal, ou seja, um número seqüencial. É isso aí. O que o número índice é uma floresta escura.
 
Apoiamos apaixonadamente a idéia de aprendizagem global (multilíngüe). Estamos investindo seriamente nossos recursos nisso. Já estamos atualizando as ajudas.

Mas na crítica, precisamos nos ater ao material factual e não nos transformar em reivindicações "universais/idealistas".
 
Razão: