From 2c2df5ea01eb5cd8b9ea226b2869337e59c5fe3e Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 14:50:24 +0100 Subject: unslug pt-pt: move --- .../contribute/howto/be_a_beta_tester/index.html | 52 ++++++++++ .../howto/create_an_mdn_account/index.html | 41 ++++++++ .../howto/do_a_technical_review/index.html | 65 ++++++++++++ .../howto/do_an_editorial_review/index.html | 56 ++++++++++ .../howto/set_the_summary_for_a_page/index.html | 47 +++++++++ .../howto/tag_javascript_pages/index.html | 75 ++++++++++++++ .../index.html | 114 +++++++++++++++++++++ 7 files changed, 450 insertions(+) create mode 100644 files/pt-pt/orphaned/mdn/contribute/howto/be_a_beta_tester/index.html create mode 100644 files/pt-pt/orphaned/mdn/contribute/howto/create_an_mdn_account/index.html create mode 100644 files/pt-pt/orphaned/mdn/contribute/howto/do_a_technical_review/index.html create mode 100644 files/pt-pt/orphaned/mdn/contribute/howto/do_an_editorial_review/index.html create mode 100644 files/pt-pt/orphaned/mdn/contribute/howto/set_the_summary_for_a_page/index.html create mode 100644 files/pt-pt/orphaned/mdn/contribute/howto/tag_javascript_pages/index.html create mode 100644 files/pt-pt/orphaned/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html (limited to 'files/pt-pt/orphaned/mdn/contribute') diff --git a/files/pt-pt/orphaned/mdn/contribute/howto/be_a_beta_tester/index.html b/files/pt-pt/orphaned/mdn/contribute/howto/be_a_beta_tester/index.html new file mode 100644 index 0000000000..ec68693a32 --- /dev/null +++ b/files/pt-pt/orphaned/mdn/contribute/howto/be_a_beta_tester/index.html @@ -0,0 +1,52 @@ +--- +title: Como participar nos testes "beta" +slug: MDN/Contribute/Howto/Participar_testes_beta +tags: + - MDN Meta + - Metadados MDN +translation_of: MDN/Contribute/Howto/Be_a_beta_tester +--- +
{{MDNSidebar}}

De vez em quando, à medida que os programadores da plataforma Kuma da MDN fazem alterações no site, nós oferecemos acesso antecipado a essas novas funcionalidades aos membros que optaram por participar nos testes "beta". Como é típico com qualquer teste "beta", as funcionalidades podem não funcionar corretamente em algumas situações.

+ +

Participar nos testes "beta"

+ +
    +
  1. Depois de iniciar a sessão na MDN, clique no seu nome de utilizador na barra de navegação no topo.
    + Shows location of the user's profile link in the top navigation
    + This takes you to your profile page.
    2. +
  2. Clique no botão "Edit".
    + Shows location of the button to edit a user's profile (which may vary depending on window dimensions
    + This opens the profile page in edit mode.
    3. +
  3. Selecione a caixa para Beta tester.
    + Shows the location of the Beta Tester checkbox
    4. +
  4. Clique no botão "Publicar" no fim da página de perfil.
    + Shows the location of the Publish button on a user's profile page
    5. +
+ +

Cancelar participação nos testes "beta"

+ +
    +
  1. While logged in to MDN, click your user name in the top navigation bar. This takes you to your profile page.
    2. +
  2. Click the Edit button. This opens the profile page in edit mode.
    3. +
  3. Clear the checkbox for Beta tester.
    4. +
  4. Click the Publish button.
    5. +
+ +

Dê a sua opinião/comentário sobre os testes "beta"

+ +

There are two ways you can give feedback about a beta test:

+ + + +
    +
  1. Create an account on Bugzilla if you don't already have one.
    2. +
  2. Open a bug report in Bugzilla for MDN.
    3. +
  3. Include the word "beta" in the Summary field to help MDN developers filter and triage incoming bugs.
    4. +
  4. Fill out the bug report form to the best of your ability. Be as detailed as possible.
    5. +
  5. Click the Submit button.
    6. +
+ +

 

