If you're seeing this message, it means we're having trouble loading external resources on our website.

Se você está atrás de um filtro da Web, certifique-se que os domínios *.kastatic.org e *.kasandbox.org estão desbloqueados.

Conteúdo principal

O Poder da Documentação

Versão original criada por Pamela Fox.

Quer participar da conversa?

  • Avatar aqualine tree style do usuário Yuri
    Olá, pessoa!
    Qual o programa que vocês usam para nos ensinar programação??
    (14 votos)
    Avatar Default Khan Academy avatar do usuário
    • Avatar starky ultimate style do usuário Alexandre
      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)
  • Avatar piceratops seedling style do usuário Rafaela Rocha
    Alguém me ajuda no desafio: Um lindo dia?

    Pois não estou conseguindo!
    (9 votos)
    Avatar Default Khan Academy avatar do usuário
  • Avatar blobby green style do usuário vania.oi
    qual programa consegue fazer tudo isso, baixa o javascript?
    (8 votos)
    Avatar Default Khan Academy avatar do usuário
  • Avatar hopper cool style do usuário Deivison Takatu
    Eu devo documentar todo programa que eu faço?
    (5 votos)
    Avatar Default Khan Academy avatar do usuário
    • Avatar duskpin tree style do usuário Jonaquim4You
      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
      (4 votos)
  • Avatar piceratops seedling style do usuário Gabriel Santos
    alguem sabe algum programa pra baixar para fazer esses desenho no javascript?
    (4 votos)
    Avatar Default Khan Academy avatar do usuário
  • Avatar blobby green style do usuário mateuspoke08
    olá eu tenho 11 anos e quando crescer quero ser analista de sistemas e é muito bom saber disso pois facilitara meu futuro trabalho
    (3 votos)
    Avatar Default Khan Academy avatar do usuário
  • Avatar blobby green style do usuário THEODORO WILSON WILMAN
    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)
    Avatar Default Khan Academy avatar do usuário
  • Avatar piceratops seedling style do usuário SLAYER么
    o vídeo te dá 750 pontos mas se vc esperar acabar totalmente
    ele dá 850
    (3 votos)
    Avatar Default Khan Academy avatar do usuário
  • Avatar male robot donald style do usuário kauanramos.0303
    bem legal essa parte Documentação
    (2 votos)
    Avatar Default Khan Academy avatar do usuário
  • Avatar blobby green style do usuário TheInimaginable
    Tente fazer mais as aulas iniciais,,,e treine em cada documento o que acontece quando você altera os valores que tem nele, com o tempo vai pegando o jeito
    (2 votos)
    Avatar Default Khan Academy avatar do usuário
Você entende inglês? Clique aqui para ver mais debates na versão em inglês do site da Khan Academy.

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!