From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../contribute/collaboration_tactics/index.html | 65 ++++ .../criando_e_editando_paginas/index.html | 147 ++++++++ files/pt-br/mdn/contribute/feedback/index.html | 60 ++++ .../mdn/contribute/getting_started/index.html | 136 +++++++ .../como-marcar-as-paginas-corretamente/index.html | 394 +++++++++++++++++++++ .../index.html | 43 +++ .../distant_example/index.html | 72 ++++ .../index.html | 185 ++++++++++ .../guia/create_an_mdn_account/index.html | 43 +++ .../guia/do_a_technical_review/index.html | 52 +++ .../guia/do_an_editorial_review/index.html | 55 +++ .../index.html | 114 ++++++ files/pt-br/mdn/contribute/guia/index.html | 8 + .../guia/set_the_summary_for_a_page/index.html | 61 ++++ .../guia/tag_javascript_pages/index.html | 84 +++++ .../guia/vincular_uma_conta_github/index.html | 113 ++++++ files/pt-br/mdn/contribute/index.html | 20 ++ .../mdn/contribute/persona_sign-in/index.html | 32 ++ files/pt-br/mdn/contribute/processos/index.html | 6 + 19 files changed, 1690 insertions(+) create mode 100644 files/pt-br/mdn/contribute/collaboration_tactics/index.html create mode 100644 files/pt-br/mdn/contribute/criando_e_editando_paginas/index.html create mode 100644 files/pt-br/mdn/contribute/feedback/index.html create mode 100644 files/pt-br/mdn/contribute/getting_started/index.html create mode 100644 files/pt-br/mdn/contribute/guia/como-marcar-as-paginas-corretamente/index.html create mode 100644 files/pt-br/mdn/contribute/guia/converter_exemplos_codigo_para_ao_vivo/index.html create mode 100644 files/pt-br/mdn/contribute/guia/create_an_interactive_exercise_to_help_learning_the_web/distant_example/index.html create mode 100644 files/pt-br/mdn/contribute/guia/create_an_interactive_exercise_to_help_learning_the_web/index.html create mode 100644 files/pt-br/mdn/contribute/guia/create_an_mdn_account/index.html create mode 100644 files/pt-br/mdn/contribute/guia/do_a_technical_review/index.html create mode 100644 files/pt-br/mdn/contribute/guia/do_an_editorial_review/index.html create mode 100644 files/pt-br/mdn/contribute/guia/escreva_um_artigo_para_ajudar_aprender_sobre_a_web/index.html create mode 100644 files/pt-br/mdn/contribute/guia/index.html create mode 100644 files/pt-br/mdn/contribute/guia/set_the_summary_for_a_page/index.html create mode 100644 files/pt-br/mdn/contribute/guia/tag_javascript_pages/index.html create mode 100644 files/pt-br/mdn/contribute/guia/vincular_uma_conta_github/index.html create mode 100644 files/pt-br/mdn/contribute/index.html create mode 100644 files/pt-br/mdn/contribute/persona_sign-in/index.html create mode 100644 files/pt-br/mdn/contribute/processos/index.html (limited to 'files/pt-br/mdn/contribute') diff --git a/files/pt-br/mdn/contribute/collaboration_tactics/index.html b/files/pt-br/mdn/contribute/collaboration_tactics/index.html new file mode 100644 index 0000000000..22b22715be --- /dev/null +++ b/files/pt-br/mdn/contribute/collaboration_tactics/index.html @@ -0,0 +1,65 @@ +--- +title: Táticas de colaboração intra equipe para documentação +slug: MDN/Contribute/Collaboration_tactics +tags: + - Documentação + - Guia(2) + - Guía + - MDN + - Projeto MDC +translation_of: MDN/Contribute/Processes/Cross-team_collaboration_tactics +--- +
{{MDNSidebar}}
+ +

Uma coisa que aprendemos na MDN é que quando equipes de desenvolvimento e documentação de um dado projeto, API ou tecnologia trabalham próximas uma da outra—e juntas— a documentação ganha uma qualidade inacreditável. Este guia sugere algumas táticas para que equipes de desenvolvimento e documentação trabalhem de mãos dadas.

+ +
+

Nota: Este artigo é um trabalho em progresso, um documento aberto. Caso você conheça outras maneiras de integrar equipes de desenvolvimento e documentação, convidamos você à dividi-las conosco aqui!

+
+ +

Integrando-se

+ +

Idealmente, quando o desenvolvimento de uma nova tecnologia ou projeto são concebidos, a equipe de desenvolvimento avisa a equipe de documentação que algo novo está à caminho e precisará ser documentado. Algumas vezes não é isso que acontece, e a equipe MDN monitora a Bugzilla observando todo trabalho que precisará ser documentado, porém em um mundo perfeito, nós receberemos um aviso prévio de maneira mais direta.

+ +

A melhor maneira de notificar a equipe MDN sobre um novo projeto o qual precisamos ficar cientes é preenchendo uma requisição de documentação de defeito. Fornecer uma lista de contatos em conjunto com as respectivas dúvidas é uma ótima maneira de ajudar! Incluir links para os defeitos relacionados ao projeto também é uma grande ajuda.

+ +

Compartilhando informação

+ +

Existem diversas maneiras úteis e diferentes de compartilhar informação. Apresentamos algumas sugestões a seguir.

+ +

Defeitos

+ +

Certificar-se de que a equipe de documentação está ciente dos defeitos que refletem na documentação é de grande ajuda. O uso adequado das palavras-chaves de documentação e desenvolvimento e das tags de comentários leva tempo. Consulte Atualizando documentação para mais informações.

+ +

Reuniões

+ +

Equipes de desenvolvimento realizam reuniões frequentemente. Sempre que possível e necessário(e muitas vezes é bastante necessário), a equipe MDN tenta enviar alguém para assistir estas reuniões. Esta é uma boa maneira de saber o que esta acontecendo, como os horários estão dispostos, e assim por diante.

+ +

Além disso, os profisionais que trabalham em grandes áreas de documentação, tais como documentação de APIs Web, muitas vezes realizam reuniões para acompanhar a evolução da documentação. Estes profissionais adoram ter um desenvolvedor à disposição para participar de tais reuniões; acaba sendo incrivelmente útil para todos os envolvidos.

+ +

Estas reuniões geralmente são curtas e possuem uma agenda similar a esta:

+ +
    +
  1. Atualizações sobre o andamento das atividades de documentação.
    2. +
  2. Perguntas/atualizações da equipe de desenvolvimento para a equipe de documentação: pode incluir perguntas sobre a evolução de documentos específicos, informações sobre conteúdo específico que é urgentemente necessário, notas sobre problemas com conteúdo já existente, e assim por diante.
    3. +
  3. Perguntas/atualizações da equipe de documentação para a equipe de desenvolvimento: esta é uma oportunidade para a equipe de documentação perguntar sobre possíveis bugs, se alguém pode se disponibilizar para revisar algum documento específico, se há um engenheiro em específico que esteja disponível para responder perguntas sobre uma determinada API, esse tipo de coisa.
    4. +
+ +

Reuniões de documentação de APIs Web  têm sido realizadas por meses em Vidyo, com grande sucesso. Cada semana, a equipe de desenvolvimento da API Web têm pelo menos um membro (e muitas vezes dois) para a reunião, e temos sido extremamente produtivos, realizando as reuiniões em 15 minutos ou menos.

+ +

Semanas de trabalho

+ +

Convide os responsáveis pela documentação para acompanhar a equipe de desenvolvimento em uma semana de trabalho ou reunião. Isto tem muitas vantagens, incluindo:

+ + + +

Se você não sabe se existe um membro para documentação atribuído ao tópico da sua área acompanhando sua semana de trabalho, não hesite em enviar um e-mail para o líder da equipe de documentação, Eric Shepherd, e ele buscará saber se alguém poderá auxiliar. Ele buscará alguém lá (ou melhor, buscará um membro exlusivo para documentação no seu projeto)! Tenha em mente, porém, que a equipe de documentação é pequena, então encontrar alguém para acompanhar uma semana de trabalho em um curto prazo é uma tarefa complicada.

+ +

Páginas de estado de documentação

+ +

Grandes projetos de documentação na MDN agora utilizam páginas de estados a fim de acompanhar o que falta ser feito, e o que já foi feito, para conseguir realizar o trabalho. Tais páginas fornecem uma lista de tarefas a serem realizadas, bem como o estado de cada tarefa.

diff --git a/files/pt-br/mdn/contribute/criando_e_editando_paginas/index.html b/files/pt-br/mdn/contribute/criando_e_editando_paginas/index.html new file mode 100644 index 0000000000..85f02f9231 --- /dev/null +++ b/files/pt-br/mdn/contribute/criando_e_editando_paginas/index.html @@ -0,0 +1,147 @@ +--- +title: Criando e editando páginas +slug: MDN/Contribute/criando_e_editando_paginas +tags: + - Colaborando + - Colaborar + - Contribuindo + - Criando + - Editando + - MDN + - nova pagina +translation_of: MDN/Contribute/Howto/Create_and_edit_pages +--- +
{{MDNSidebar}}
+ +

As duas tarefas mais básicas sobre MDN que quase todo contribuinte MDN irá eventualmente executar são para editar uma página já existente ou criar uma nova. Este artigo aborda os conceitos básicos de como fazer cada uma delas.

+ +

Editando uma página existente

+ +

É fácil editar:

+ + + +

Ver mudanças

+ +

Para ver como suas mudanças ficaram:

+ + + +

Tenha cuidado! Pré-visualizar uma página não salva as alterações, sendo assim, se lembre de não fechar a página que você está editando sem salvar o conteúdo.

+ +

Revisão de comentário

+ +

Depois que você pré-visualizou suas mudanças, você deve querer salvar sua revisão. Antes de salvar, procure pela caixa de comentários de revisão abaixo da sessão de título da página e deixe um comentário para informar a outros voluntários o que você mudou e o motivo. Por exemplo, você pode ter adicionado uma nova sessão, mudado algumas palavras para fazer a terminologia mais consistente, reescrito um parágrafo para esclarecer o idioma, ou removido informação porque é redundante.

+ +

Tags

+ +

Você pode adicionar ou remover tags que descrevam o conteúdo da página. Veja como adicionar tags às páginas corretamente para mais informações em que as tags se aplicam.

+ +

Precisa de revisão?

+ +

Se você quiser que um contribuidor experiente revise suas edições, você pode requisitar uma revisão técnica (para códigos, APIs, ou tecnologias), uma revisão editorial (textual, de gramática ou conteúdo), ou uma revisão de template (para código KumaScript) se certificando que a caixa está marcada, antes que você salve.

+ +

Anexar arquivos

+ +

Se você quiser anexar um arquivo a uma página para adicionar uma ilustração ou tornar o conteúdo mais claro, o anexo pode ir no final da página.

+ +

Salve, descarte ou continue editando

+ +

Quando você termina uma edição com seu preview, você pode salvar seu trabalho e comentários clicando no botão verde "Salvar alterações" à direita do título da página. Se você mudar de ideia, pode descartar suas edições clicando no botão vermelho "Descartar alterações", também à direita do título da página.

