Conteúdo principal
O Poder da Documentação
Versão original criada por Pamela Fox.
Quer participar da conversa?
- Olá, pessoa!
Qual o programa que vocês usam para nos ensinar programação??(15 votos)- Uma boa pedida para quem está aprendendo programação é usar programas com colorização de sintaxe, que deixam os textos coloridos, assim fica mais fácil de ver onde se está errando, eu aconselho para javascript o sublime que é gratuito. Vale a pena dar uma olhada,(observação: você tem que salvar o documento para o texto ficar colorido).(16 votos)
- o vídeo te dá 750 pontos mas se vc esperar acabar totalmente
ele dá 850(9 votos) - Alguém me ajuda no desafio: Um lindo dia?
Pois não estou conseguindo!(9 votos)- backgroud tem que estar no topo, se não ele vai cobrir algo... OU TUDO,(3 votos)
- qual programa consegue fazer tudo isso, baixa o javascript?(8 votos)
- Vá em Novo Projeto na página inicial da Khan Academy!(3 votos)
- Eu devo documentar todo programa que eu faço?(5 votos)
- Acho que o que ele quis dizer no vídeo é para você documentar os tipos de comandos que existem, e documentar certas funções específicas que você pode esquecer ao decorrer do tempo(5 votos)
- olá eu tenho 11 anos e quando crescer quero ser analista de sistemas e é muito bom saber disso pois facilitara meu futuro trabalho(4 votos)
- Que legal já está pensando no futuro e se preparando. Parabéns!(2 votos)
- alguem sabe algum programa pra baixar para fazer esses desenho no javascript?(4 votos)
- O códigos aprendidos aqui podem ser exportado para outros programas?(3 votos)
- Alguém ai após concluido o curso da Khan ja consegue criar algo no visual studio code ou no 2019?
Ou seja, o curso ajuda a entender como usar o programa visual studio?(3 votos)- também queria saber(1 voto)
- Obrigado pela aula, achava bem chato ler documentação mesmo HAHAHAHA(2 votos)
Transcrição de vídeo
RKA11C Ok, você escreveu alguns programas,
mas deve estar se perguntando: "Como eu devo lembrar de todos esses comandos? O certo é oval, circle ou ellipse? É width e height, ou height e width? Eu tenho que memorizar tudo isso?"
Felizmente, não! É para isso que serve o computador. Acontece que nós sempre temos um computador conosco quando programamos, e um computador é muito bom em lembrar coisas, melhor que nós. E se fizéssemos o computador
lembrar dos detalhes para nós, e nós pudéssemos usá-lo
como uma referência para a programação? Então, poderíamos nos concentrar
em criar programas legais, e não em memorizar um monte de detalhes chatos. É isso o que chamamos de documentação. Um documento que explica como programar
em uma linguagem e um ambiente em particular, com exemplos e pegadinhas. Se não conseguirmos nos lembrar dos detalhes exatos, sem problemas, podemos simplesmente consultá-lo. Você pode pensar que é chato ler documentação...
e você está certo, é um pouco chato mesmo. É muito mais divertido escrever código! Mas, a não ser que você queira
memorizar absolutamente tudo, você precisa aprender a usar a documentação
ou ser capaz de programar suas ideias. Mesmo grandes programadores
não tentam memorizar tudo, na verdade, grandes programadores são algumas
das melhores pessoas em ler documentação. Por exemplo, eu estou desenhando este rosto aqui, sorridente, e eu já desenhei o rosto e os olhos usando ellipse,
uma função que eu conheço bem. Mas eu ainda tenho mais trabalho a fazer. Primeiro, quero desenhar o rosto
com contornos grossos, como um adesivo, e eu lembro que isso
tem alguma coisa a ver com stroke, mas eu não me lembro exatamente do nome. Então, em vez de sentar aqui e tentar inventar o nome,
o que pode demorar horas ou tempo infinito, vou até a aba "documentação" dar uma olhada, procurando o que preciso. Vou olhar para essa categoria de coloração,
porque ela parece relacionada, e vejo as funções aqui. Então, lá no final, encontro stroke weigth
para mudar a espessura de linhas e contornos. Aqui, nós vemos o nome da função e seus parâmetros... Apenas um neste caso. Em geral, o que eu faço é começar apenas copiando este código e colando no meu código. Mas eu imediatamente recebo um erro:
thickness não está definido. Isso acontece porque thickness é um parâmetro de exemplo, não é um valor de verdade. Eu preciso trocá-lo pelo valor
que eu quero que realmente seja, e isso pode ser com um número
ou com uma variável que se refere a um número. Bem, isso é um pouco extremo.
E este é pequeno demais... Enfim, vamos voltar para 12. Legal, agora existe algo muito óbvio
faltando nesse rosto: o sorriso. Eu basicamente preciso de algo assim, certo? E eu posso olhar para o sorriso e pensar: "Bem, não parece algo que eu desenharia usando ellipse, line ou rect, porque tem essa curva.
Mas ele não tem uma parte de dentro, então, eu penso:
"Bem, eu deveria olhar para a documentação e ver se existe alguma outra forma
de desenhar uma curva assim". Então, para a máquina de documentação! Rolando para baixo, rolando para baixo,
olhando por aqui... Então, olhando para a categoria de formas,
a primeira entrada é arc, que é usado para desenhar um arco,
o que soa perfeito, porque é isso que o sorriso é. Este aqui tem mais parâmetros. Eu vou começar colando isto aqui. Lembre-se: esses são parâmetros de exemplo, então, precisamos substituí-los pelo que
achamos que devem ser. Certo, então x e y. Talvez x e y seja onde eu quero começar. A nossa metade é 200,
talvez vamos começar em 150. O y é talvez 250,
então, width parece ser a espessura do arco. É provavelmente um pouco menos
que a espessura do próprio rosto. Talvez possa ser 200, então height talvez seja a altura a partir do topo do arco
até a parte de baixo. Talvez seja 50. Agora, start e stop... Eu não sei o que essas coisas são. Ok, estou preso aqui, porque estou
olhando para essa função, tentando usá-la, mas eu não compreendo realmente esses parâmetros. Bem, felizmente, o que você pode fazer
é apenas descer de novo até os documentos e clicar na função em que você está interessado. Isso fará aparecer um programa
que mostra como usá-la, e explica os parâmetros em mais detalhes. Olhando para isto, ele diz que x é a coordenada x do centro da elipse, derivada do arco. Então, para desenhar um arco,
você tem que fingir que está desenhando uma elipse, mas apenas a parte dela,
e calcular tudo baseado nisso. Então x e y é, na verdade, o centro dessa elipse
de mentirinha que estamos fazendo. E width e height são a largura e a altura dessa elipse. E start e stop, que são os que eu ainda não sabia, start e stop são os ângulos. Ok! O ângulo com o qual o arco se inicia, em graus,
e o ângulo onde o arco deve terminar. Nós podemos olhar para os exemplos que estão aqui
e desenhar um arco sem fio de 1 a 270. Provavelmente é este cara aqui, porque de 1 grau
a 270 graus ficaria mais ou menos assim. Vamos tentar mudar.
Agora sim, isso faz sentido, certo? Porque, de 1 a 180...
Isso é mais ou menos o que queremos, certo? Porque, não queremos um meio arco? Ok, então agora acho que entendo arc
bem o suficiente para usá-la. Vamos voltar para o rosto. Vamos de zero a 180. Nós quase acertamos,
mas o meu x e y estão errados. Porque eu não percebi que x é,
na verdade, o meio da elipse. Está um pouquinho largo demais,
então vamos reduzir isso. Eu tenho agora um sorriso de verdade! Usando a documentação, fui capaz de fazer
o que eu queria muito mais facilmente, e esse é o objetivo da programação: transformar nossas ideias em realidade
mais rapidamente. Lembre-se: o poder da documentação!