diff --git a/files/pt-pt/orphaned/mdn/contribute/howto/create_an_mdn_account/index.html b/files/pt-pt/orphaned/mdn/contribute/howto/create_an_mdn_account/index.html new file mode 100644 index 0000000000..058456953e --- /dev/null +++ b/files/pt-pt/orphaned/mdn/contribute/howto/create_an_mdn_account/index.html @@ -0,0 +1,41 @@ +--- +title: Como criar uma conta MDN +slug: MDN/Contribute/Howto/Criar_uma_conta_MDN +tags: + - Como + - Documentação + - Guía + - Metadados MDN + - Principiante +translation_of: MDN/Contribute/Howto/Create_an_MDN_account +--- +
{{MDNSidebar}}
+ +

Para editar conteúdo na MDN precisa de um perfil MDN. Não precisa de um perfil se só pretende ler e pesquisar documentos na MDN. Este guia irá ajudá-lo a configurar o seu perfil na MDN.

+ +
Porque é que a MDN precisa do meu endereço de e-mail?
+
+O seu endereço de e-mail é utilizado para a recuperação da conta e, se necessário, pelos administradores da MDN para o contactar sobre a sua conta ou atividade no site.
+
+Adicionalmente, pode registar-se para receber notificações (tais como, quando são alteradas páginas especificas) e mensagens (por exemplo, se optar por aderir à nossa equipa de testes beta, poderá receber mensagens sobre as novas funcionalidades que precisam de ser testadas).
+
+O seu endereço de e-mail nunca é exibido na MDN e será utilizado apenas de acordo com a nossa politica de privacidade (EN).
+ +
Se iniciou a sessão na MDN via GitHub, e utiliza um endereço de e-mail  "não responder" no GitHub, não irá receber mensagens (incluindo as notificações quando subecrever páginas) na MDN.
+ +
    +
  1. No topo de cada página na MDN irá encontrar um botão nomeado "Iniciar sessão". Clique com o seu rato (ou toque no mesmo, se estiver a utilizar um dispositivo móvel) para exibir uma lista de serviços de autenticação que nós suportamos para iniciar a sessão na MDN.
    2. +
  2. Selecione um serviço para iniciar a sessão. Atualmente, apenas está disponível o GitHub. Note que se selecionar o GitHub, será incluída uma hiperligação para o seu perfil do GitHub na página pública do seu perfil da MDN.
    3. +
  3. Siga os avisos do GitHub para entrar na sua conta MDN.
    4. +
  4. Assim que o serviço de autenticação volta para o seu MDN, ser-lhe-á pedido para inserir um nome de utilizador e um endereço de e-mail. O seu nome de utilizador será exibido publicamente para creditar o seu trabalho realizado. Não utilize o seu endereço de e-mail como o seu nome de utilizador.
    5. +
  5. Clique em Criar o meu perfil MDN.
    6. +
  6. Se o endereço de e-mail especificado no passo 4 não for o mesmo que utilizou no serviço de autenticação, por favor, verifique o seu e-mail e clique na hiperligação na mensagem de confirmação que nós lhe enviamos.
    7. +
+ +

E é tudo! Agora tem uma conta MDN, e pode editar as páginas imediatamente!

+ +

Pode clicar no seu nome no topo de qualquer página da MDN para ver o seu perfil público. Lá, pode clicar em Editar para efetuar alterações ou adições ao seu perfil.

+ +
+

Os novos nomes de utilizador não podem conter espaços ou o caráter "@". Lembre-se que o seu nome de utilizador será exibido publicamente para identificar o seu trabalho realizado!

+
diff --git a/files/pt-pt/orphaned/mdn/contribute/howto/do_a_technical_review/index.html b/files/pt-pt/orphaned/mdn/contribute/howto/do_a_technical_review/index.html new file mode 100644 index 0000000000..def53aa207 --- /dev/null +++ b/files/pt-pt/orphaned/mdn/contribute/howto/do_a_technical_review/index.html @@ -0,0 +1,65 @@ +--- +title: Como efetuar uma revisão técnica +slug: MDN/Contribute/Howto/Como_efetuar_revisao_tecnica +tags: + - Como + - Documentação + - Guía + - Metadados MDN + - Revisão +translation_of: MDN/Contribute/Howto/Do_a_technical_review +--- +
{{MDNSidebar}}
+ +
{{IncludeSubnav("/en-US/docs/MDN")}}
+ +

'Uma revisão Técnica' consiste em rever a exatidão técnica e a integridade de um artigo e corrigi-lo, se necessário. Se um escritor de um artigo quiser que outra pessoa verifique o conteúdo técnico de um artigo, o escritor marca a caixa de seleção "Revisão técnica" durante a edição. Muitas vezes, o escritor entra em contacto com um técnico específico para realizar a revisão técnica, mas qualquer pessoa com conhecimento técnico no assunto pode efetuar uma.