+ +

Pressionar Enter no comentário da revisão é equivalente a clicar em "Salvar e continuar editando".

+ +

Criando uma nova página

+ +

Se você não sabe onde colocar seu artigo, não se preocupe sobre isso! Coloque-o em qualquer local e nós vamos encontrá-lo e movê-lo para onde ele pertence, ou mesclá-lo em conteúdo existente se for mais apropriado. Você também não precisa se preocupar sobre deixar tudo perfeito. Nós temos gnomos ajudantes felizes que vão ajudá-lo deixar seu conteúdo lindo.

+ +

Há algumas maneiras de criar uma nova página:

+ + + + + +

Como na maioria das wikis, na MDN é possível criar links para uma página que ainda não existe. Por exemplo, um autor pode criar uma lista de todos os membros de uma API, antes de criar as páginas para esses membros. Na MDN, links para página inexistentes geralmente são exibidos em vermelho.

+ +

Para criar um link para uma "página inexistente":

+ +
    +
  1. Certifique-se que você está logado na MDN. (Se você não estiver, vai receber um erro 404).
    2. +
  2. Clique no link "página inexistente". O MDN Editor UI abrirá, pronto para você criar a página inexistente.
    3. +
  3. Escreva o conteúdo da página e salve-a.
    4. +
+ + + +

Para criar uma nova página sem linkar de outra página, informe o nome único de uma página na barra de endereços do seu navegador. Por exemplo, se você inserir:

+ +
https://developer.mozilla.org/en-US/docs/FooBar
+ +

O MDN cria uma nova página com o título "FooBar" e abre o editor para você inserir o conteúdo nessa página. Veja a sessão "Editando uma página existente" nesse artigo para ver como usar o editor.

+ +

Subpágina de uma página existente

+ +

Para criar uma subpágina que você quer que seja filha de uma página existente:

+ +
    +
  1. Na página "pai", clique no menu Avançado (o ícone de engrenagem na barra de ferramentas) e clique em Nova subpágina.
    2. +
  2. Digite um título para o documento no campo Título.
    3. +
  3. Mude o Slug se necessário (por exemplo, se o título for muito longo e você quiser um título menor). Esse campo é gerado automaticamente pelo editor, substituindo underlines por espaços no título. Nesse caso, você pode mudar apenas a última parte da URL do documento.
    4. +
+ +

Clone de uma página existente

+ +

Se houver uma página existente cujo formato você quer usar numa página nova, você pode clonar essa página e mudar seu conteúdo

+ +
    +
  1. Na página original, clique no menu Avançado (o ícone de engrenagem na barra de ferramentas) e clique em Clonar essa página. O editor vai abrir para que você mude seu conteúdo.
    2. +
  2. Mude o Título da página conforme apropriado. O campo Slug é atualizado automaticamente quando você muda o campo Título.
    3. +
  3. Se necessário, mude o caminho do campo Slug para colocar o documento em uma parte diferente da hierarquia dele.
    4. +
  4. No campo TOC, selecione os níveis de cabeçalho que você quer que sejam automaticamente exibidos na tabela de conteúdo da página, ou "Sem tabela de conteúdos" se a página não precisar de uma.
    5. +
  5. Escreva o conteúdo da página e salve suas alterações. Veja a sessão "Editando uma página existente" nesse artigo para ver como usar o editor.
    6. +
+ + + +

Esse método é um pouco híbrido. Você pode criar um link em outra página, e clicar no link que você inseriu, para criar a nova página.

+ +
    +
  1. Digite o nome da página nova em qualquer lugar (que faça sentido) no texto de uma página existente.
    2. +
  2. Selecione o nome e clique no ícone de link () na barra de ferramentas do editor. A caixa de diálogo para "Atualizar Link" vai abrir com o texto selecionado no campo "Linkar para".
    3. +
  3. "/pt-BR/docs/" é inserido por padrão no começo do campo URL. Insira o nome da página depois de "/pt-BR/docs/". (O nome da página não tem de ser o mesmo texto do link).
    4. +
  4. Clique em OK para criar e inserir o link.
    5. +
+ +

Se a página já não existir, o link é mostrado em vermelho. Se a página já existir, o link é mostrado em azul. Se você quiser criar uma nova página mas o título da página que você quer já estiver sendo usado, verifique primeiro se não faz mais sentido ajudar a editar o conteúdo existente. Senão, pense num título diferente para sua nova página e crie um link para ela. Veja o guia para nomear páginas.

+ +

Para adicionar conteúdo para sua nova página, clique no link vermelho que você acabou de criar (depois de salvar e fechar o editor). A nova página abre no modo de edição, assim você pode começar a editar o conteúdo. Veja a sessão "Editando uma página existente" nesse artigo para ver como usar o editor.

+ +

Atualizando o conteúdo da página

+ +

O suporte do MDN para macros KumaScript e transclusão de conteúdo de uma página para outra pode algumas vezes ser dificultada pela necessidade de fazer um cache das páginas geradas para melhorar a performance. Páginas são feitas do seu código-fonte, e a saída é cacheada para requisições futuras. A partir de lá, quaisquer macros (templates) ou transclusões (utilizando a macro Page) na página não vão refletir mudanças feitar para o macro, a saída do macro, ou o conteúdo do material transcluso.

+ + + +

Veja também

+ + diff --git a/files/pt-br/mdn/contribute/feedback/index.html b/files/pt-br/mdn/contribute/feedback/index.html new file mode 100644 index 0000000000..8e2c619cc0 --- /dev/null +++ b/files/pt-br/mdn/contribute/feedback/index.html @@ -0,0 +1,60 @@ +--- +title: Envie sugestões sobre o MDN +slug: MDN/Contribute/Feedback +tags: + - Documentação + - Guía + - MDN Meta +translation_of: MDN/Contribute/Feedback +--- +
{{MDNSidebar}}
+ +
{{IncludeSubnav("/en-US/docs/MDN")}}
+ +

Bem-vindo ao Mozilla Developer Network! Se você tem sugestões, ou está tendo problemas usando MDN, este é o lugar certo para estar. O fato de que você está interessado em oferecer um feedback, faz de você mais uma parte da comunidade Mozilla e agradecemos antecipadamente por seu interesse.

+ +

Você tem várias opções para oferecer suas idéias. Este artigo irá ajudá-lo a fazê-lo.

+ +

Atualizar a documentação

+ +

Primeiro de tudo, se você ver algum problema com a documentação, você deve sempre se sentir livre para corrigir por si mesmo.

+ +
    +
  1. Você pode efetuar o login com sua conta do Github ou do Persona.
    2. +
  2. Após efetuar o login, clique no botão Editar (em azul) em qualquer página para que o editor seja aberto.
    3. +
  3. Clique no botão Publicar (em verde) quando você terminar suas correções.
    4. +
+ +

A Documentação aqui é uma wiki, e é curada por uma equipe de voluntários e funcionários remunerados, então não seja tímido — sua gramática não precisa ser perfeita. Nós vamos arrumar se você cometer um erro; sem nenhum problema!

+ +

Para mais informações sobre contribuir com a documentação da MDN, veja:

+ + + +

Junte-se à conversação

+ +

Fale conosco! Existem algumas maneiras de entrar em contato com outras pessoas que trabalham no conteúdo do MDN.

+ +

Chat

+ +

+

Email

+ + +

Discussões de longo-prazo acontecem em nossa mailing list, dev-mdc@lists.mozilla.org. você postar na lista sem se inscrever nela, mas neste caso, sua postagem deve ser aprovada por um moderador, o que significa que levará mais tempo para que outros possam vê-lo. Você pode visualizar e postar em dev-mdc através de sua escolha de formatos:

+ +

{{ DiscussionList("dev-mdc", "mozilla.dev.mdc") }}

+ +

Relatar um problema

+ +

Problemas na documentação

+ +

se você encontrar um problema na documentação e não puder corrigí-lo por qualquer motivo, você pode reportar um problema! Você pode usar este formulário para qualquer problema de documentação, seja uma correção simples ou uma solicitação para um conteúdo completamente novo. Como mencionado antes, nós convidamos você para contribuir com alterações por si mesmo, mas esta opção também está disponível para você.

+ +

Problemas no site

+ +

se você encontrar problemas com o web site do MDN, ou tem idéias para novos recursos para o site, você pode enviar um ticket para a equipe de desenvolvimento MDN.

diff --git a/files/pt-br/mdn/contribute/getting_started/index.html b/files/pt-br/mdn/contribute/getting_started/index.html new file mode 100644 index 0000000000..f6a1e68013 --- /dev/null +++ b/files/pt-br/mdn/contribute/getting_started/index.html @@ -0,0 +1,136 @@ +--- +title: Primeiros Passos no MDN +slug: MDN/Contribute/Getting_started +tags: + - Começando + - Documentação + - Guia(2) + - MDN + - MDN Meta + - Novos contribuidores + - Projeto MDN + - Wiki de edição +translation_of: MDN/Contribute/Getting_started +--- +
{{MDNSidebar}}
{{IncludeSubnav("/pt-BR/docs/MDN")}}
+ +

Somos uma comunidade aberta de desenvolvedores construindo recursos para uma web melhor, independente de marca, navegador ou plataforma. Qualquer pessoa pode contribuir e cada contribuição nos torna mais fortes. Juntos podemos conduzir inovações na Web para servir ao bem maior. E começa aqui, com você.

+ +

Cada parte do MDN (documentações, demos e o próprio site) são criados por uma comunidade aberta de desenvolvedores. Qualquer um tem algo para oferecer, e esperamos que voce junte-se a nós!

+ +

3 passos simples para o MDN

+ +

MDN é um wiki, onde qualquer pessoa pode adicionar e editar conteúdo. Você não precisa ser um programador ou saber muito sobre tecnologia. Existe uma variedade de tarefas que precisam ser feitas, desde revisão de textos e erros de digitação, até tarefas mais complexas, como escrever documentação de API.

+ +

Contribuir é fácil e seguro. Caso você cometa algum erro, este pode ser facilmente corrigido; Se você não sabe exatamente como as coisas deveriam parecer, ou se a sua gramática não é assim tão boa, não se preocupe! Temos uma equipe cujo trabalho é garantir que o conteúdo do MDN esteja o melhor possível. Alguém verificará seu trabalho para garantir que esteja correto e bem escrito.

+ +

Passo 1: Crie uma conta no MDN

+ +

Para iniciar suas contribuições, você precisa ter uma conta no MDN. Para mais detalhes, veja como criar uma conta.

+ +

Passo 2: Escolha uma tarefa

+ +

Agora que você está logado, leia as descrições dos diferentes tipos de tarefas da lista abaixo, e escolha a que mais te agrada. Você pode escolher qualquer tarefa que gostar para iniciar sua contribuição.

+ +

Passo 3: Faça a tarefa

+ +

Assim que decidir que tipo de tarefa você quer fazer, procure uma página específica ou exemplo de código para trabalhar, e faça!

+ +

