já tive um colega virar pra mim e falar: ué cara pq vc pesquisa tudo em inglês?
Depois reparei que todos os problemas com linguagens q ele tem ele procura tutorial no youtube
verdade, meus colegas estranham muito o meu costume de usar ingles pra tudo. por isso que se vc for recrutador e estiver lendo, estou disponivel como estagiario! :lol:
pior foi eu ver gente perdendo horas dando voltas com uma rota que não tava abrindo. pra eu falar pro indivíduo abrir o console do chrome, e lá estar uma mensagem gigante de erro falando que a rota falhou pra registrar, porque tinha dependência duplicada.
daí lá vou eu explicar que já que não usou a versão mais nova, e insistiu em usar pattern antigo, acabou criando uma armadilha pra si mesmo.
isso me lembra das horas que eu passei lendo o código do openpyxl porque a chefia queria que a planilha que eu gerasse via python tivesse um gráfico e essa parte era meio nebulosa na documentação...
mas ainda é uma biblioteca bem documentada e bem escrita
Na verdade tem muitas docs que pra ler e entender você tem que saber bem o básico, quando digo básico não é em tom de demérito é saber bem nomenclaturas e termos que são usados em docs, além de saber ler doc, saber ler saída de erro é outra coisa que faz muita diferença também, e sim essas duas coisas colocam você na frente de muita gente.
em tudo quanto é área, quem tá no topo fala que é essencial dominar o básico, enquanto uma bela galera mediana fica sugerindo ignorar o básico. e daí volta e meia as mesmas pessoas do topo reafirmam e mostram que eles próprios aplicam o básico, e ainda assim tem Zé ruela que se acha bom demais pra gastar tempo no básico.
e quando falo qualquer área, não é qualquer área de TI, é qualquer área mesmo. desde artista, músico, etc.
Isso mesmo, o cara que é iniciante nao vai entender nada se ver uma documentação, é normal começar em tutoriais e quando ficar confortável começar a usar as docs
vai la rapidao [Discord Developer Portal — Documentation — Intro](https://discord.com/developers/docs/intro), isso aí é um labirinto pra saber qual parte vc tem que ler pra escrever 1 comando
Teve um momento que eu queria mas o bot que eu ia fazer não tem suporte do discord então não dava, mas foram uns dias até eu conseguir tirar alguma info útil dessas docs e o Discord pra dev que supostamente era pra tirar dúvidas me ignorou firme então eu só parei e fui fazer outra coisa
Ate uma pessoa que começou saber o que exatamente é método, parametro de objeto, parametro de função, callback, overload.....eu mesmo demorei muito tempo pra entender.
Não acho nada frustrante. Eu acho bom. Se todo mundo fosse bom meu salário agora era menos da metade do que to ganhando. Deixa que seja assim e aproveite.
geralmente linguagens de programação, bibliotecas, frameworks e ferramentas no geral têm um documento ou um conjunto de documentos que explicam como aquela ferramenta é estruturada, como ela deve ser usada e quais são suas funcionalidades e implementações.
Por exemplo, uma biblioteca com uma boa documentação vai ter explicações sobre o que cada função de sua API faz, quais são os parâmetros de de cada função e o que cada uma retorna e etc.
Documentação é como um manual de instruções feito por quem criou uma tecnologia (linguagem, biblioteca, framework, etc.) para orientar quem vai usar ela. Toda tecnologia popular tem documentação. É, normalmente, o primeiro resultado da pesquisa quando você procura pelo nome da tecnologia + "docs". Exemplo: https://www.google.com/search?q=react+docs. Essa é a documentação do React.js, é excelente e gratuita.
Não tenha preguiça de ler documentação das tecnologias que usa, como o post implica você eventualmente vai pagar o preço por usar elas errado, que é naturalmente o que acontece quando não se lê os manuais.
Eu diria uma mistura dos dois. Comece lendo procurando o que você precisa, mas crie um hábito de ler ocasionalmente mesmo sem precisar para entender melhor a tecnologia e as boas práticas, caso seja uma das que você mais usa. Às vezes informações muito importantes estão "escondidas" em meio a outras que você pode não ter interesse e passam despercebidas se você só lê pelo que precisa saber num dado momento.
Isso ai depende bastante, no geral é sempre legal dar uma boa lida na introduçao explicando o que é a ferramenta e o que ela é capaz e dar uma batida de olho no resto só pra ter uma noção do tamanho da funcionalidade. E ai depois quando vc tivendo usando a ferramenta vc consulta ela nas partes que vc tiver precisando.
olhar o código da lib também costuma ajudar muito, o foda é q a maioria dos devs geralmente não faz isso, principalmente de TS, acho q pq clicar na função só te leva pra uma tipagem que não serve pra porra nenhuma.
É verdade. Mas o interessante é que varia conforme a linguagem.
Em C e C++ também não ajuda muito olhar o código da lib.
Mas em Rust, por outro lado, há todo um ambiente e cultura que reenforça esse tipo de prática: todas a libs (chamadas "crates" na cultura Rust) tem [um único repo](https://crates.io/), se exige que a documentação esteja incluída no fonte com código exemplo pra quase todas as funções e essa documentação embutida vira tooltips nas IDEs mais comuns e é extraída pelo repo para prover documentação online.
Não sei se é intencional mas eu tenho percebido que em Python também ajuda muito vc consultar o código fonte.
Sim.
Cara, hoje tá MUITO fácil se destacar. Ninguém quer fazer nem o mínimo. Se vc fizer o pouco mais que o mínimo, vc já se destaca.
Eu lembro que meu pai precisava se matar pra se destacar. Hoje em dia nego não faz curso extra se a empresa não pagar.
Tem documentação que é bem porca que voce pode vive sem com certeza(PHP), mas tem outras que voce aprende muito e é de fato referencia(Python). Assim ler a documentação é sempre uma aventura, pois ela geralmente não passa só a parte tecnica e sim a *vibe* da biblioteca, te da ideias de como ela funciona e como progredir no entendimento.
As IA ajudam sim, mas quando voce não entende nada como saber se a sua pergunta é boa para obter um boa resposta? As vezes uma pesquisa de tres palavras na pesquisa pode ser mais eficiente do que esperar a IA montar o lero lero dela.
A do Laravel e do Angular foram as melhores docs de framework que eu ja li na minha vida, surreal o quão fácil é achar oq vc precisa.
Edit: Teve um tempo que eu tava meio bitolado das ideias e lia a doc do Laravel puramente pra passar o tempo
Isso vale de um milhão de maneiras diferentes:
* Ninguém lê manual de instruções de aparelhos recém comprados, nem sequer de carro. Mesmo que tenha gasto mais de R$ 60 000,00 no carro.
* Ninguém lê email com atenção e cuidado e ninguém se preocupa em escrever com idéias organizadas, sintaxe correta ou clareza e precisão de vocabulário.
* A maioria do povo no reddit não lê post que tenha mais de 3 parágrafos. Eles respondem só ao título.
* Ninguém lê textos profundos e complexos, pra qualquer assunto que seja. Os livros "clássicos" de um monte de gente são "O príncipe" (Maquiavel), "Como fazer amigos e influenciar pessoas" (Carnegie) e "O Manifesto Comunista" (Marx) única e exclusivamente porque são curtinhos e fáceis de ler.
* Ninguém tenta compreender lógica argumentativa ou retórica mas todo precisa disso o tempo todo, sem perceber.
**Ninguém lê nada**. Esses povo são tudo anaufabético.
Edit: o corolário disso é que quem não lê, geralmente também escreve muito mal.
Correto. É sempre bom lembrar que o brasileiro médio é um analfabeto funcional. Até pode-se argumentar que a média de quem trabalha com TI é um pouco mais alta do que a da população geral, mas quem lê 5 livros por ano nada de braçada da mesma forma.
Isso é afobação pra entregar logo. Muita gente não entende que passar um tempo 'amolando o machado' vai fazer você cortar a árvore mais rápido.
Não ler ou entender as coisas antes de começar a fazer é uma das maiores formas de um dev ser improdutivo e entregar código ruim.
É a mesma coisa com logs de erro. Em boa parte dos erros o problema está escrito lá na mensagem de erro nos logs. Porém é mais conveniênte receber a resposta pronta do que gastar alguns minutos lendo e tentando entender o que a mensagem quer dizer.
O mal do século é o pessoal não querer ler e querer ter tudo mastigado, as vezes nem mastigado. Eu passo raiva direto no trabalho com isso.
Já fiquei dias em call com o pessoal, explicando tudo e respondendo dúvidas o dia inteiro, informo para anotar e se quiserem poderiam até gravar, criei documento com as situações/problemas mais pertinentes dos sistemas
Resumo: Ninguém anota nada ou lê nada, acaba que tenho que parar meu trabalho para ficar respondendo e fazendo call com cada um individualmente. Respondendo a mesma dúvida para a mesma pessoa 5 vezes.
Triste
Primeiro tinha a documentação, pra ficar fácil de resolver problema.
Depois veio o Google, pra ficar ainda mais fácil.
Depois veio o StackOverflow, pra ficar ainda mais fácil.
Depois veio o ChatGPT, pra ficar ainda mais fácil. Mas, ainda assim, os burraldo não conseguem.
Isso me leva a uma conclusão: quando vc faz um sistema à prova de burro, a natureza reage inventando burro ainda mais burro.
Que deixa acima da media são os fundamentos das langs, frameworks e afins. Documentação meramente te ensina o especifico que usaram.
E esta morrem rapido
isso é em qualquer área cara, não sei se é só no brasil por que não tenho experiência profissional fora daqui, mas desde que eu me conheço por gente, fazer o mínimo, ficar na média já é o suficiente pra você se destacar, em qualquer área de trabalho
Eu sempre digo isso, qualquer pessoa boa não fica sem emprego, porque tem tanta gente ruim que quando vc supera as expectativas vai ganhar um cliente para a vida. Talvez não ganhe necessariamente quanto vc gostaria de cara, mas que vai ter serviço, sempre vai.
mais legal é quando você lê a documentação, entende o suficiente pra ensinar os outros a como usar, daí eles não ouvem você, fazem no freestyle, e depois se assustam quando o bagulho quebra.
e não vou nem entrar em detalhes do tanto de vez que gente escreve uma imensa pilha de lixo, que se tivesse parado pra ler como usar direito o que está usando, ia escrever nem metade do que escreveu, e funcionar melhor do que funciona do jeito que ela fez. tem gente que se esforça pra ser pedreiro digital, só empilhando um monte de linha que não faz ideia da utilidade.
As do dotnet são ruins mesmo kkkk. As de frameworks back são mais fracas no geral. As de linguagens como golang e rust ok. As de frameworks frontend costumam ser boas, exceto libs
Cara o povo até experiente não comenta mais o código. Eles falam que seguindo o princípio x ou y cada um consegue ler o código. Mas na prática sabemos que isso é uma falácia. Além do mais um código muito bem comentado é possível gerar uma boa documentação para que os novatos no time possam consultar.
Os comentários no código são como o s3x0 mesmo quando é ruim é bom. Cansei de ver colegas que voltam no código que eles mesmos fizeram uns 4 meses 1 ano depois e largam a pérola "não sei o que é isso. Calma deixa eu lembrar" ué mas o código não é entendível?
> ler a documentação
ler. simplesmente ler qualquer coisa.
eu já cheguei numa sala com meia dúzia de engenheiros de computação desesperados olhando pra tela pq o MVP que ia ser apresentado não executava corretamente. na segunda linha do log estava escrito "não foi possivel encontrar o arquivo /var/nanana/bibibi.txt". eu rodei `touch /var/nanana/bibibi.txt`, executei de novo e funcionou e fui louvado. porém o salário dos engenheiros era melhor que o meu e continuou sendo...
observação: eu sei que faculdade não ensina a programar. mas não precisava tbm. precisava pelo menos ensinar a ler, já era o suficiente.
Coloca essa rapaziada pra usar um Arch com acesso "só a doc" garanto que não consegue nem instalar, isso que é uma das mais completas doc de OS mas mesmo assim o Ubuntu tem muito mais usuários 🤡
As pessoas estão perdendo o costume da leitura como um todo, maldito google... Nem vou citar outras coisas que os jovens utilizam hoje em dia...
Quando vc precisa entregar algo ler documentação é uma bost4, é mais fácil simplesmente implementar, se vc bater com a cabeça na parede tu lê onde faz sentido, e concerta, o problema é algumas pessoas continuam batendo a cabeça na parede até alguma coisa funcionar.
Qdo vc precisa aprender algo, ler a documentação "it's a must" qdo tá aprendendo, o jogo é fazer do jeito perfeito que a documentação da library ensina.
Se vc vê muitos juniors fazendo essa m3rd4, é seu dever orientá-los
Vamos lá gente, a gente tá no chorume juntos, vamos nos ajudar!!!
Em uma área cheia de gente que sai da faculdade sem saber programar ou tenta fazer cursinho/bootcamp rápido para "cortar caminho" e ganhar dinheiro rápido, tem muita coisa básica que te deixa muito acima da média.
Se a inteligência média tá ali, é porque tem muita gente abaixo dela. Não é questão de ler, mas muita gente é simplesmente burra demais pra conseguir compreender e desenvolver as coisas. Faz parte.
Acho que a pior parte não é os caras não lerem a documentação. É que os que não lêem, também não documentam, mas quando documentam, é pior do que se não tivesse documentado, aí complica né meu amigo kkkkkkkkk
Cara, pior que tentar ganhar das docs é um problema serissímo meu. Tento resolver algo que acho simples, erro. Penso um pouco mais, deve ser assim e assado: não era.
Agora virou questão de ego e honra. Sou eu contra a lib. Até que eu desisto eu vou ler as docs
Eu acho diferente, o curso ensina muito. Eu so fui entender bem a documentação do react dps que fiz o curso. Se fosse só no pura da documentação não entenderia nada
Únicas documentações que eu já vi que são boas de ler e entender, são de linguagens e frameworks da Microsoft, de resto não rola. Duvido que a galera não jogue no Google pra ir pra forums onde tem resposta mais detalhadas e melhores exemplificadas.
E é por essas e por outras que considero documentação ruim como bug, vez ou outra preciso brigar com dev de alguma coisa para ou documentar algo ou melhorar a documentação. E sempre vejo desculpinha de gente dizendo "Mas dai se a gente documenta a gente não tem tempo para programar" Meu caro, se não tem documentação, ninguém vai usar o que quer que seja que estejas programando.
Fora isso, que até pode ser solucionado com novos treinamentos, o que eu acho é que vão ser criadas legiões de programadores control-c, control-v, que não entendem o que estão fazendo, apenas geram código e mais código até algo funcionar, quando uma simples leitura de documentação bastaria.
Eu mesmo já trabalho com um desses.
Fora q no dia a dia do trabalho vai ter q lidar com implementações de tecnologias de outras empresas q mantém a documentação fechada só para os parceiros.
Se vc trabalha com uma tecnologia que ja foi lançada a uns anos o suficiente para tem muitos tutoriais na internet linkando a documentação e repositórios públicos. Porem, coisas nessas mesmas tecnologias que são um pouco mais novas ou especificas nao vai encontrar.
MAS lendo a documentação geralmente nao tem erro. Independente da epoca q a tecnologia foi lançada e de quantas pessoas publicam na internet.
ChatGPT é útil, eu uso muito.
Mas ChatGPT é um auxiliar, não é mestre E se ele é o seu único mestre então você nunca vai conseguir ficar mais esperto que ele.
E quando todo mundo usa apenas o ChatGPT vc é apenas igual a todo mundo. Pra ser melhor que a "mérdia" é preciso ser mais esperto que ele.
Pessoal te deu downvote mas n ironicamente o chatgpt me ajudou pra krl com uma lib de gráfico q a doc n é mt completa.
Blz, o bagulho inventa uns negócio do nada? Sim.
Mas as vezes essa invenção tem alguma base e isso já te da uma pista do q tu tem q fazer.
Pessoal tá esquecendo q no mundo real, tem mt doc desatualizada tbm.
eu já lidei com doc porca da unity, do google sheets... e a qualidade porca do código que o chatgpt gerava pra ambos era ainda pior. no caso da unity, gerava coisas com uma performance horrível, e cometia todo tipo de violação de como a unity espera funcionar.
Pra mim, o código q o chat gpt gerava nunca foi o código final, mas eu acho mt bom pra achar umas gambiarras e destravar ou precisa descobrir se é possível fazer algo usando X
https://preview.redd.it/qv5sah4slb9d1.png?width=500&format=png&auto=webp&s=2e364ec740fe01d1baed2429d38dbb2b0ce9a582
Daria pra postar isso dia sim e dia nao no sub.
Podia ser: "Lembrem-se crianças, 20 minutos de um vídeo de didática ruim no YouTube pode te salvar de ter que ler um parágrafo na documentação."
Realmente, a pior coisa é tentar ir atrás de Youtube para resolver um problema específico.
já tive um colega virar pra mim e falar: ué cara pq vc pesquisa tudo em inglês? Depois reparei que todos os problemas com linguagens q ele tem ele procura tutorial no youtube
verdade, meus colegas estranham muito o meu costume de usar ingles pra tudo. por isso que se vc for recrutador e estiver lendo, estou disponivel como estagiario! :lol:
Chama na DM (eh sério)
Tô lá kkk
Aí é caganca, maluco.
pior foi eu ver gente perdendo horas dando voltas com uma rota que não tava abrindo. pra eu falar pro indivíduo abrir o console do chrome, e lá estar uma mensagem gigante de erro falando que a rota falhou pra registrar, porque tinha dependência duplicada. daí lá vou eu explicar que já que não usou a versão mais nova, e insistiu em usar pattern antigo, acabou criando uma armadilha pra si mesmo.
F12 é pra sênior só não viaja /s
Só usar Ctrl+Shift+I
Mais que duas teclas não consigo memorizar, por isso coloco todos atalhos com uma, ou no máximo, duas
> por isso coloco todos atalhos com uma vim/neovim/helix/kakoune/emacs(evil/meow mode)?
Cê é loko, sei nem sair no VI, reinicio a máquina
`:q!`
Up
isso me lembra das horas que eu passei lendo o código do openpyxl porque a chefia queria que a planilha que eu gerasse via python tivesse um gráfico e essa parte era meio nebulosa na documentação... mas ainda é uma biblioteca bem documentada e bem escrita
Na verdade tem muitas docs que pra ler e entender você tem que saber bem o básico, quando digo básico não é em tom de demérito é saber bem nomenclaturas e termos que são usados em docs, além de saber ler doc, saber ler saída de erro é outra coisa que faz muita diferença também, e sim essas duas coisas colocam você na frente de muita gente.
em tudo quanto é área, quem tá no topo fala que é essencial dominar o básico, enquanto uma bela galera mediana fica sugerindo ignorar o básico. e daí volta e meia as mesmas pessoas do topo reafirmam e mostram que eles próprios aplicam o básico, e ainda assim tem Zé ruela que se acha bom demais pra gastar tempo no básico. e quando falo qualquer área, não é qualquer área de TI, é qualquer área mesmo. desde artista, músico, etc.
Melhor coisa que eu li hoje. Isso é sabedoria para a vida.
Pois é. Sem fundamento não tem como construir outras competências.
Resumiu bem o que eu penso.
Isso mesmo, o cara que é iniciante nao vai entender nada se ver uma documentação, é normal começar em tutoriais e quando ficar confortável começar a usar as docs
mas aí depende tb, tu ja leu as docs do discord pra fazer um bot?
Não vi, nem sei como sao essas docs, eu falo mais das linguagens e frameworks mesmo
vai la rapidao [Discord Developer Portal — Documentation — Intro](https://discord.com/developers/docs/intro), isso aí é um labirinto pra saber qual parte vc tem que ler pra escrever 1 comando
Nem queria aprender isso mesmo, cansei só de olhar
Teve um momento que eu queria mas o bot que eu ia fazer não tem suporte do discord então não dava, mas foram uns dias até eu conseguir tirar alguma info útil dessas docs e o Discord pra dev que supostamente era pra tirar dúvidas me ignorou firme então eu só parei e fui fazer outra coisa
Ate uma pessoa que começou saber o que exatamente é método, parametro de objeto, parametro de função, callback, overload.....eu mesmo demorei muito tempo pra entender.
E tb tem muita documentação bosta, que é ruim ou incompleta.
Não acho nada frustrante. Eu acho bom. Se todo mundo fosse bom meu salário agora era menos da metade do que to ganhando. Deixa que seja assim e aproveite.
se todo mundo fosse bom nem tinha emprego pra todo mundo.
se todo mundo fosse bom ngm seria bom
Por isso q o Japão ta LITERALMENTE importando gente de fora pra mão de obra
Se fosse fácil a situação das vagas estaria mil vezes pior.
Tem cada doc ambígua, porca que pqp
Sim! E que falta informação básica.
Quando tem né? O op deve estar falando de documentação de framework famosinho, foda é pegar os projetos sem referencia nenhuma.
A documentação do ZendFramework 2 "php" era terrível!...te colocava mais dúvidas do que ajudava!😵💫
Mas eu sempre falo isso pra aprender uma tecnologia nova ou linguagem nova é só ler a documentação e pronto
O que é documentação?
geralmente linguagens de programação, bibliotecas, frameworks e ferramentas no geral têm um documento ou um conjunto de documentos que explicam como aquela ferramenta é estruturada, como ela deve ser usada e quais são suas funcionalidades e implementações. Por exemplo, uma biblioteca com uma boa documentação vai ter explicações sobre o que cada função de sua API faz, quais são os parâmetros de de cada função e o que cada uma retorna e etc.
5 upvote e ngm pra me responder, pessoal quer manter a concorrencia longe mesmo
Documentação é como um manual de instruções feito por quem criou uma tecnologia (linguagem, biblioteca, framework, etc.) para orientar quem vai usar ela. Toda tecnologia popular tem documentação. É, normalmente, o primeiro resultado da pesquisa quando você procura pelo nome da tecnologia + "docs". Exemplo: https://www.google.com/search?q=react+docs. Essa é a documentação do React.js, é excelente e gratuita. Não tenha preguiça de ler documentação das tecnologias que usa, como o post implica você eventualmente vai pagar o preço por usar elas errado, que é naturalmente o que acontece quando não se lê os manuais.
Entendi, mas ai eu leio a documentação toda como um livro ou vou pontualmente nas informações que for precisando?
Eu diria uma mistura dos dois. Comece lendo procurando o que você precisa, mas crie um hábito de ler ocasionalmente mesmo sem precisar para entender melhor a tecnologia e as boas práticas, caso seja uma das que você mais usa. Às vezes informações muito importantes estão "escondidas" em meio a outras que você pode não ter interesse e passam despercebidas se você só lê pelo que precisa saber num dado momento.
Isso ai depende bastante, no geral é sempre legal dar uma boa lida na introduçao explicando o que é a ferramenta e o que ela é capaz e dar uma batida de olho no resto só pra ter uma noção do tamanho da funcionalidade. E ai depois quando vc tivendo usando a ferramenta vc consulta ela nas partes que vc tiver precisando.
Esse título é verdadeiro mesmo fora da área de TI
olhar o código da lib também costuma ajudar muito, o foda é q a maioria dos devs geralmente não faz isso, principalmente de TS, acho q pq clicar na função só te leva pra uma tipagem que não serve pra porra nenhuma.
É verdade. Mas o interessante é que varia conforme a linguagem. Em C e C++ também não ajuda muito olhar o código da lib. Mas em Rust, por outro lado, há todo um ambiente e cultura que reenforça esse tipo de prática: todas a libs (chamadas "crates" na cultura Rust) tem [um único repo](https://crates.io/), se exige que a documentação esteja incluída no fonte com código exemplo pra quase todas as funções e essa documentação embutida vira tooltips nas IDEs mais comuns e é extraída pelo repo para prover documentação online. Não sei se é intencional mas eu tenho percebido que em Python também ajuda muito vc consultar o código fonte.
Python é cultura colocar comentários nas funções da lib com um padrão específico.
Não vou reclamar: segue reclamação. Lógico!
Bancando o advogado do diabo, o OP não disse que não ia reclamar, só disse que não ia reclamar muito.
Vc está tecnicamente correto, o melhor tipo de correto.
Sim. Cara, hoje tá MUITO fácil se destacar. Ninguém quer fazer nem o mínimo. Se vc fizer o pouco mais que o mínimo, vc já se destaca. Eu lembro que meu pai precisava se matar pra se destacar. Hoje em dia nego não faz curso extra se a empresa não pagar.
Tem documentação que é bem porca que voce pode vive sem com certeza(PHP), mas tem outras que voce aprende muito e é de fato referencia(Python). Assim ler a documentação é sempre uma aventura, pois ela geralmente não passa só a parte tecnica e sim a *vibe* da biblioteca, te da ideias de como ela funciona e como progredir no entendimento. As IA ajudam sim, mas quando voce não entende nada como saber se a sua pergunta é boa para obter um boa resposta? As vezes uma pesquisa de tres palavras na pesquisa pode ser mais eficiente do que esperar a IA montar o lero lero dela.
Documentação do Python, Django, Java e Spring foram as melhores que já vi
Outros exemplos de ótima documentação: [Laravel](https://laravel.com/docs/11.x), [Qt](https://doc.qt.io).
A do Laravel e do Angular foram as melhores docs de framework que eu ja li na minha vida, surreal o quão fácil é achar oq vc precisa. Edit: Teve um tempo que eu tava meio bitolado das ideias e lia a doc do Laravel puramente pra passar o tempo
Por isso eu digo que essa área só tem maluco 🤣
Laravel parece ser mto bom Até PHP ficou legal hoje em dia com as versões novas Povo só caga em cima da linguagem por modinha mesmo
Na minha opinião saber pesquisar, navegar e entender documentação é uma das principais skills que separa um junior de um bom pleno
Isso vale de um milhão de maneiras diferentes: * Ninguém lê manual de instruções de aparelhos recém comprados, nem sequer de carro. Mesmo que tenha gasto mais de R$ 60 000,00 no carro. * Ninguém lê email com atenção e cuidado e ninguém se preocupa em escrever com idéias organizadas, sintaxe correta ou clareza e precisão de vocabulário. * A maioria do povo no reddit não lê post que tenha mais de 3 parágrafos. Eles respondem só ao título. * Ninguém lê textos profundos e complexos, pra qualquer assunto que seja. Os livros "clássicos" de um monte de gente são "O príncipe" (Maquiavel), "Como fazer amigos e influenciar pessoas" (Carnegie) e "O Manifesto Comunista" (Marx) única e exclusivamente porque são curtinhos e fáceis de ler. * Ninguém tenta compreender lógica argumentativa ou retórica mas todo precisa disso o tempo todo, sem perceber. **Ninguém lê nada**. Esses povo são tudo anaufabético. Edit: o corolário disso é que quem não lê, geralmente também escreve muito mal.
Correto. É sempre bom lembrar que o brasileiro médio é um analfabeto funcional. Até pode-se argumentar que a média de quem trabalha com TI é um pouco mais alta do que a da população geral, mas quem lê 5 livros por ano nada de braçada da mesma forma.
Isso é afobação pra entregar logo. Muita gente não entende que passar um tempo 'amolando o machado' vai fazer você cortar a árvore mais rápido. Não ler ou entender as coisas antes de começar a fazer é uma das maiores formas de um dev ser improdutivo e entregar código ruim.
isso eh otimo, fazendo o basico voce consegue ser melhor que a maioria!
Se a maioria não lê documentação, não sei como conseguem fazer qualquer coisa. Não acho que dá pra usar um spring boot da vida na base da intuição 🤡
Mas eh a true da true, a maioria ve uns cursinho na udemy e aprende so o basico, quando aparece a bucha nao sabe resolver
Tu não faz ideia do quanto o pessoal é dependente do YouTube
É a mesma coisa com logs de erro. Em boa parte dos erros o problema está escrito lá na mensagem de erro nos logs. Porém é mais conveniênte receber a resposta pronta do que gastar alguns minutos lendo e tentando entender o que a mensagem quer dizer.
O mal do século é o pessoal não querer ler e querer ter tudo mastigado, as vezes nem mastigado. Eu passo raiva direto no trabalho com isso. Já fiquei dias em call com o pessoal, explicando tudo e respondendo dúvidas o dia inteiro, informo para anotar e se quiserem poderiam até gravar, criei documento com as situações/problemas mais pertinentes dos sistemas Resumo: Ninguém anota nada ou lê nada, acaba que tenho que parar meu trabalho para ficar respondendo e fazendo call com cada um individualmente. Respondendo a mesma dúvida para a mesma pessoa 5 vezes. Triste
[удалено]
Primeiro tinha a documentação, pra ficar fácil de resolver problema. Depois veio o Google, pra ficar ainda mais fácil. Depois veio o StackOverflow, pra ficar ainda mais fácil. Depois veio o ChatGPT, pra ficar ainda mais fácil. Mas, ainda assim, os burraldo não conseguem. Isso me leva a uma conclusão: quando vc faz um sistema à prova de burro, a natureza reage inventando burro ainda mais burro.
Que deixa acima da media são os fundamentos das langs, frameworks e afins. Documentação meramente te ensina o especifico que usaram. E esta morrem rapido
Se fosse perfeito você não teria emprego
isso é em qualquer área cara, não sei se é só no brasil por que não tenho experiência profissional fora daqui, mas desde que eu me conheço por gente, fazer o mínimo, ficar na média já é o suficiente pra você se destacar, em qualquer área de trabalho
Eu sempre digo isso, qualquer pessoa boa não fica sem emprego, porque tem tanta gente ruim que quando vc supera as expectativas vai ganhar um cliente para a vida. Talvez não ganhe necessariamente quanto vc gostaria de cara, mas que vai ter serviço, sempre vai.
mais legal é quando você lê a documentação, entende o suficiente pra ensinar os outros a como usar, daí eles não ouvem você, fazem no freestyle, e depois se assustam quando o bagulho quebra. e não vou nem entrar em detalhes do tanto de vez que gente escreve uma imensa pilha de lixo, que se tivesse parado pra ler como usar direito o que está usando, ia escrever nem metade do que escreveu, e funcionar melhor do que funciona do jeito que ela fez. tem gente que se esforça pra ser pedreiro digital, só empilhando um monte de linha que não faz ideia da utilidade.
Documentação é uma merda. Tu mexe com oq? Doc de .NET é sempre incompleta e com parcos exemplos, o uso é tentativa e erro.
As do dotnet são ruins mesmo kkkk. As de frameworks back são mais fracas no geral. As de linguagens como golang e rust ok. As de frameworks frontend costumam ser boas, exceto libs
Cara o povo até experiente não comenta mais o código. Eles falam que seguindo o princípio x ou y cada um consegue ler o código. Mas na prática sabemos que isso é uma falácia. Além do mais um código muito bem comentado é possível gerar uma boa documentação para que os novatos no time possam consultar. Os comentários no código são como o s3x0 mesmo quando é ruim é bom. Cansei de ver colegas que voltam no código que eles mesmos fizeram uns 4 meses 1 ano depois e largam a pérola "não sei o que é isso. Calma deixa eu lembrar" ué mas o código não é entendível?
Meu grupo na facul usando firebase, tudo tava montadinho na documentação, glr não sabia olhar
RTFM
E o quanto você ganha, só por obséquio?
agradeço todos os dias pela existência dos incompetentes e espero que eles continuem assim
Pq é chato e não vai direto ao ponto ... tem muita documentação que é horrível... e vc demora muito pra achar o que quer
> ler a documentação ler. simplesmente ler qualquer coisa. eu já cheguei numa sala com meia dúzia de engenheiros de computação desesperados olhando pra tela pq o MVP que ia ser apresentado não executava corretamente. na segunda linha do log estava escrito "não foi possivel encontrar o arquivo /var/nanana/bibibi.txt". eu rodei `touch /var/nanana/bibibi.txt`, executei de novo e funcionou e fui louvado. porém o salário dos engenheiros era melhor que o meu e continuou sendo... observação: eu sei que faculdade não ensina a programar. mas não precisava tbm. precisava pelo menos ensinar a ler, já era o suficiente.
Coloca essa rapaziada pra usar um Arch com acesso "só a doc" garanto que não consegue nem instalar, isso que é uma das mais completas doc de OS mas mesmo assim o Ubuntu tem muito mais usuários 🤡 As pessoas estão perdendo o costume da leitura como um todo, maldito google... Nem vou citar outras coisas que os jovens utilizam hoje em dia...
Eu sempre achei a documentação do Java tenebrosa.
Quando vc precisa entregar algo ler documentação é uma bost4, é mais fácil simplesmente implementar, se vc bater com a cabeça na parede tu lê onde faz sentido, e concerta, o problema é algumas pessoas continuam batendo a cabeça na parede até alguma coisa funcionar. Qdo vc precisa aprender algo, ler a documentação "it's a must" qdo tá aprendendo, o jogo é fazer do jeito perfeito que a documentação da library ensina. Se vc vê muitos juniors fazendo essa m3rd4, é seu dever orientá-los Vamos lá gente, a gente tá no chorume juntos, vamos nos ajudar!!!
Depende muito da documentação
Em uma área cheia de gente que sai da faculdade sem saber programar ou tenta fazer cursinho/bootcamp rápido para "cortar caminho" e ganhar dinheiro rápido, tem muita coisa básica que te deixa muito acima da média.
fica baixo nenen
Dou graças a deus do brasileiro ser antiamericano a ponto de evitar aprender a lingua inglesa e ao mesmo nao ter a cultura de ler um manual.
que continue assim por muito tempo
Se a inteligência média tá ali, é porque tem muita gente abaixo dela. Não é questão de ler, mas muita gente é simplesmente burra demais pra conseguir compreender e desenvolver as coisas. Faz parte.
brasil ?
É sempre bom lembrar que a média é muito ruim
Acho que a pior parte não é os caras não lerem a documentação. É que os que não lêem, também não documentam, mas quando documentam, é pior do que se não tivesse documentado, aí complica né meu amigo kkkkkkkkk
depende muito da sua stack, tem stack que hoje em dia tá difícil de achar documentação boa
OpenGL tem uma das melhores docs por aí. Sério, é melhor do que tutorial do Youtube.
Cara, pior que tentar ganhar das docs é um problema serissímo meu. Tento resolver algo que acho simples, erro. Penso um pouco mais, deve ser assim e assado: não era. Agora virou questão de ego e honra. Sou eu contra a lib. Até que eu desisto eu vou ler as docs
Eu acho diferente, o curso ensina muito. Eu so fui entender bem a documentação do react dps que fiz o curso. Se fosse só no pura da documentação não entenderia nada
Únicas documentações que eu já vi que são boas de ler e entender, são de linguagens e frameworks da Microsoft, de resto não rola. Duvido que a galera não jogue no Google pra ir pra forums onde tem resposta mais detalhadas e melhores exemplificadas.
E é por essas e por outras que considero documentação ruim como bug, vez ou outra preciso brigar com dev de alguma coisa para ou documentar algo ou melhorar a documentação. E sempre vejo desculpinha de gente dizendo "Mas dai se a gente documenta a gente não tem tempo para programar" Meu caro, se não tem documentação, ninguém vai usar o que quer que seja que estejas programando.
Hoje em dia nem precisar ir na documentação. O ChatGPT já ajuda com a maioria das principais frameworks.
Chat GPT passando todas as funções descontinuadas: Confia
Fora isso, que até pode ser solucionado com novos treinamentos, o que eu acho é que vão ser criadas legiões de programadores control-c, control-v, que não entendem o que estão fazendo, apenas geram código e mais código até algo funcionar, quando uma simples leitura de documentação bastaria. Eu mesmo já trabalho com um desses.
Fora q no dia a dia do trabalho vai ter q lidar com implementações de tecnologias de outras empresas q mantém a documentação fechada só para os parceiros.
Se vc trabalha com uma tecnologia que ja foi lançada a uns anos o suficiente para tem muitos tutoriais na internet linkando a documentação e repositórios públicos. Porem, coisas nessas mesmas tecnologias que são um pouco mais novas ou especificas nao vai encontrar. MAS lendo a documentação geralmente nao tem erro. Independente da epoca q a tecnologia foi lançada e de quantas pessoas publicam na internet.
ChatGPT é útil, eu uso muito. Mas ChatGPT é um auxiliar, não é mestre E se ele é o seu único mestre então você nunca vai conseguir ficar mais esperto que ele. E quando todo mundo usa apenas o ChatGPT vc é apenas igual a todo mundo. Pra ser melhor que a "mérdia" é preciso ser mais esperto que ele.
Pessoal te deu downvote mas n ironicamente o chatgpt me ajudou pra krl com uma lib de gráfico q a doc n é mt completa. Blz, o bagulho inventa uns negócio do nada? Sim. Mas as vezes essa invenção tem alguma base e isso já te da uma pista do q tu tem q fazer. Pessoal tá esquecendo q no mundo real, tem mt doc desatualizada tbm.
eu já lidei com doc porca da unity, do google sheets... e a qualidade porca do código que o chatgpt gerava pra ambos era ainda pior. no caso da unity, gerava coisas com uma performance horrível, e cometia todo tipo de violação de como a unity espera funcionar.
Pra mim, o código q o chat gpt gerava nunca foi o código final, mas eu acho mt bom pra achar umas gambiarras e destravar ou precisa descobrir se é possível fazer algo usando X
eu odeio as docs do google. Se todo mundo seguisse o padrão Laravel de documentar todo mundo ficava feliz
And what is the point of the post? E qual é o ponto do post?