+ +

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

+ +
+
O que é uma tarefa?
+
Rever e corrigir os artigos para uma perfeição e exatidão técnica.
+
+

 

+ Onde é que esta precisa de ser efetuada?
+
Nos artigos específicos que são marcados como 'necessária uma revisão técnica' (em inglês).
+
O que precisa de saber para realizar a tarefa?
+
+
    +
  • +

    Conhecimento especializado do tópico do artigo que está a rever. Se ao ler o artigo não lhe ensina algo significativamente novo, considere-se um especialista.

    +
    • +
  • Como editar um artigo da wiki na MDN.
    • +
+
+
Quais são os passos a seguir?
+
+
    +
  1. Escolha um artigo para rever: +
      +
    1. Vá para lista das páginas que precisam de revisões técnicas. I +

       

      + sto lista todas as páginas para as quais uma revisão técnica foi solicitada.
      2. +
    2. Escolha uma página cujo tópico esteja familizarizado.
      3. +
    3. Clique na hiperligação do artigo para carregar a página.
      4. +
    +
    2. +
  2. Leia o artigo, tendo em atenção os detalhes técnicos: O artigo está correto? Tem alguma coisa em falta? Não hesite em mudar para uma página diferente se a primeira que escolheu não lhe é conveniente.
    3. +
  3. Se não existirem erros, não precisa de editar o artigo para o marcar como revisto. Veja na caixa "revisão rápida" na barra lateral esquerda da página. Esta caixa amarela lista quaisquer revisões pendentes e deixa-o limpar a bandeira do pedido da sua revisão. Parece-se com isto se foi solicitada uma revisão técnica:
    + Screenshot of the sidebar's box listing reviews that have been requested and allowing the flags to be changed.
    4. +
  4. Desselecione a caixa Técnico, e clique em Guardar.
    5. +
  5. Se encontrar erros que precisam de ser corrigidos, irá ficar feliz em saber que também pode alterar o estado da solicitação de revisão no editor. Aqui tem o fluxo de trabalho: +
      +
    1. Para editar a página, clique em Editar perto do topo da página; isto coloca-o no editor da MDN.
      2. +
    2. Corrigir qualquer informação técnica que não esteja correta, e/ou adicioanr qualquer informação importante que esteja em falta.
      3. +
    3. Inserir um 'Comentário da Revisão' no fim do artigo. Esta é uma breve mensagem que descreve o que fez, tal como 'Revisão técnica concluída'. Se corrigiu a informação, inclua isso no seu comentário, por exemplo, 'Revisão técnica e descrições dos parâmetros corrigidos'. Isto ajuda os outros colaboradores e editores de sites a saberem o que alterou e o porquê. Também pode mencionar se existiam partes específicas que não se sentia qualificado para rever.
      4. +
    4. Desselecionar a caixa Técnico sob Revisão necessária?.
      5. +
    5. Clique em PUBLICAR.
      6. +
    +
    6. +
+ +

Parabéns! Concluiu a sua primeira revisão técnica! Obrigado pela sua ajuda!

+
+
diff --git a/files/pt-pt/orphaned/mdn/contribute/howto/do_an_editorial_review/index.html b/files/pt-pt/orphaned/mdn/contribute/howto/do_an_editorial_review/index.html new file mode 100644 index 0000000000..d2902a8bb6 --- /dev/null +++ b/files/pt-pt/orphaned/mdn/contribute/howto/do_an_editorial_review/index.html @@ -0,0 +1,56 @@ +--- +title: Como efetuar uma revisão editorial +slug: MDN/Contribute/Howto/fazer_revisão_editorial +tags: + - Como + - Documentação + - Guía + - Metadados MDN + - Revisão Editorial +translation_of: MDN/Contribute/Howto/Do_an_editorial_review +--- +
{{MDNSidebar}}
+ +
{{IncludeSubnav("/pt-PT/docs/MDN")}}
+ +

As revisões editoriais consistem em corrigir erros de digitação, ortografia, gramática, utilização ou erros textuais num artigo. Não é preciso ser um especialistas em linguagem para efetuar contribuições úteis para a documentação técnica da MDN, mas os artigos continuam a precisar de edição de cópia e revisão de provas. Isto é efetuado numa revisão editorial.

+ +

Este artigo descreve como efetuar uma revisão editorial, que ajuda a assegurar que o conteúdo na MDN é preciso e bem escrito.