Não se preocupe em fazer tudo perfeito; outros colaboradores do MDN estão aqui para ajudar a corrigir os erros que passaram despercebidos. Se estiver com dúvidas sobre como fazer, visite a página da comunidade para obter respostas via chat ou email.

+ +
+

Nota: Se você quiser testar antes de fazer algo "de verdade", você pode editar a página Sandbox para você poder brincar. Por favor, limite seus experimentos a esta página. Por favor, não faça mudanças desnecessárias nas páginas apenas para ver o que acontece, isso acaba por fazer uma bagunça para que outros tenham que limpar, ou, pior ainda, confundindo os leitores que estão tentando aprender coisas novas ou buscando por algo.

+
+ +

Quando terminar, fique à vontade para escolher outro item, ou veja outras coisas que você pode fazer no MDN.

+ +

Tipos de tarefas possíveis

+ +

Existem vários caminhos que você pode tomar para contribuir com o MDN, dependendo de suas habilidades e interesses. Ainda que algumas tarefas possam assustar, temos muitas atividades simples disponíveis. Várias delas tomam apenas cinco minutos (ou menos!) do seu tempo. Junto com a tarefa e sua breve descrição, você encontrará o tempo aproximado que cada tarefa geralmente leva para ser concluída.

+ +

Opção 1: Eu gosto de palavras

+ +

Você pode nos ajudar revisando ou editando documentos existentes, e aplicar correções.

+ + + +
Nota: Se você estiver revisando ou escrevendo novos artigos, pedimos que verifique o guia de estilo. Isso ajudará a garantir que os artigos estejam consistentes.
+ +

Opção 2: Eu gosto de programar

+ +

Precisamos de mais exemplos de códigos! Você também pode ajudar a construir nossa plataforma local, Kuma!

+ + + +

Opção 3: Eu gosto de ambos, palavras e programar

+ +

Temos tarefas que exigem habilidades técnicas e de linguagem, como escrever novos artigos, revisão de precisão técnica, ou adaptação de documentos.

+ + + +

Opção 4: Eu quero o MDN em minha língua

+ +

Todo o trabalho de localização e tradução do MDN é feito pela nossa incrível comunidade de voluntários.

+ + + +

Opção 5: Encontrei informações erradas e não sei como corrigir

+ +

Você pode reportar problemas preenchendo uma documentação de bug. (~5 minutos)

+ +

Use estes valores de campo:

+ + + + + + + + + + + + + + + + + + + + + + + + +
Campo BugzillaValor
productDocumentação do Desenvolvedor
component[escolha uma área apropriada para o tema, ou "Geral" se você não tem certeza ou se não encontrou o correto]
URLEndereço da página onde você encontrou o problema
DescriptionO quanto você souber ou tenha tempo para descrever sobre o problema e onde encontrar as informações corretas. Isso pode incluir pessoas ("falar com fulano de tal"), bem como links da Web.
+ +

Outras coisas que você pode fazer no MDN

+ + diff --git a/files/pt-br/mdn/contribute/guia/como-marcar-as-paginas-corretamente/index.html b/files/pt-br/mdn/contribute/guia/como-marcar-as-paginas-corretamente/index.html new file mode 100644 index 0000000000..541d31ff6e --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/como-marcar-as-paginas-corretamente/index.html @@ -0,0 +1,394 @@ +--- +title: Como adicionar etiquetas às páginas corretamente +slug: MDN/Contribute/guia/Como-marcar-as-paginas-corretamente +tags: + - Contribua + - Etiquetas + - Filtro + - Glossário + - Guia(2) + - Howto + - Iniciante + - Introdução + - MDN Meta + - Tags + - Tutorial +translation_of: MDN/Contribute/Howto/Tag +--- +
{{MDNSidebar}}
{{IncludeSubnav("/pt-BR/docs/MDN")}}
+ +

 As etiquetas dos artigos são uma forma importante de ajudar visitantes a encontrar o conteúdo procurado. Há muitas etiquetas usadas para ajudar a organizar as informações na MDN. Esta página vai lhe ensinar a melhor maneira de rotular as páginas, a fim de fazer com que as informações sejam organizadas, classificadas e localizadas mais facilmente. Cada página pode ser marcada por etiquetas que ajudam a classificar seu conteúdo.

+ +

 Você pode encontrar uma boa ajuda quanto às etiquetas em páginas na seção 'etiquetando', em nosso guia de edição.

+ +

Observe que o uso adequado de etiquetas é importante; nós estamos cada vez mais usando automação para gerar listas de conteúdo, páginas de destino e ligação cruzada de artigos. Falhar em marcar artigos corretamente (como indicado abaixo) pode impedir que os mesmos sejam listados precisamente.

+ +

Métodos de marcações usadas na MDN

+ +

Há muitas maneiras das etiquetas serem usadas na MDN:

+ +
+
Categorização
+
Qual o tipo desse documento? É uma referência? Um tutorial? Uma página de destino? As etiquetas podem ser usadas em filtros de busca, então elas são realmente importantes!
+
Identificação de tópico
+
Que tópico esse artigo envolve? É sobre uma API? O DOM? Gráficos? Estas também são importantes, pois elas podem ser usadas em filtros de buscas.
+
Estado da tecnologia
+
Qual é o estado dessa tecnologia? Isto não é padrão? Obsoleto ou moderno? Experimental?
+
Nível de habilidade
+
Para tutoriais e guias, quão avançado é o material do artigo?
+
Metadados do documento
+
Os escritores da MDN usam rótulos que informam quais páginas precisam de melhorias e de quais tipos.
+
+ +

Guia de tipos de marcação

+ +

Aqui está um guia rápido sobre os tipos de etiquetas e os possíveis valores para elas.

+ +

Categoria do Documento

+ +

Quando você rotula um artigo com uma destas categorias, você ajuda ferramentas automáticas a gerarem mais precisamente as páginas de entrada, tabela de conteúdos e assim por diante. Nosso novo sitema de pesquisa também vai usar esses termos para que nossos visitantes possam localizar referências e guias mais fácilmente.

+ +

Nós usamos os seguintes nomes de categorias como termos de etiquetamento padrão:

+ +
+
{{Tag("Intro")}}
+
O artigo fornece um material introdutório sobre algum tópico. Idealmente, cada área de tecnologia deveria ter apenas uma "introdução".
+
{{Tag("Featured")}}
+
O artigo é crucial e será exibido com relevância nas páginas de entrada. Use esta etiqueta moderadamente (nunca mais do que três páginas em cada área da documentação).
+
{{Tag("Reference")}}
+
O artigo contém material de referência sobre uma API, elementos, atributos, propriedades, ou coisas semelhantes.
+
{{Tag("Landing")}}
+
Indica que esta é uma página de entrada.
+
{{Tag("Guide")}}
+
O artigo é um guia ou um tutorial.
+
{{Tag("Example")}}
+
O artigo é uma página de amostra de código, ou tem exemplos de códigos (isto é, pedaços de códigos úteis, não uma linha de "exemplo de sintaxe") .
+
+ +

Tópico

+ +

Ao identificar o assunto tratado por um artigo você ajuda a gerar melhores resultados de pesquisa, assim como páginas de entrada e outros auxílios de navegação.

+ +

Apesar de ser permitida certa flexibilidade, ao passo que novos assuntos são identificados, preferimos que estas etiquetas tenham os mesmos nomes das APIs, ou tecnologias, demonstradas na página. Alguns exemplos:

+ + + +

No geral, se uma interface que possui várias páginas relacionadas a ela, como Node (que possui várias páginas sobre seus muitos métodos e propriedades), seu nome é uma boa etiqueta para identificar um tópico, assim como o nome de uma tecnologia abragente, ou seu tipo. Uma página sobre WebGL pode ser marcada com as tags Gráficos/Graphics e WebGL, por exemplo, e uma página sobre elementos {{HTMLElement("canvas")}} pode ser marcada com as etiquetas HTML, Elementos/Element, Tela/Canvas, e Gráficos/Graphics.

+ +

Estado da tecnologia

+ +

Para ajudar a entender se uma tecnologia é viável ou não, nós usamos as etiquetas que descrevem em que ponto estão as suas especificações. Fazer isso não detalha tanto quanto explicar, de fato, qual é a especificação e onde, nesse processo, a tecnologia está (para isto usamos uma tabela de "Especificações"), mas ajuda os leitores a julgar, rapidamente, se usar a tecnologia descrita no artigo é, ou não, uma boa ideia.

+ +

Alguns valores possíveis para estas etiquetas:

+ +
+
{{Tag("Read-only")}}
+
Aplique esta etiqueta para páginas que descrevem atributos ou propriedades que são "somente leitura".
+
+ +
+
{{Tag("Non-standard")}}
+
Indica que a tecnologia ou API não pertence a qualquer padrão, mas é considerada estável no(s) navegador(es) que a tem implementada. Se você não usar esta etiqueta os leitores vão presumir que o artigo é padronizado. A tabela de compatibilidade da página deve esclarecer quais navegadores suportam essa tecnologia ou API.
+
{{Tag("Deprecated")}}
+
A tecnologia ou API abrigada na página foi marcada como obsoleta na especificação e é esperado que seja, eventualmente, removida mas está, em geral, ainda presente nas versões mais recentes de navegadores.
+
{{Tag("Obsolete")}}
+
Foi decidido que a tecnologia ou API está ultrapassada e, assim, foi removida (ou está em processo de remoção) de todas as versões mais recentes de navegadores.
+
{{Tag("Experimental")}}
+
A tecnologia ou API não é padronizada, ainda é experimental e pode, ou não, vir a ser parte da especificação. Também está sujeita a alterações no mecanismo do navegador (tipicamente, apenas uma) que a implementa.
+
{{Tag("Needs Privileges")}}
+
A API requer acesso privilegiado ao aparelho no qual o código está rodando.
+
{{Tag("Certified Only")}}
+
A API funciona, apenas, em código certificado.
+
+ +

Estas etiquetas não são desculpa para não inserir uma tabela de compatibilidade em seu artigo!

+ +

Nível de habilidade

+ +

A etiqueta de nível de habilidade é usada, apenas, em guias e tutoriais (ou seja, páginas marcadas como Guias) a fim de auxiliar quem os procura a escolher  tutoriais baseados na familiaridade com a tecnologia. Existem trés valores para esta etiqueta:

+ +
+
{{Tag("Beginner")}}
+
Artigos escritos com a intenção de introduzir uma nova tecnologia, para iniciantes.
+
{{Tag("Intermediate")}}
+
Artigos para quem já tem experiência com a tecnologia, mas ainda não a domina completamente.
+
{{Tag("Advanced")}}
+
Artigos que levam ao limite as capacidades de quem lê e da tecnologia.
+
+ +

Metadados do documento

+ +

Os escritores da MDN usam etiquetas para identificar artigos que precisam de determinados tipos de trabalho. Segue uma lista das que mais usamos:

