hrcerq
(usa Outra)
Enviado em 28/11/2018 - 21:13h
ssdhdvga escreveu:
Visto que o manual geralmente goza de termos que 90% dos usuários novatos olham e falam "mas que por** é essa, mermão?", eu cheguei à conclusão que não adianta de absolutamente ler o manual quando se é novato. Eu sou, e posso ler e reler o manual de algo como o git que não vou entender absolutamente nada, por não saber por exemplo o que é uma branch, work tree e nem pra que uso estas coisas. O que acham que pode ser feito para um novato realmente aprender algo?
Uma coisa precisa ficar clara: para que serve o man? A man page serve para ser um manual. E para que serve um manual? Ele oferece instruções sobre algo, mas não serve para ensinar conceitos. Como já disseram aqui, ele não é feito para ser um tutorial.
Pense por exemplo no manual de um carro. Ele te explica como funciona o carro: o que são os itens do painel, como fazer a troca de pneus, manutenções necessárias, etc. Ele não serve pra te ensinar as normas de trânsito. Não fala sobre o significado das placas, velocidade das vias, se deve fazer um caminho ou outro, pois essas informações você aprende em uma auto escola. São os conceitos do trânsito brasileiro, não especificações do seu veículo.
Então, de forma similar, a man page é uma especificação do utilitário e como você deve interagir com ele, mas não oferece conceitos relacionados. Alguns manuais até podem extrapolar a função deles e oferecer esse tipo de informação, mas isso já é um preciosismo do autor da man page, não uma obrigação dele.
Por isso eu digo que as man pages são muito úteis para novatos sim, mas
dentro da função deles. Se quiser aprender conceitos, deverá recorrer a livros e também os blogs, fóruns, wikis e outros recursos presentes na infosfera. No exemplo do git que você citou, o manual do git deve te ensinar a usar os utilitários do git, mas não tem o papel de te ensinar os conceitos desse controle de versionamento.
Muita gente reclama por pouco hoje em dia (não estou te acusando de fazer isso). Algumas décadas atrás, antes da explosão da Internet, não existiam muitas das facilidades que temos hoje, e nem por isso as coisas deixavam de ser feitas. Tudo o que temos hoje só existe porque alguém decidiu sentar e estudar, e botar a mão na massa em vez de reclamar sobre as dificuldades da vida, e assim continuará sendo.
---
Atenciosamente,
Hugo Cerqueira
Devuan -
https://devuan.org/