+ +
+
O que é a tarefa?
+
Copy-editing and proof-reading of articles that are marked as requiring an editorial review.
+
Onde é que esta tem de ser efetuada?
+
Within specific articles that are marked as requiring an editorial review.
+
O que precisa de saber para efetuar a tarefa?
+
You need to have good English grammar and spelling skills. An editorial review is about ensuring that the grammar, spelling, and wording are correct and make sense, and that the MDN writing style guide is followed.
+
Quais os passos a seguir?
+
+
    +
  1. Escolha um artigo para rever: +
      +
    1. Go to the list of articles needing editorial review. This lists all the pages for which an editorial review has been requested.
      2. +
    2. Click on the article link to load the page.
      + Nota: This listing is generated automatically but infrequently, so some articles appear on the list that no longer need editorial review. If the article you picked does not display a banner that says "This article needs an editorial review", skip that article and pick a different one.
      3. +
    +
    2. +
  2. Read the article, paying close attention for typos, spelling, grammar, or usage errors. Don't hesitate to switch to a different page if the first one you choose doesn't suit you.
    3. +
  3. If there are no errors, you don't need to edit the article to mark it as reviewed. Look for the "quick review" box in the left sidebar of the page:
    + Screenshot of the editorial review request sidebar box
    4. +
  4. Deselect the Editorial box and click Save.
    5. +
  5. If you find errors that need to be corrected: +
      +
    1. Click the Edit button near the top of the page; this brings you into the MDN editor.
      2. +
    2. Correct any typos and spelling, grammar, or usage errors you find. You don't have to fix everything to be useful, but be sure to leave the editorial review request in place if you don't feel reasonably sure that you've done a complete review of the entire article.
      3. +
    3. Enter a Revision Comment at the bottom of the article; something like 'Editorial review: fixed typos, grammar & spelling.' This lets other contributors and site editors know what you changed and why.
      4. +
    4. Deselect the Editorial box under Review Needed?. This is located just below the Revision Comment section of the page.
      5. +
    5. Click the Publish button.
      6. +
    +
    6. +
+ +
+

Depois de guardar, as suas alterações poderão não ser visíveis de imediato; existe um pequeno atraso enquanto a página é processada e guardada.

+
+
+
diff --git a/files/pt-pt/orphaned/mdn/contribute/howto/set_the_summary_for_a_page/index.html b/files/pt-pt/orphaned/mdn/contribute/howto/set_the_summary_for_a_page/index.html new file mode 100644 index 0000000000..172aed7d5d --- /dev/null +++ b/files/pt-pt/orphaned/mdn/contribute/howto/set_the_summary_for_a_page/index.html @@ -0,0 +1,47 @@ +--- +title: Como definir o resumo para uma página +slug: MDN/Contribute/Howto/Como_definir_o_resumo_para_uma_pagina +tags: + - Como + - Guia(2) + - Metadados MDN +translation_of: MDN/Contribute/Howto/Set_the_summary_for_a_page +--- +
{{MDNSidebar}}

Pode definir-se o resumo de uma página no MDN para ser usada de várias maneiras, incluindo em resultados de motores de busca, noutras páginas MDN tais como páginas de destino de tópicos, e dicas ou sugestões de ajuda. Deverá ser um texto que faça sentido quer no contexto da página, quer quando aparece noutros contextos, sem que esteja disponível a totalidade do conteúdo.

+ +

Um resumo pode definido explicitamente em apenas uma página. Se não estiver explicitamente definido, então normalmente usam-se as primeiras linhas, o que nem sempre é o melhor para o objectivo pretendido.