+ +
+
{{Tag("junk")}}
+
Este artigo precisa ser deletado.
+
{{Tag("NeedsContent")}}
+
Este artigo é um esboço, ou a informação está, de alguma forma, incompleta. Esta etiqueta significa que alguém precisa revisar o conteúdo e adicionar detalhes e/ou terminar a escrita do artigo.
+
{{Tag("NeedsExample")}}
+
O artigo precisa de um ou mais exemplos para ilustrar melhor seu objetivo, de acordo com o sistema de exemplos dinâmicos.
+
{{Tag("NeedsLiveSamples")}}
+
Este arigo necessita que um, ou mais, de seus exemplos sejam modificados para incluir o uso do sistema de exemplos dinâmicos.
+
{{Tag("NeedsUpdate")}}
+
O artigo está desatualizado.
+
{{Tag("l10n:exclude")}}
+
Não vale a pena traduzir este artigo e ele não aparecerá nas páginas sobre as situações das traduções.
+
{{Tag("l10n:priority")}}
+
Este artigo é importante e deve ser visto como prioridade para os tradutores da MDN. É mostrado em uma tabela de maior importância nas páginas sobre as situações das traduções.
+
+ +

Mapa Literário Web

+ +

O projeto WebMaker, através do Mapa Literário para a Web, definiu as habilidades necessárias para aperfeiçoar a leitura, a escrita e a participação na Web. Nós usamos essas habilidades literárias em forma de etiquetas, na MDN, para ajudar nossos utilizadores a encontrar as melhores respostas às suas necessidades:

+ +
+
{{Tag("Navigation")}}
+
Este artigo inclui informação sobre como navegar pela web.
+
{{Tag("WebMechanics")}}
+
Este artigo tem informação de como a web é organizada e como ela funciona.
+
{{Tag("Search")}}
+
Este artigo explica como localizar informação, pessoas e recursos na web.
+
{{Tag("Credibility")}}
+
A instrução neste artigo ajuda os leitores a entender como avaliar, criticamente, a informação encontrada na web.
+
{{Tag("Security")}}
+
Este artigo provê informação de como manter sistemas, identidades e conteúdo seguros.
+
{{Tag("Composing")}}
+
Este artigo explica como criar e selecionar conteúdo para a web.
+
{{Tag("Remixing")}}
+
Este artigo ensina como modificar recursos já existentes na web para criar algo novo.
+
{{Tag("Design")}}
+
Documentação sobre como aprimorar a estética visual e a experiência dos utilizadores.
+
{{Tag("Accessibility")}}
+
Documentos que descrevem como desenvolver conteúdo com acessibilidade, o que significa permitir que o máximo possível de pessoas possa acessá-lo, ainda que as suas habilidades sejam limitadas de alguma forma.
+
{{Tag("CodingScripting")}}
+
Como programar e/ou criar experiências interativas na web.
+
{{Tag("infrastructure")}}
+
Este documento explica as partes técnicas da internete.
+
{{Tag("Sharing")}}
+
O conteúdo deste artigo fala sobre as várias maneiras de criar recursos com outras pessoas.
+
{{Tag("Collaborating")}}
+
Este artigo provê informação de como trabalhar em conjunto com outras pessoas.
+
{{Tag("Community")}}
+
Este artigo detalha como se envolver com as comunidades da Web e entender como elas funcionam.
+
{{Tag("Privacy")}}
+
Este material ajuda a examinar as consequências de compatilhar dados online.
+
{{Tag("OpenPractices")}}
+
Este artigo demonstra como manter a Web acessível a todas as pessoas.
+
+ +

Colocando tudo junto

+ +

Para cada página você aplica vários tipos de etiquetas, por exemplo:

+ +
+
Um tutorial sobre WebGL para iniciantes
+
WebGL, Gráficos, Graphics, Guia, Guide, Iniciante, Beginner
+
Referência para elementos {{HTMLElement("canvas")}}
+
Canvas, Tela, HTML, Element, Elementos, Graphics Reference, Referencial Gráfico
+
Uma página de entrada para as ferramentas de desenvolvedores voltados ao Firefox OS
+
Tools, Ferramentas, Firefox OS, Landing, Destino
+
+ +

Etiquetas e filtros de busca

+ +

Filtros de busca não vão funcionar apropriadamente, a não ser que marquemos as páginas da MDN corretamente. Aqui está uma tabela dos filtros de pesquisa e sua busca correspondente.

+ +
+

Observação: Se várias etiquetas estiverem listadas abaixo de "Nome da etiqueta", isso significa que, pelo menos, uma delas precisa estar presente para o artigo estar propriamente marcado.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Grupo do filtroNome do filtro de pesquisaNome da etiqueta
TópicoOpen Web Apps{{Tag("Apps")}}
 HTML{{Tag("HTML")}}
 CSS{{Tag("CSS")}}
 JavaScript{{Tag("JavaScript")}}
 APIs e DOM{{Tag("API")}}
 Telas{{Tag("Canvas")}}
 SVG{{Tag("SVG")}}
 MathML{{Tag("MathML")}}
 WebGL{{Tag("WebGL")}}
 XUL{{Tag("XUL")}}
 Marketplace{{Tag("Marketplace")}}
 Firefox{{Tag("Firefox")}}
 Firefox para Android{{Tag("Firefox Mobile")}}
 Firefox para Computadores{{Tag("Firefox Desktop")}}
 Firefox OS{{Tag("Firefox OS")}}
 Dispositivos Móveis{{Tag("Mobile")}}
 Desenvolvimento Web{{Tag("Web Development")}}
 Complementos & Extensões{{Tag("Add-ons ")}}|| {{Tag("Extensions")}} || {{Tag("Plugins")}} || {{Tag("Themes")}}
 Jogos{{Tag("Games")}}
Nível de habilidadeSou Especialista{{Tag("Advanced")}}
 Nível Intermediário{{Tag("Intermediate")}}
 Estou Começando{{Tag("Beginner")}}
Tipo de documentoDocumentosEsta vai restringir a busca ao teor dos documentos, deixando de fora Hacks e outros conteúdos MDN.
 DemosIsto vai incluir as demonstrações (Demo Studio) nos resultados da busca.
 Ferramentas{{Tag("Tools")}}
 Exemplos de Códigos{{Tag("Example")}}
 Guia & Tutorial{{Tag("Guide")}}
 Perfis de desenvolvedoresEsta inclui os perfis de desenvolvedores da comunidade MDN nos resultados da busca.
 Recursos ExternosIsto é alguma coisa que a equipe de desenvolvimento vai ter que solucionar.
+ +

Problemas de etiquetas que você pode consertar

+ +

Há vários tipos de problemas de rotulagem que você pode ajudar a resolver:

+ +
+
Sem etiquetas
+
Geralmente os artigos devem ter, no minimo, as etiquetas de "categória" e "tópico". Comumente outras etiquetas podem ser adicionadas mas, se você ajudar a garantir que o requesito minimo delas esteja presente, você já terá uma documentação maravilhosa!
+
Etiquetas que não seguem nossos padrões
+
Por favor, conserte qualquer documento cujas etiquetas não sigam as normas estabelecidas nesta página. Leve em consideração que, devido a um erro no Kuma, algumas etiquetas traduzidas (como Référence) podem aparecer em algumas páginas em inglês. Há uma chance bem grande destas etiquetas voltarem após serem deletadas, então, não se acanhe em consertá-las, até o erro ser corrigiido.
+
Etiquetas incorretas
+
Se você estiver lendo um artigo sobre HTML e este estiver marcado com "JavaScript", provavelmente há algo errado! Da mesma forma, se um artigo discutir os detalhes internos da Mozilla mas exibir uma etiqueta "Web", provavelmente existe algo errado aí, também. Remova essas tetiquetas e adicione as corretas, se elas ainda não estiverem lá. Por favor, também corrija etiquetas escritas incorretamente (p.ex. "javascript"  não está de todo errada, uma vez que etiquetas não consideram maiúsculas, ou minúsculas, mas vamos ter capricho!: )
+
Carência de Etiquetas
+
Se um artigo tem algumas, mas não todas as etiquetas de que precisa, sinta-se à vontade para adicionar mais. Por exemplo: se uma página de referência de JavaScript estiver (corretamente) marcada com "JavaScript" e nada mais além disso, agradecemos se você inserir a etiqueta "Referência/Reference" lá, também!
+
Etiquetas indesejáveis (spam)
+
Esta besta asquerosa é o mais revoltante dos problemas de etiquetas: Algum verme da Web depositou suas excreções nas etiquetass de uma página (como "Programa Grátis!" ou "Ei, eu estava navegando pela sua página e queria perguntar se você me ajudaria a resolver esse problema que estou tendo com o Flash travando o tempo todo"). Temos que remover estas "etiquetas" assim que possível! Elas são horrendas, difíceis de manejar se esperarmos demais, e atrapalham muito a {{Glossary("SEO")}}.
+
+ +

Se você vir um (ou mais) destes problemas, por favor, registre-se, ou entre na MDN e clique no botão "EDITAR", no canto superior direito da página. Quando o editor carregar, role até o pé da página e você verá as etiquetas. Para mais detalhes da interface de marcação, leia a seção "As caixas de etiquetas" do Guia do editor da MDN.

diff --git a/files/pt-br/mdn/contribute/guia/converter_exemplos_codigo_para_ao_vivo/index.html b/files/pt-br/mdn/contribute/guia/converter_exemplos_codigo_para_ao_vivo/index.html new file mode 100644 index 0000000000..7bd11477fe --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/converter_exemplos_codigo_para_ao_vivo/index.html @@ -0,0 +1,43 @@ +--- +title: Como converter exemplos de codigos para funcionar "ao vivo" +slug: MDN/Contribute/guia/Converter_exemplos_codigo_para_ao_vivo +tags: + - Começando + - Como + - Contribuindo + - Documentação +translation_of: MDN/Contribute/Howto/Convert_code_samples_to_be_live +--- +
{{MDNSidebar}}

A MDN agora possui um sistema de "exemplos ao vivo", onde a amostra de código e exibida em uma página que é diretamente utilizado para exibir a saída dessa amostra. No entanto, muitos artigos existentes possuem exemplos de código que ainda não utilizam este sistema, e precisam ser convertidos.

+ + + + + + + + + + + + + + + + +
Onde isso precisa ser feito?Artigos tagueados com NeedsLiveSample
O que você precisa saber para fazer a tarefa? +
    +
  • Conhecimento de HTML, CSS e/ou JavaScript, dependendo da amostra de código.
    • +
  • Capacidade de usar macros KumaScript dentro dos artigos da MDN.
    • +
+
Quais são os passos para fazer a tarefa? +

Para uma descrição completa do sistema de exemplos ao vivo, incluindo como criar exemplos ao vivo ,veja Using the live sample system.

+ +
    +
  1. Escolha um artigo da lista lista de artigos que estao tagueados com NeedsLiveSample, em que o exemplo de codigo seja uma feature que seja familiar.
    2. +
  2. Converta o codigo de exemplo para "ao vivo".
    3. +
  3. Apague qualquer codigo ou imagem usada previamente para exibir uma saida de exemplo.
    4. +
+
+ +

 