+ +
+
O que é uma tarefa?
+
Identificar o texto de uma página que melhor poderia ser usado para ser o seu resumo, mesmo que apareça noutros contextos; esta tarefa poderá incluir editar o texto existente e/ou introduzir texto apropriado se necessário.
+
Onde é que esta precisa de ser feita?
+
Em páginas que não têm resumos ou têm um resumo menos bom.
+
O que precisa de saber para efectuar a tarefa?
+
Habilitação para usar o editor MDN; competência em português escrito; familiaridade suficiente com o tópico para escrever um bom resumo.
+
Quais os passos a seguir?
+
+
    +
  1. Escolher uma página para colocar um resumo: +
      +
    1. Na página Estado do documento por tópico, clique num tópico de que tenha algum conhecimento (por exemplo, HTML) da coluna Secções: 
      +
      2. +
    2. Na página de Estado do documento do tópico escolhido, clicar no cabeçalho Pages da tabela Summary.  Irá para um índice de todas as páginas da secção correspondente ao tópico escolhido; mostra os links das páginas na coluna esquerda, e as palavras-chave e resumos na coluna da direita:
      +
      3. +
    3. Escolher uma página que não tenha ou tenha um fraco resumo:
      +
      4. +
    4. Clicar no link para ir para essa página.
      5. +
    +
    2. +
  2. Clicar em  Edit para abrir a página no editor MDN.
    3. +
  3. Tentar encontrar uma frase ou duas que possam servir de resumo, mesmo fora de contexto. Se necessário, editar o conteúdo existente para criar ou modificar frases de modo a que estas se tornem um bom resumo.
    4. +
  4. Seleccionar o texto que irá ser usado como resumo.
    5. +
  5. Na ferramenta Estilos, da barra de ferramentas do editor, seleccionar SEO Summary. (Na página de código fonte, isto cria um elemento {{HTMLElement("span")}}  com  class="seoSummary" em volta do texto seleccionado.)
    +
    6. +
  6. Guardar as alterações com um comentário de revisão. O comentário é opcional, mas é encorajado pois torna mais fácil para os outros utilizadores o rastreio de alterações.
    7. +
+ +

 

+
+
+ +

 

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

A marcação consiste na adição de informação-metadados às páginas, e assim o conteúdo relacionado pode ser agrupado, por exemplo, na ferramenta de pesquisa.

+ +
+
Onde é que isso precisa ser feito?
+
Nas páginas relacionadas com JavaScript especificas sem marcações (tags)
+
O que precisa de saber para efetuar a tarefa?
+
Conhecimento de codificação JavaScript básico, tal como saber o que é um 'método' ou uma 'propriedade'.
+
Quais são os passos a efetuar?
+
+
    +
  1. Escolha uma das páginas na lista acima.
    2. +
  2. Clique na hiperligação do artigo para carregar a página.
    3. +
  3. Assim que a página esteja carregada, clique em "EDITAR" perto do seu topo; isto leva-o para o editor da MDN.
    4. +
  4. Deverá ser adicionada pelo menos uma etiqueta de JavaScript. Aqui tem algumas das etiquetas possíveis para adicionar:
    5. +
  5. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    EtiquetaQue páginas para a utilizar
    Methodmethods
    Propertyproperties
    prototypeprototypes
    Object type namemethods of an object; for example String.fromCharCode should have the tag String
    ECMAScript6 and Experimentalfeatures added in a new ECMAScript version
    Deprecateddeprecated features (whose use is discouraged but still supported)
    Obsoleteobsolete features (which are no longer supported in modern browsers)
    othersSee MDN tagging standards for other possible tags to apply
    +
    6. +
  6. Guarde com um comentário.
    7. +
  7. E concluiu!
    8. +
+
+
+ +

 

diff --git a/files/pt-pt/orphaned/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html b/files/pt-pt/orphaned/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html new file mode 100644 index 0000000000..5751a2e391 --- /dev/null +++ b/files/pt-pt/orphaned/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html @@ -0,0 +1,114 @@ +--- +title: Como escrever um artigo para ajudar as pessoas a aprenderem sobre a Web +slug: >- + MDN/Contribute/Howto/Como_escrever_um_artigo_para_ajudar_as_pessoas_a_aprenderem_sobre_a_Web +tags: + - Aprender + - Como + - Guia(2) + - Metadados MDN +translation_of: MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web +--- +
{{MDNSidebar}}
+ +

A Área de Aprendizagem da MDN é o nosso local para os artigos que introduzem os conceitos da Web para os novos programadores. Porque o seu conteúdo, principalmente, tem como alvo os principiantes, é um local excelente para partilhar os seus conhecimentos e ajudar estes a conhecer a Web. É importante certificar-se que os novos programadores podem seguir este conteúdo, por isso nós damos especial atenção a este.

+ +

Este artigo explica sobre como escrever as páginas para a Área de Aprendizagem.

+ +

Como escrever um artigo da Área de Aprendizagem

+ +

To start contributing your knowledge, simply click the big green button, then follow the five steps below. If you're looking for ideas, please take a look at the our team Trello board!

+ +

Escrever um novo artigo de aprendizagem

+ +

This article might not end up in exactly the right place, but at least it's on MDN. If you need to talk to someone about getting it moved to the right place, please  Contact us.