diff --git a/files/pt-br/mdn/contribute/guia/create_an_interactive_exercise_to_help_learning_the_web/distant_example/index.html b/files/pt-br/mdn/contribute/guia/create_an_interactive_exercise_to_help_learning_the_web/distant_example/index.html new file mode 100644 index 0000000000..13d6745c3f --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/create_an_interactive_exercise_to_help_learning_the_web/distant_example/index.html @@ -0,0 +1,72 @@ +--- +title: distant example +slug: >- + MDN/Contribute/guia/Create_an_interactive_exercise_to_help_learning_the_web/distant_example +translation_of: >- + MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web/distant_example +--- +
{{MDNSidebar}}
+

O exemplo

+ +

HTML

+ +
<div class="square">
+  #<input class="color">
+</div>
+ +

CSS

+ +
body {
+  padding: 10px;
+  margin : 0;
+}
+
+.square {
+  width  : 80px;
+  height : 80px;
+  padding: 10px;
+  background-color: black;
+  color: white;
+  text-align: center;
+}
+
+.color {
+  width: 60px;
+  text-transform: uppercase;
+}
+
+ +

JS

+ +
function setColor(color) {
+  document.querySelector('.square').style.backgroundColor = '#' + color;
+  document.querySelector('.color').value = color;
+}
+
+function getRandomColor() {
+  var color = Math.floor(Math.random() * 16777215);
+  return color.toString(16);
+}
+
+function getInputColor() {
+  var value = document.querySelector('.color').value;
+  var color = Number('0x' + color);
+  if (color === +color) {
+    return color.toString(16);
+  }
+  return value;
+}
+
+document.addEventListener('click', function () {
+  setColor(getRandomColor());
+});
+
+document.addEventListener('keyup', function () {
+  setColor(getInputColor());
+});
+
+
+ +

Resultado ao vivo

+ +

{{EmbedLiveSample('The_example', 120, 120)}}

diff --git a/files/pt-br/mdn/contribute/guia/create_an_interactive_exercise_to_help_learning_the_web/index.html b/files/pt-br/mdn/contribute/guia/create_an_interactive_exercise_to_help_learning_the_web/index.html new file mode 100644 index 0000000000..948da8d3f6 --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/create_an_interactive_exercise_to_help_learning_the_web/index.html @@ -0,0 +1,185 @@ +--- +title: Como criar um exercício de aprendizado interativo +slug: MDN/Contribute/guia/Create_an_interactive_exercise_to_help_learning_the_web +tags: + - Guía +translation_of: MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web +--- +
{{MDNSidebar}}
+ +

Ao aprender a web, é importante confiar no conteúdo da aprendizagem ativa. Esse conteúdo é feito para ajudar a aprender algo pró-ativamente. Pode ser exercícios, exemplos de hackeáveis ​​em tempo real, tarefas a realizar, análises, etc. Em suma, qualquer coisa que desejar, ajuda alguém a entender ativamente algo.

+ +

Não existe uma maneira direta para criar esse conteúdo. Por exemplo, existem muitas ferramentas de terceiros que podem ajudar-lo a criar exemplos em tempo real (ver: JSFiddle , CodePen , Dabblet , etc.) que você pode vincular a partir de artigos MDN. Se Você Quiser CRIAR Exercícios Mais AVANÇADOS e compreensíveis, rápido Você PODE USAR fácilmente o dedal  DO PROJETO WebMaker.

+ +

Atualmente, o MDN não é uma ferramenta fácil para autorizar esse conteúdo ativo. No entanto, você é um codificador, pode usar os recursos MDN atuais para criar o conteúdo de aprendizagem ativo personalizado. Leia mais para ver como fazer isso.

+ +

MDN amostras ao vivo

+ +

O MDN possui um recurso muito legal chamado live samples. É um mecanismo que transforma qualquer código HTML, CSS e JavaScript dentro de uma página MDN em seu equivalente executado. Antes de usá-lo, você deve ler Usando o sistema de amostra ao vivo,qual é a nossa documentação completa para construí-los. Embora sejam fáceis de fazer, há peculiaridades e truques que você aprenderá ao longo do caminho.

+ +

O que é interessante é que é realmente fácil ajustar esse recurso para usá-lo para incorporar qualquer tipo de ferramenta ou utilitário que você deseja em uma página MDN.

+ +

Código oculto

+ +

A primeira maneira de usar um exemplo de código para criar conteúdo de aprendizagem ativo é editar a página onde deseja adicionar seu conteúdo. Use o recurso Live Sample para criar seu conteúdo conforme desejar. Não se preocupe com a complexidade do código que você poderia escrever; apenas crie o que você precisa. Uma vez que o seu conteúdo esteja pronto, basta mudar para a visualização do código do editor e cercar seu código com um simples {{HTMLElement('div')}} elemento com a classeescondida. Ao fazê-lo, seu código não será exibido, mas sua amostra ao vivo permanece acessível e exibível.

+ +

Vamos ver um exemplo simples:

+ +
+

Clique no seguinte quadrado para alterar aleatoriamente a cor ou simplesmente digitar uma cor de código hexadecimal

+ + +{{EmbedLiveSample('hidden_code_example', 120, 120)}}
+ +

Se você olhar para o código HTML dessa página com o editor MDN, você verá o código HTML seguinte:

+ +
<div class="moreinfo">
+<p>Click on the following square to randomly change its color or just type an hexadecimal code color</p>
+
+<div class="hidden">
+<h4 id="hidden_code_example">hidden code example</h4>
+
+<h5 id="HTML">HTML</h5>
+
+<pre class="brush: html">
+&lt;div class="square"&gt;
+  #&lt;input class="color"&gt;
+&lt;/div&gt;</pre>
+
+<h5 id="CSS">CSS</h5>
+
+<pre class="brush: css">
+body {
+  padding: 10px;
+  margin : 0;
+}
+
+.square {
+  width  : 80px;
+  height : 80px;
+  padding: 10px;
+  background-color: black;
+  color: white;
+  text-align: center;
+}
+
+.color {
+  width: 60px;
+  text-transform: uppercase;
+}
+</pre>
+
+<h5 id="JS">JS</h5>
+
+<pre class="brush: js">
+function setColor(color) {
+  document.querySelector('.square').style.backgroundColor = '#' + color;
+  document.querySelector('.color').value = color;
+}
+
+function getRandomColor() {
+  var color = Math.floor(Math.random() * 16777215);
+  return color.toString(16);
+}
+
+function getInputColor() {
+  var value = document.querySelector('.color').value;
+  var color = Number('0x' + color);
+  if (color === +color) {
+    return color.toString(16);
+  }
+  return value;
+}
+
+document.addEventListener('click', function () {
+  setColor(getRandomColor());
+});
+
+document.addEventListener('keyup', function () {
+  setColor(getInputColor());
+});
+</pre>
+</div>
+
+\{{EmbedLiveSample('hidden_code_example', 120, 120)}}
+</div>
+ +

Você pode ver um exemplo mais avançado de tal ajuste sobre a página API do Canvas.

+ +

Código de fora da página

+ +

O exemplo anterior está certo se você deseja incorporar conteúdo básico de aprendizagem ativa. No entanto, se você quiser lidar com um código complexo, pode tornar-se um pouco estranho para lidar com esse wrapper de classe oculto.

+ +

Então, outra opção e escreva o código do seu conteúdo de aprendizagem em uma página MDN e, em seguida, incorpora-lo em outra página. Para fazer isso, podemos usar o {{TemplateLink ("EmbedDistLiveSample")}} macro em vez de {{TemplateLink ("EmbedLiveSample")}} macro.

+ +

Vamos ver como esse exemplo quando configurado como se estivesse sendo incorporado de uma origem remota:

+ +
+

Clique no seguinte quadrado para alterar aleatoriamente a cor ou simplesmente digitar uma cor de código hexadecimal

+ +

{{EmbedLiveSample('The_example', 120, 120, '', 'MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web/distant_example')}}

+
+ +

Desta vez, se você olhar para o HTML da página usando o editor MDN , você não está a ver o código oculto. Se você quiser ver o código, vá para uma página que o hospeda.

+ +

Você pode ver um exemplo mais avançado do uso em nosso tutorial HTML Form , que usa essa técnica para permitir uma experiência com formulários.

diff --git a/files/pt-br/mdn/contribute/guia/create_an_mdn_account/index.html b/files/pt-br/mdn/contribute/guia/create_an_mdn_account/index.html new file mode 100644 index 0000000000..369f018ce5 --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/create_an_mdn_account/index.html @@ -0,0 +1,43 @@ +--- +title: Como criar uma conta na MDN +slug: MDN/Contribute/guia/Create_an_MDN_account +tags: + - Conta + - Guia(2) + - Início(2) + - Novato + - como fazer +translation_of: MDN/Contribute/Howto/Create_an_MDN_account +--- +
{{MDNSidebar}}
+ +

Para fazer quaisquer alterações sobre o conteúdo do MDN (tanto editando uma página como contribuindo com uma demonstração), você precisará de um perfil MDN. Não se preocupe, você não precisa de um perfil se tudo o que você pretende é ler e pesquisar no MDN! Esse guia simples vai ajudá-lo a configurar seu perfil MDN.

+ +
Por que o MDN precisa do meu endereço de email?
+
+Seu endereço de email é usado para recuperação da conta, e se necessário por administradores do MDN para contatá-lo sobre sua conta ou sua atividade no site.
+
+Além disso, você pode opcionalmente inscrever-se para receber notificações (como quando uma página específica é modificada) e mensagens (por exemplo, se você optar por se juntar ao nosso time de testes beta, você poderá receber email sobre novas funcionalidades que precisam ser testadas).
+
+Seu endereço de email nunca é mostrado no MDN e será usado apenas de acordo com nossa política de privacidade.
+ +

Assim que você tiver decidido que quer contribuir para o MDN, aqui está tudo que você deve fazer para configurar o seu perfil:

+ +
    +
  1. No topo de qualquer página no MDN você vai encontrar um botão chamado "Entrar". Passe o seu mouse sobre ele(ou toque nele caso você esteja em um dispositivo móvel) para mostrar uma lista de serviços de autenticação que disponibilizamos para se inscrever no MDN.
    2. +
  2. Selecione um serviço com o qual você irá se inscrever. Atualmente, somente a inscrição com o GitHub está disponível. Note que, se você selecionar o GitHub, um vínculo com a sua conta do GitHub será incluída em seu perfil público na página pessoal do MDN.
    3. +
  3. Siga os passos do serviço para conectar sua conta ao MDN.
    4. +
  4. Uma vez que o serviço de autenticação retorná-lo ao MDN, será solicitado a você que entre com seu nome de usuário e endereço de email. Seu nome de usuário será mostrado publicamente para creditá-lo sobre trabalhos que você concluiu. Não use o seu endereço de email como seu nome de usuário.
    5. +
  5. Clique no botão "Criar meu perfil MDN".
    6. +
  6. Se o endereço de email que você especificou no passo 4 não é o mesmo que você usa no serviço de autenticação, você precisará checar seu email e clicar no link do email de confirmação que foi enviado para você.
    7. +
+ +

É isso! Você adquiriu uma conta MDN, e você pode imediatamente editar ou marcar páginas e postar demonstrações!

+ +

Você pode clicar no seu nome no topo de qualquer página MDN para ver o seu perfil público. A partir de lá, você pode clicar o botão de "Editar" para fazer modificações ou adições no seu perfil, assim você pode compartilhar mais sobre seus interesses, adicionar links para sua conta do Twitter ou blog, e assim por diante.

+ +
+

Observação: Novos nomes de usuário não podem conter espaços ou o caractere "@". Tenha em mente que o seu nome de usuário será mostrado publicamente para identificar o trabalho que você fez!

+
+ +

 

diff --git a/files/pt-br/mdn/contribute/guia/do_a_technical_review/index.html b/files/pt-br/mdn/contribute/guia/do_a_technical_review/index.html new file mode 100644 index 0000000000..45d49fbc55 --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/do_a_technical_review/index.html @@ -0,0 +1,52 @@ +--- +title: Como fazer uma revisão técnica +slug: MDN/Contribute/guia/Do_a_technical_review +tags: + - Documentação + - Guía + - MDN Meta + - Revisão + - como fazer +translation_of: MDN/Contribute/Howto/Do_a_technical_review +--- +
{{MDNSidebar}}

Uma Revisão técnica consiste em revisar a precisão técnica e a integridade de um artigo e corrigi-lo, se necessário. Se um escritor de um artigo procura alguém para verificar o conteúdo técnico do artigo, então ele marca a opção "Análise técnica" durante a edição. Muitas vezes, o escritor contata um engenheiro específico para realizar a revisão técnica, mas qualquer pessoa com experiência técnica no tópico pode fazer um.

+ +

Este artigo descreve como realizar uma revisão técnica, ajudando assim a garantir que o conteúdo do MDN seja exato.

+ +
+
Como é essa tarefa?
+
Revisar e corrigir artigos com precisão técnica e completude.
+
Onde deve ser feita?
+
Em artigos específicos aonde estão marcados como uma revisão técnica.
+
O que você precisa saber para fazer a tarefa?
+
+
    +
  • Conhecimento avançado (especialista) sobre o tópico do artigo que você está revisando. Se a leitura do artigo não lhe ensinou nada de novo, considere-se um especialista.
    • +
  • Como editar um artigo wiki no MDN
    • +
+
+
Quais são os passos para fazê-lo?
+
+
    +
  1. Escolha um artigo para revisar: +
      +
    1. Vá até a lista de páginas que necessitam de revisão técnica. Lá estará listado todas as páginas as quais uma revisão técnica foi solicitada.
      2. +
    2. Escolha uma página cujo tópico você conheça muito.
      3. +
    3. Clique no link do artigo para carregar a página.
      4. +
    +
    2. +
  2. Leia o artigo, prestando atenção aos detalhes técnicos: o artigo está correto? Falta alguma coisa? Não hesite em mudar para uma página diferente se o primeiro que você escolher não se adequar a você.
    3. +
  3. Se não houver erros, você não precisa editar o artigo para marcá-lo como revisado. Procure a caixa "revisão rápida" na barra lateral esquerda da página. Esta caixa amarela lista todas as revisões pendentes e permite que você desmarque a revisão já realizada. Em caso de uma revisão técnica solicita será apresentado desse modo:
    +
    4. +
  4. Desmarque a opção Técnico e clique em salvar.
    5. +
  5. Se você encontrar erros que precisam ser corrigidos, você também pode solicitar uma nova revisão apartir do editor. Aqui estão os passos: +
      +
    1. Para editar a página clique no botão editar no canto superior da página; desse modo você estará acessando o editor do MDN.
      2. +
    2. Corrija qualquer informação técnica que não esteja correta e/ou adicione qualquer informação importante que esteja faltando.
      3. +
    3. Digite um Comentário da revisão na parte inferior do artigo. Esta é uma breve mensagem que descreve o que você fez, como "Revisão técnica concluída". Se você corrigiu as informações, inclua isso em seu comentário, por exemplo, "Análise técnica e descrições de parâmetros fixos". Isso ajuda outros contribuidores e editores de sites a saber o que você mudou e por quê. Você também pode mencionar se houve partes específicas que você não se sentiu qualificado para revisar.
      4. +
    4. Clique no botão PUBLICAR.
      5. +
    +
    6. +
+ Parabéns! Você terminou sua primeira revisão técnica. Obrigado pela ajuda!
+
diff --git a/files/pt-br/mdn/contribute/guia/do_an_editorial_review/index.html b/files/pt-br/mdn/contribute/guia/do_an_editorial_review/index.html new file mode 100644 index 0000000000..687072f228 --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/do_an_editorial_review/index.html @@ -0,0 +1,55 @@ +--- +title: Como fazer uma revisão editorial +slug: MDN/Contribute/guia/Do_an_editorial_review +tags: + - Documentação + - Guia(2) + - MDN Meta + - Revisão + - como fazer +translation_of: MDN/Contribute/Howto/Do_an_editorial_review +--- +
{{MDNSidebar}}
+ +

A revisão editorial consiste em corrigir erros gramaticais e no modo de se expressar em um artigo. Nem todos contribuidores são experientes em linguagens, mas, independentemente dos seus conhecimentos, terão contribuído com artigos extremamente úteis, que precisam da aplicação de técnicas de revisão; Isso é feito em uma revisão editorial.

+ +

Esse artigo descreve como fazer uma revisão editorial, assim ajudando para assegurar que o conteúdo do MDN é preciso.

+ +
+
Qual é a tarefa?
+
Edição e revisão de artigos que estiverem marcados como "precisando de revisão editorial."
+
Onde é que isso precisa ser feito?
+
Em artigos específicos que são marcados como "precisando de revisão editorial."
+
O que é preciso conhecer para fazer essa tarefa?
+
Você precisa ter um bom dominio do idioma Ingles e habilidades de ortografia e gramática. Uma revisão editorial consiste em garantir que a gramática, ortografia e redação estejão corretas e fazendo sentido; E que o guia de estilo de escrita MDN seja seguido.
+
Quais são os passos a seguir?
+
+
    +
  1. Escolha um artigo para revisão: +
      +
    1. Vá para a lista de artigos que precisam de revisão editorial.  Essa lista contém todas as páginas que precisam de revisão editorial.
      2. +
    2. Escolha uma página que tenha título em português que não comece com Template:(Template: Páginas que contém macro-códigos MDN)
      3. +
    3. Clique no link do artigo para carregar a página.
      4. +
    +
    2. +
  2. Quando a página estiver carregada, clique no botão Editar próximo ao topo da página; Isso colocará você no editor MDN. Não hesite em trocar para uma página diferente se você não entendeu bem a página atual.
    3. +
  3. Se não houver erros, você não precisa editar o artigo para marca-lo como revisado. Olhe para uma caixa de "revisão rápida" a esquerda da barra de navegação:
    4. +
+ +

               Selecione a caixa Editorial , e clique em Review Completed.

+ +

4. Se você precisa consertar erros que precisam correção:

+ +
    +
  1. Clique no botão Editar próximo ao topo da página; Isso colocará você no editor MDN.
    2. +
  2. Corrija todas palavras e a gramática ou erros de uso.
    3. +
  3. Digite um Comentário de Revisão na parte de baixo do artigo, algo como 'Editorial revisado, foram corrigidos alguns erros de gramática e ortografia'.
    4. +
  4. Tire a seleção da caixa Editorial abaixo do Revisão necessária?
    5. +
  5. Clique no botão Salvar alterações.
    6. +
+ +
+

Por razões de perfomance, sua edição pode não aparecer logo na página.

+
+
+
diff --git a/files/pt-br/mdn/contribute/guia/escreva_um_artigo_para_ajudar_aprender_sobre_a_web/index.html b/files/pt-br/mdn/contribute/guia/escreva_um_artigo_para_ajudar_aprender_sobre_a_web/index.html new file mode 100644 index 0000000000..7754f741b6 --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/escreva_um_artigo_para_ajudar_aprender_sobre_a_web/index.html @@ -0,0 +1,114 @@ +--- +title: Como escrever um artigo para ajudar as pessoas aprender sobre a Web +slug: MDN/Contribute/guia/Escreva_um_artigo_para_ajudar_aprender_sobre_a_Web +tags: + - Guía + - MDN Meta + - aprendizado + - como fazer +translation_of: MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web +--- +
{{MDNSidebar}}
+ +

MDN's Área de aprendizado é a nossa casa para artigos que introduzem conceitos Web para novos desenvolvedores. Uma vez que seu conteúdo é voltado para iniciantes, este é um ótimo lugar para compartilhar seu conhecimento e ajudar visitantes a conhecer a Web. É importante ter certeza que novos desenvolvedores podem seguir o conteúdo, então nós damos atenção especial para isto.

+ +

Este artigo explica como escrever para a  Área de aprendizado.

+ +

Como escrever um artigo na Área de aprendizado

+ +

Para começar a contribuir com seu conhecimento, simplesmente clique no botão verde e grande, então siga os cinco passos abaixo. Se você está procurando por ideias, por favor dê uma olhada no nosso quadro de time Trello!

+ +

Escreva um artigo de aprendizado

+ +

Este artigo pode não acabar exatamente no lugar certo, mas pelo menos no MDN. Se você deseja falar com alguém sobre mover ele para o lugar certo, por favor  Contate-nos.

+ +

Passo 1: Escreva uma linha-dupla

+ +

A primeira frase do seu artigo precisa resumir sobre qual conteúdo você irá falar e a segunda deve ser um pouco mais específica sobre os itens que você vai inserir no seu artigo. Por exemplo:

+ +
+

Enquanto que os arquivos {{glossary("HTML")}} contém conteúdo estruturado, {{Glossary("CSS")}}, outra grande tecnologia Web, faz o conteúdo aparecer do jeito que você quer. Neste artigo nós vamos cobrir como esta tecnologia funciona, e como escrever seu próprio exemplo básico.

+
+ +

Note como o exemplo explica brevemente que CSS é uma importante tecnologia Web usada para estilizar páginas. Isto é suficiente para o leitor ter uma boa ideia sobre o quê o artigo fala.

+ +

Porque os artigos da Área de Aprendizado primeiramente foca em iniciantes, cada artigo deve cobrir um tópico direto, então não sobrecarregará o leitor com muita informação nova. Se você não resumir o artigo em uma sentença, você pode estar tentando fazer muito em somente um artigo!

+ +

Passo 2: Adicionar uma top box

+ +

Então adicione uma top box para ajudar os leitores com dicas sobre onde eles estão no processo de aprendizagem.  Aqui é um exemplo de top box do "Entendendo URLs e suas estruturas". Você pode usar este artigo como um modelo quando estiver escrevendo o seu próprio.