+ +

Passo 1: Write a two-liner

+ +

Your article's first sentence needs to summarize what subject you're going to cover, and the second one should go into a few more specifics of the items that you'd put in the article. For example:

+ +
+

Whereas {{glossary("HTML")}} files contain structured content, {{Glossary("CSS")}}, another major Web technology, makes the content look the way you want. In this article we are going to cover how this technology works, and how to write your own basic example.

+
+ +

Note how the example briefly explains that CSS is a core Web technology used to style pages. That's enough for the reader to get a pretty good idea what the article covers.

+ +

Because Learning Area articles primarily target beginners, each article should cover one straightforward topic so as not to overwhelm the reader with too much new information. If you can't summarize the article in one sentence, you might be trying to do too much in one article!

+ +

Passo 2: Add a top box

+ +

Then add a top box to help readers get their bearings as to where they are in the learning process.  Here's an example of a top box from "Understanding URLs and their structure". You can use this article as an model when writing your own.

+ + + + + + + + + + + + +
Pré-requisitos:You need to first know how the Internet works, what a Web server is, and the concepts behind links on the web.
Objetivo:You will learn what a URL is and how it works on the Web.
+ +
+
Pré-requisitos
+
What must the reader already know to follow the article? When possible, make each prerequisite a link to another Learning Area article covering the concept (unless it's a really basic article that doesn't require prior knowledge).
+
Objetivos
+
This section briefly states what the reader will learn over the course of the article. This is a bit different than the one-liner; the one-liner summarizes the topic of the article, while the objectives section specifically lays out what the reader can expect to accomplish over the course of the article.
+
+ +
+

Nota: To create this table, you can either copy and paste the example table above, or use MDN's editor's table tool. If you choose to use the table tool, you need to specifically add the learn-box CSS class in addition to the default standard-table class. To do this, when you create or edit the table's properties,, go to the "Advanced" panel and set the Stylesheet Classes field to "standard-table learn-box".

+
+ +

Passo 3: Write a full description

+ +

Next, write a longer description that provides a more thorough overview of the article highlighting the most important concepts. Don't forget to explain why the reader should take the time to learn this topic and read your article!

+ +

Passo 4: Dig deeper

+ +

When you're done with all that, you can finally dive deeply into the topic. You can structure this part of your article however you like (although feel free to consult our style guide). This is your chance to shine! Go into detail explaining the topic you're writing about. Provide links to the full reference documentation, explain how the technology works in detail, provide syntax and usage details, and so forth. It's up to you!

+ +

As a guide, here are some writing tips for beginners:

+ + + +

Have a look at the first few sections of our Functions — reusable blocks of code article for some good descriptive sections.

+ +

Passo 5: Provide "active learning" material

+ +

To illustrate the article and help the reader better understand what they're learning, be sure to provide exercises, tutorials, and tasks to accomplish. By having them actively and practically using and experimenting with the concepts your article explains, you can help "lock" the information into their brains.

+ +

You can choose to include the examples directly in the page as live samples, or link to them if they don't really work as a live sample. If you're interested in helping create these valuable materials, please read the article Create an interactive exercise to help learning the Web.

+ +

If you can't provide links to existing active learning materials (you don't know of any or don't have time to create them), you should add the tag {{Tag("NeedsActiveLearning")}} to the article. That way other contributors can find articles that need active learning materials and perhaps help you come up with them.

+ +

Have a look at Active learning: selecting different elements for a live interactive learning exercise, or Active learning: Playing with scope for a different style of exercise that calls upon them to download a template locally and modify it following the provided steps.

+ +

Passo 6: Get the article reviewed, and put into the Learning Area navigation menu

+ +

After you've written your article, let us know so we can have a look at it, do a review, and suggest improvements. Again, see our Contact us section for the best ways to get in touch.

+ +

Another part finalizing your article is to put it in the Learning Area main navigation menu. This menu is generated by the LearnSidebar macro, which you need special privileges to edit, so again, talk ot one of our team about getting it added.

+ +

You should at least add it to your page — this is done by adding the macro call \{{LearnSidebar}} into a paragraph at the top of your page.

+ + + +

Artigos sugeridos

+ +

So you want to contribute but you're not sure what to write about?

+ +

The Learning Area team maintains a Trello board with ideas of articles to write. Feel free to pick one and get to work!

+ +

 

+ +

 

-- cgit v1.2.3-54-g00ecf