+ + + + + + + + + + + + +
Pré-requisitos:Você primeiro precisa saber Como a Internet funciona, O que é um servidor Web, and Os conceitos por trás dos links na web.
Objetivo:Você vai aprender o que é uma URL e como ela funciona na Web.
+ +
+
Pré-requisitos
+
O que o leitor, principalmente, precisa saber para seguir este artigo? Quando possível, faça um link de cada pré-requisito para outro artigo da Área de Aprendizado cobrindo o conceito (a menos que este seja um artigo básico que não precisa de nenhum conhecimento anterior).
+
Objetivos
+
Esta seção explica brevemente o que o leitor vai aprender no curso da leitura. Este é um pouco diferente da linha-um; a linha-um resume o tópico do artigo, enquando a seção objetivos especificamente descreve o que o leitor pode esperar ao terminar de ler todo o artigo.
+
 
+
+ +
+

Nota: Para criar esta tabela você pode copiar e colar a tabela do exemplo acima, ou usar a ferramenta do editor do MDN Tabela. Se você escolher usar a ferramenta Tabela, você precisa especificamente adicionar uma classe CSS learn-box adicional a classe padrão standard-table. Para fazer isto, quando você criar ou editar as propriedades da tabela, vá no painel "Avançado" e no campo Classes mudar para "standard-table learn-box".

+
+ +

Passo 3: Escreva uma descrição completa

+ +

Próximo: escreva uma longa descrição que forneça uma visão geral do artigo, destacando os conceitos principais. Não esqueça de explicar por quê o leitor deve pegar seu tempo para aprender este tópico e ler seu artigo!

+ +

Passo 4: Vá fundo

+ +

Quando você tiver terminado com tudo isso, você pode finalmente ir fundo no tema. Você pode estruturar esta parde do seu artigo como você quiser (Por quanto sinta-se livre para consultar nosso guia de estilo). Esta é sua chance de brilhar! Entre nos detalhes explicando o tema que você está escrevendo. Forneça links de referência para a documentação completa, explique como a tecnologia funciona em detalhe, forneça detalhes da sintaxe e usabilidade, e mais. É com você!

+ +

Como um guia, aqui são algumas dicas de escrita para iniciantes:

+ + + +

Dê uma olhada nas primeiras seções do nosso artigo Funções - blocos reutilizáveis de código para uma boa seção descritiva.

+ +

Passo 5: Forneça material de "aprendizado ativo"

+ +

Para ilustrar o artigo e ajudar o leitor a entender melhor o que ele está aprendendo, esteja certo de fornecer exercícios, tutoriais e tarefas para completar. Tendo eles praticando, e ativamente usando e experimentando os conceitos que seu artigo explica, você pode ajudar a fixar a informação no cérebro do leitor.

+ +

Você pode escolher incluir os exemplos diretamente nas páginas como  exemplos ao vivo, ou fazer links para eles se eles não funciona como exemplos ao vivo. Se você está interessado em ajudar a criar estes materiais de valores, por favor leia o artigo Criar um exercício interativo para ajudar o Aprendendo a Web.

+ +

Se você não pode fornecer links para materiais de aprendizado ativo (você não conhece nenhum ou não tem tempo para criar), você deveria adicionar uma tag {{Tag("NeedsActiveLearning")}} para o artigo. Assim outros contribuintes podem encontrar artigos que precisam de materiais de aprendizado ativo e talvez ajudar você com isto.

+ +

Dê uma olhada no Aprendizado ativo: selecionando diferentes elementos para um exemplo de exercício de aprendizado interativo, ou Aprendizado ativo: Jogando com escopo para um estilo diferente de exercício que permite fazer download de um template no dispositivo do leitor e modificá-lo seguindo os passos fornecidos.

+ +

Passo 6: Tenha o artigo revisto e colocado no menu de navegação da Área de aprendizado

+ +

Depois de ter escrito seu artigo, deixe-nos saber para podermos dar uma olhada, fazer uma revisão e sugerir melhorias. Novamente, veja nossa seção Contato, é a melhor maneira de manter contato.

+ +

Outra parte na finalização do seu artigo é colocar ele na área principal no menu de navegação da Área de Aprendizado. Este menu é gerado pelo LearnSidebar macro, o qual você precisa de privilégios especiais para editar, então, novamente, converse com alguém do nosso time sobre adicionar isto.

+ +

Você deveria pelo menos adicionar isso na sua página - isto é feito adicionando a chamada do macro \{{LearnSidebar}} dentro de um parágrafo no topo da sua página

+ + + +

Artigos sugeridos

+ +

Então você quer contribuir, mas você não tem certeza sobre o que escrever?

+ +

O time da Área de aprendizado mantém um quadro Trello com ideias de artigos para escrever. Sinta-se livre para pegar um e começar a trabalhar!

+ +

 

+ +

 

diff --git a/files/pt-br/mdn/contribute/guia/index.html b/files/pt-br/mdn/contribute/guia/index.html new file mode 100644 index 0000000000..7a8e36996a --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/index.html @@ -0,0 +1,8 @@ +--- +title: Guia de contribuição +slug: MDN/Contribute/guia +translation_of: MDN/Contribute/Howto +--- +
{{MDNSidebar}}

Os seguintes artigos fornecem orientações passo-a-passo para realização de tarefas específicas no MDN.

+ +

{{LandingPageListSubpages}}

diff --git a/files/pt-br/mdn/contribute/guia/set_the_summary_for_a_page/index.html b/files/pt-br/mdn/contribute/guia/set_the_summary_for_a_page/index.html new file mode 100644 index 0000000000..91ac82e8ea --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/set_the_summary_for_a_page/index.html @@ -0,0 +1,61 @@ +--- +title: Como definir o resumo de uma página +slug: MDN/Contribute/guia/Set_the_summary_for_a_page +tags: + - Como + - Guia(2) + - MDN Meta +translation_of: MDN/Contribute/Howto/Set_the_summary_for_a_page +--- +
{{MDNSidebar}}

Você pode definir o sumário de uma página no MDN, para ser usado de várias maneiras, incluindo em resultados de pesquisa, em outras páginas MDN como tópico de página de regiões, e em dicas. E o texto deve fazer sentido tanto ao contexto da página, como quando mostrado em outro contexto, sem o restante do conteúdo da página.

+ +

Um sumário pode ser bem definido com a página. Caso não seja bem definido, normalmente a primeira frase é usada, e nem sempre esta é a melhor maneira de se apresentar o conteúdo da página.

+ + + + + + + + + + + + + + + + + + + + +
Qual é a tarefa?Marcando o texto dentro de uma página que deve ser usado como seu resumo em outros contextos; esta tarefa pode incluir, se necessário escrever um texto adequado.
Onde isto deve ser feito?Em páginas que não possuem um resumo ou têm um resumo menos do que ótimo.
O que você deve saber para fazer a tarefa?Capacidade de usar o editor MDN; boas habilidades de escrita em inglês; familiaridade suficiente com o tema da página para escrever um bom resumo.
Quais são os passos a fazer? +
    +
  1. Escolha uma página para fazer o resumo: +
      +
    1. Na página MDN documentation status, clique sob o link Sections para um tema que você conhece um pouco sobre (por exemplo, HTML):
      +
      2. +
    2. Na página de status da documentação do tópico, clique no cabeçalho de páginas na tabela de 
      3. +
    3. Resumo. Isso leva você a um índice de todas as páginas em que seção do tópico; Ele mostra a página 
      4. +
    4. de links na coluna da esquerda e as tags e resumos na coluna à direita:
      5. +
      6. +
    6. Escolha uma página que está faltando um resumo, ou que tem um resumo fraco:
      +
      7. +
    7. Clique no link para ir para essa página.
      8. +
    +
    2. +
  2. Clique em Editar para abrir a página no editor MDN.
    3. +
  3. Procure uma frase ou duas, que funcionam como um resumo fora de contexto. Se necessário, edite o conteúdo existente para criar ou modificar frases para ser um bom resumo.
    4. +
  4. Selecionar o texto a ser usado como um resumo.
    5. +
  5. Nos estilos de elementos gráficos da barra de ferramentas do editor, selecione Resumo SEO. (No código fonte da página, isso cria uma {{HTMLElement("span")}} elemento com class = "seoSummary " em torno do texto selecionado.)
    +
    6. +
  6. Salve suas alterações com um comentário de revisão em como "Definir a página Resumo."
    7. +
+
+ +

 

+ +

 

+ +

 

diff --git a/files/pt-br/mdn/contribute/guia/tag_javascript_pages/index.html b/files/pt-br/mdn/contribute/guia/tag_javascript_pages/index.html new file mode 100644 index 0000000000..7c6f94ac07 --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/tag_javascript_pages/index.html @@ -0,0 +1,84 @@ +--- +title: Como marcar páginas de JavaScript +slug: MDN/Contribute/guia/Tag_JavaScript_pages +tags: + - Como + - Guia(2) + - JavaScript + - MDN Meta +translation_of: MDN/Contribute/Howto/Tag_JavaScript_pages +--- +
{{MDNSidebar}}

O tagueamento consiste na adição de meta-informações para as páginas de modo que o conteúdo relacionado possa ser agrupado, como por exemplo em uma ferramenta de pesquisa.

+ + + + + + + + + + + + + + + + +
E onde isso precisa ser feito?Dentro de páginas especificas relacionadas com Javascript e sem marcação.
O que é preciso saber para fazer a tarefa ? +
    +
  • O basico de javascript como saber o que é um metodo ou uma propriedade.
    • +
+
Quais são os passos para fazê-lo? +
    +
  1. Escolha uma das paginas na lista 'linkada' acima.
    2. +
  2. Click no link do artigo e carregue a página.
    3. +
  3. Uma vez que a página foi carregada, clique no botão Editar no topo, isso deve lhe posicionar no editor MDN.
    4. +
  4. Pelo menos uma tag Javascript deve ser adicionada. Aqui estão algumas outras tags possíveis para adicionar: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    TagA página que está em uso.
    Methodmétodo
    PropertyPropriedade
    prototypeprotótipo
    Object type namemétodo de um objeto; por exemplo String.fromCharCode deve ser a sequência da tag String
    ECMAScript6 and Experimentalrecursos adicionados na nova versão do ECMAScript
    Deprecatedrecursos obsoletos (cujo o uso é desencorajado, mas ainda suportada)
    Obsoleterecursos obsoletos (que não são mais suportados em browsers modernos)
    othersver as normas de tagueamento MDN para aplicar outras tags possíveis.
    +
    5. +
  5. Salve com um comentário.
    6. +
  6. E está pronto!
    7. +
+
diff --git a/files/pt-br/mdn/contribute/guia/vincular_uma_conta_github/index.html b/files/pt-br/mdn/contribute/guia/vincular_uma_conta_github/index.html new file mode 100644 index 0000000000..4a158cb44c --- /dev/null +++ b/files/pt-br/mdn/contribute/guia/vincular_uma_conta_github/index.html @@ -0,0 +1,113 @@ +--- +title: Como vincular uma conta do Github ao perfil do MDN +slug: MDN/Contribute/guia/VIncular_uma_conta_github +tags: + - Documentação + - MDN + - MDN Meta + - MDN Projeto +translation_of: Archive/MDN/Howto_Link_a_Github_account +--- +
{{MDNSidebar}}
+ +
{{IncludeSubnav("/en-US/docs/MDN")}}
+ +
+

Note: Support for Persona logins on MDN was disabled on November 1, 2016. The method for adding a Github account to your profile therefore no longer works. If you didn't add a GitHub login to your MDN account before we disabled Persona logins, please file an "Account Help" bug on Bugzilla. For further reading about the end of life of Persona, see: Persona shutdown guidelines.

+
+ +

Porque o sistema de autenticação Mozilla Persona está sendo desativado em 30 de Novembro de 2016, todos os usuários que querem contribuir para o MDN vai precisar ter outros meios para logar-se no MDN. Atualmente, a única alternativa que nós suportamos é o Github, então você vai precisar adicionar uma autenticação do   GitHub ao seu perfil do MDN.

+ +
+

Você deve fazer isso antes de 30 de Novembro de 2016, ou você já não terá outra forma de logar-se no MDN.

+
+ +

Visão Geral

+ +

Adicionando uma autentitação do GIthub não é díficil de se fazer. Nós vamos entrar em detalhes em um momento, mas primeiro, aqui uma lista rápida dos passos involvidos:

+ +
    +
  1. Logando-se em sua conta do MDN com Persona.
    2. +
  2. Indo a página contas vinculadas.
    3. +
  3. Adicionando uma autenticação do GIthub.
    4. +
+ +

Instruções detalhadas

+ +

Aqui estão um guia passo-a-passo com detalhes sobre como fazer tudo que você precisa fazer.

+ +

Logando-se em sua conta do MDN

+ +
    +
  1. No topo de qualquer página do MDN, passe o mouse por cima ou clique em Entrar. Isso vai exibir metodos de aautenticação disnponíveis, Persona ou Github.
    + Sign in box on MDN, showing Persona and Github.
    2. +
  2. Selecione Persona e entre usando suas credenciais atuais.
    3. +
+ +

Vá a página "Contas vinculadas".

+ +

Aqui estão duas formas para adicionar a página contas vinculadas.

+ +

A primeira é simples, clique no link abaixo.

+ +

De outra forma, faça o seguinte:

+ +
    +
  1. CLique no seu nome de usuário no topo de qualquer página do MDN. (Isso está na posiçãoo onde a caixa de Entrar quando você não estiver logado.
    2. +
  2. Abra o menu da "Engrenagem" , e clique em Contas vinculadas
    + Gear menu in profile, showing the "Account connections" option
    3. +
+ +

Adicione uma autenticação do Github

+ +

Você está agora em "Contas Vinculadas", qual lista a conta external você já tem vinculada ao seu perfil do MDN. Se o Github já estiver listado, parabéns! Você está pronto para ir! mas teste isso para ter certeza que você se lembra de sua senha, desconecte-se e volte usando suas credenciais do GIthub

+ +

Se GIthub não estiver listado, quando próximo ao fim da página, olhe abaixo da lista de contas externais já listadas, você pode conectar seu perfil do MDN. Isso se parece com assim:

+ +

+ +

Para adicionar :

+ +
    +
  1. Clique Conectar com GIthub. MDN vai contactar GIthub requesitando permissão para vincular a conta. Se você não estiver conectado no Github, você vai ser perguntado:
    + Screenshot of GitHub sign in window.
    2. +
  2. Se você tiver autenticação de dois fatores ativada em sua conta GitHub, você será solicitado a digitar o seu código de autenticação:
    + Screenshot of GitHub's Two-factor authentication window.
    3. +
  3. Agora que você está conectado à sua conta GitHub, você será solicitado a autorizar a ligação entre GitHub e MDN (a menos que você já tem a autorização em arquivo por algum motivo). Esta página é mostrada abaixo.
    + Screenshot of GitHub "Authorize application" window.
    + Clique no botão verde Autorizar Aplicativo para conceder permissão para o seu perfil MDN para acessar sua conta GitHub. Se a conta GitHub está ligada com sucesso ao seu perfil MDN, você verá esta mensagem:
    + Account successfully created.
    4. +
+ +

Não apenas você pode agora usar GitHub para fazer login no MDN, mas na verdade você está já assinado em usar sua autenticação GitHub! Agora você está pronto para o desligamento Persona. Certifique-se de atualizar quaisquer gerenciadores de senha você pode ter instalado, se necessário.

+ +

Troubleshooting

+ +

Se você tiver problemas ao tentar adicionar sua conta do GitHub ao seu perfil, espero que as dicas de solução de problemas a seguir vai ajudar.

+ +

Erro :  Não foi possivel encontrar conta correspondente ao perfil

+ +

Se você tentar adicionar sua conta do GitHub ao seu perfil e obter o erro "Não foi possível encontrar conta correspondente perfil", pode significar algumas coisas diferentes. Se você tiver várias contas na sua conta GitHub, pode haver alguma confusão; GitHub não pode relatar o endereço de email esperada para MDN durante a tentativa de conta de emparelhamento, o que irá resultar neste erro. Outras falhas no processo pode também resultar na mesma mensagem de erro.

+ +

Uma maneira de contornar esse problema: abrir uma nova janela privada no seu browser; no Firefox, por exemplo, escolha "Nova Janela privada" no menu Arquivo (ou pressione Ctrl+Shift+P [Cmd-Shift-P no Mac]). Navegue até MDN lá, logue na sua conta do MDN, tente novamente para adicionar sua conta do GitHub para o seu perfil como indicado acima.

+ +

Meu autorização GitHub não é exibido na página Connections conta.

+ +

Isso pode ser um problema de cache. Recarregar a página ou desconectado e efetuar login novamente deve resolver o problema.

+ +

Persona não lembra-se de mim

+ +

Se você tentar fazer login no Persona assim você pode adicionar um login GitHub para a sua conta MDN e se disse "O seu endereço de e-mail é novo para nós," esta é provavelmente porque ele foi tempo suficiente desde seu último login na Persona que tenha excluído seu endereço de e-mail de seu sistema. Isto acontece depois de algum período de tempo; a janela de login Persona parece com isso nessa situação:

+ +

+ +

Se isso acontecer, você precisa simplesmente seguir as instruções do Persona para criar uma nova senha para esse endereço de e-mail. O MDN não se preocupam com este processo; o fato de que o seu endereço de e-mail corresponde up é tudo o que importa. Um e-mail de confirmação será enviado para verificar se você possui o endereço de e-mail, provavelmente de no-reply@persona.org. Se você tem filtragem de spam, ele pode ser enviado para a pasta de spam.
+
+ Depois de terminar o processo de definir a senha para o endereço de e-mail usado para fazer login no MDN, o seu acesso ao MDN será restaurada. Em seguida, você pode seguir os passos na {{anch ( "Instruções detalhadas")}} acima para adicionar o seu login GitHub para a sua conta MDN.

+ +

Veja também

+ + diff --git a/files/pt-br/mdn/contribute/index.html b/files/pt-br/mdn/contribute/index.html new file mode 100644 index 0000000000..4260e74402 --- /dev/null +++ b/files/pt-br/mdn/contribute/index.html @@ -0,0 +1,20 @@ +--- +title: Contribuindo para o MDN +slug: MDN/Contribute +tags: + - Guía + - MDN Meta + - Página de destino +translation_of: MDN/Contribute +--- +
{{MDNSidebar}}
+ +
{{IncludeSubnav("/pt-BR/docs/MDN")}}
+ +

Bem-vindo! Ao visitar esta página, você deu o primeiro passo para se tornar um colaborador da MDN.

+ +

Os guias listados aqui aqui cobrem todos os aspectos de contribuição para a MDN, incluindo guias de estilo, guia de utilização do nosso editor e ferramentas e muito mais. Por favor, assegure-se de ler (e estar em conformidade) com os Termos da Mozilla antes de editar ou criar qualquer página.

+ +

Se você não contribuiu com a MDN anteriormente, o guia de primeiros passos pode lhe ajudar a selecionar uma tarefa para começar a ajudar.

+ +

{{LandingPageListSubPages()}}

diff --git a/files/pt-br/mdn/contribute/persona_sign-in/index.html b/files/pt-br/mdn/contribute/persona_sign-in/index.html new file mode 100644 index 0000000000..7c36309f88 --- /dev/null +++ b/files/pt-br/mdn/contribute/persona_sign-in/index.html @@ -0,0 +1,32 @@ +--- +title: MDN e Persona logins +slug: MDN/Contribute/Persona_sign-in +tags: + - Documentação + - MDN + - MDN Meta + - Mozilla + - Persona +translation_of: Archive/MDN/Persona_sign-ins +--- +
{{MDNSidebar}}
+

Nós não damos mais suporte ao acesso via Persona na MDN.Por favor conecte sua conta do Github ao seu perfil na MDN agora para que você possa continuar a logar na sua conta da MDN.

+
+ +

Atualmente, a MDN permite que colaboradores loguem usando dois provedores de autenticação diferentes: Mozilla Persona e GitHub. A partir do dia 1º de novembro de 2016, nós iremos remover o Persona como uma opção para fazer o login. Por isso, é necessário ativar a autenticação Github no seu perfil para evitar a perda de acesso de login para MDN.

+ +

Nós reconhecemos que isso é um inconveniente, e nós pedimos desculpas por isso. Infelizmente, isso está fora de nosso controle.

+ +

Porque o Persona está sendo removido?

+ +

A Mozilla fechou o projeto Persona, e seus servidores serão desligados em novembro de 2016. Você pode entender melhor sobre a decisão da Mozilla em encerrar o Persona no wiki da Mozilla.

+ +

 

+ +

A MDN oferecerá outro provedor de autenticação?

+ +

Nós gostaríamos muito de fazer isso, mas ainda não identificamos outro fornecedor que atenda às nossas necessidades; Além disso, atualmente não temos os recursos de desenvolvimento para integrar outro provedor. Por enquanto, a única opção para manter o acesso do colaborador na MDN é ligar o seu perfil MDN à sua conta GitHub.
+
+ Caso você não tenha como associar sua conta GitHub, por favor, preencha este formulário "Suporte as contas"  no Bugzilla.

+ +

Tenha em mente, que você não precisa fazer login na MDN para ler nosso conteúdo. Mas se você tem uma conta para contribuir, e gostaria de poder contribuir a qualquer momento no futuro, não se esqueça de adicionar uma conta GitHub ao seu perfil o mais rápido possível, antes de 31 de outubro de 2016.

diff --git a/files/pt-br/mdn/contribute/processos/index.html b/files/pt-br/mdn/contribute/processos/index.html new file mode 100644 index 0000000000..bfac34ce26 --- /dev/null +++ b/files/pt-br/mdn/contribute/processos/index.html @@ -0,0 +1,6 @@ +--- +title: Processos de documentação +slug: MDN/Contribute/Processos +translation_of: MDN/Contribute/Processes +--- +
{{MDNSidebar}}

O projeto de documentação do MDN é enorme; há um grande número de tecnologias para cobrir e nós temos centenas de colaboradores em todo o mundo. Para ajudar a trazer ordem ao caos, temos processos padrões a seguir quando se trabalha em tarefas específicas relacionadas com a documentação. Aqui você vai encontrar os guias para esses processos.

-- cgit v1.2.3-54-g00ecf