Como começar

  • Revision slug: Project:Como_começar
  • Revision title: Como começar
  • Revision id: 269043
  • Created:
  • Creator: AndreGazola
  • Is current revision? Não
  • コメント /* Starting a new page */

Revision Content

Ajudar o MDC é simples como usar o seu browser. Se você preenche campos de formulários na web ou usa uma caixas de texto para postar em weblogs, você tem todas as habilidades com o browser necessárias para começar.

Introdução

Sinta-se encorajado a escrever, editar, revisar, e traduzir qualquer documentação que encontrar neste wiki. Por favor faça isso com espírito cooperativo pensando na melhoria do conteúdo, entretanto, não se sinta desapontado se alguém mais tarde fizer algumas correções ou melhorias em seu conteúdo. Nós estamos aqui para tornar a documentação da Mozilla cada vez melhor (salva de spammers), cooperando, trabalhando juntos, ajudando e encorajando a todos.

O básico

Aqui está um pequeno guia sobre como editar e criar páginas no wiki do MDC. Você é bem vindo a praticar suas habilidades em wikis na Sandbox.

Editando páginas

Simplesmente clique no atalho Criar Conta e preencha os campos. É preciso ter uma conta e de identificar-se para poder editar páginas. Estes passos são necessários pois permitem lutar contra ações de vandalismo e torna mais fácil registrar (e agradecer-lhe pelas) contribuições.

Na coluna da direita de todas as páginas você vai ver um link "Editar". Clicando neste link você será levado a uma página onde poderá editar o conteúdo fazendo as alterações que achar necessárias, pré-visualizá-las, então salvá-las no Wiki. Uma vez salvas, você pode ver suas modificações imetiatamente na página

Iniciando uma nova página

O caminho mais fácil para criar uma nova página é criar um link para ela em sua página de usuário, então use este link para entrar no modo de edição da página.

Para chegar até sua página de usuário, clique em seu nome de usuário no topo da página do wiki. Se você ainda não adicionou nada em sua página, você será levado imentiatamente para o formulário de edição da página, onde poderá adicionar o conteúdo que quiser.

Creating a link to the page you want to add is as simple as writing the title for the page enclosed with double square brackets, like this: [[Here is an example]]. When saved, that will be turned into a link, like this: Here is an example.

If the page doesn't already exist, the link will be in red. If it does already exist, the link will be in blue. Should you want to create a new page but the page title you want is already taken, check first to see if you might be better to help edit and improve the page that's already there. Otherwise, think of a different title for your new page and create a link for it.

When you want to add content to your new page, simply click on the red link you just created and start writing. Remember to use the "Save page" button at the bottom of the editing form to save your work (often, if you're working on a long piece).

Page naming guide

For more information about creating and naming new pages, see our page naming guide.

Wiki markup

If you click "Edit" in the right-hand column now, you'll see that the text of this page contains some special characters, for example the "==" marks around headings and the "[{{mediawiki.external(' ]')}}" brackets around links. This is a very simple form of textual markup that is unique to wiki systems. The power of this markup system is that it's very easy to learn, and tends to be pretty forgiving if you make a mistake.

Wiki markup reference

We have a full wiki markup reference you can use to learn the markup language as you're editing the wiki.

Writing, editing, and reviewing

Here's a slightly longer introduction to the MDC for writers, editors, and reviewers.

Writers

The MDC is always interested in new content, so you're encouraged to write new articles on whatever topics we currently cover in the wiki. New content can be as simple as a one page "tip" or as complex as a full-blown book-length programming guide or reference. The amount of new content you contribute is entirely up to you.

If you're going to undertake a large project, I suggest you join the MDC community and discuss it there first, just in case someone else is planning to start (or has already started) a similar project.

Refer to our writer's guide if you have questions about style or usage policies within the wiki.

Editors

Copyediting is always welcome in this wiki, particularly to improve or correct writing style, grammar, or spelling. Please see our writer's guide for more information.

Reviewers

Technical improvements and review are always welcome here, so if you're reading through a page and spot a technical error (be it in code or text), please feel free to correct it. If it is a possibly controversial change, make a note in the "talk" page (accessed by clicking the "Discuss" link in the right hand column) and leave a note outlining your reasons for the change there.

Writer's guide

We have a writer's guide outlining preferred writing style practices for the MDC wiki. If you have questions about usage and style that aren't covered there, I recommend referring to the Economist style guide or, failing that, the Chicago Manual of Style.

We will be expanding the guide over time, so if you do have specific questions that aren't covered by the writer's guide, please send them to the MDC mailing list or project lead so we know what should be added.

Migrating old documentation

One of the longer ongoing sub-projects at the MDC is to migrate all of the currently-existing developer documentation from the mozilla.org website into the MDC wiki. The procedure is fairly simple:

  1. Pick a document you would like to migrate from the existing content list.
  2. Refer to the page naming guide and decide what the page or pages for that document should be called in the wiki.
  3. Create those pages and migrate the content, marking it up as best you can using the wiki markup reference as a guide.
  4. Delete the item from the existing content list.
  5. Add the item to the needs redirect list.

If you're keen on doing a comprehensive job on this, you'll also:

  1. Use our search system to search for any links to the original document in the wiki, then change those links so they point at the new wiki page.
  2. Check for external redirects to the original document, and flag those redirects for deletion by putting them in the "Junk" category by adding [[Category:Junk]].

Localizing the MDC

If you're interested in helping translate the documentation in any of the MDC wikis to another language, you can do so simply by visiting the relevant language's wiki and editing/creating pages.

Localização de projetos existentes

Atualmente o MDC possui wikis para as seguintes línguas: Català, 中文(简体), Deutsch, English, Français, Italiano, 日本語, Nederlands, Polski, Português, Español, 한국어.

How to start a new localization project

If you would like to start a new localization project for a language we don't currently have a wiki for, please read the localization projects page and follow the instructions there.

Resolving "edit wars" or other conflicts

If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please first try to resolve the conflict with the people involved.

Should no resolution be possible, please bring it to the attention of either (ideally) the MDC mailing list or (as a last resort) the MDC project lead. Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.

Requesting page deletions

Should you create a page by accident or stumble across a page you think should be deleted, add it to the "Junk" category, by adding [[Category:Junk]] to the bottom of the page.

The Junk category is checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.

Note: Please do not delete other content or categories from the pages you flag as "Junk".

Juntando-se à comunidade MDC

O Mozilla Developer Center é em sua maior parte formado pelo trabalho de um grupo de voluntários, e nós estamos sempre felizes para ajudar escritores e editores novos a se envolverem.

Listas de e-mail e newsgroup

A maior parte do planejamento e discussão do projeto MDC ocorre no Grupo Google, na lista de e-mail e newsgroup.

Se você tiver algum problema com a lista, ou tiver alguma pergunta, sinta-se livre para entrar em contato com um administrador.

IRC

Você é bem vindo para juntar-se ao canal #mdc-pt em irc.mozilla.org.

Administradores do MDC em português

Os administradores da versão em língua portuguesa do Mozilla Developer Center são os seguintes:

{{ wiki.languages( { "en": "Project:en/Getting_started", "pl": "Project:pl/Na_pocz\u0105tek" } ) }}

Revision Source

<p>
</p><p>Ajudar o MDC é simples como usar o seu browser. Se você preenche campos de formulários na web ou usa uma caixas de texto para postar em weblogs, você tem todas as habilidades com o browser necessárias para começar.
</p>
<h3 name="Introdu.C3.A7.C3.A3o"> Introdução </h3>
<p><b>Sinta-se encorajado a escrever, editar, revisar, e traduzir qualquer documentação que encontrar neste wiki.</b> Por favor faça isso com espírito cooperativo pensando na melhoria do conteúdo, entretanto, não se sinta desapontado se alguém mais tarde fizer algumas correções ou melhorias em seu conteúdo. Nós estamos aqui para tornar a documentação da Mozilla cada vez melhor (salva de spammers), cooperando, trabalhando juntos, ajudando e encorajando a todos.
</p>
<h3 name="O_b.C3.A1sico"> O básico </h3>
<p>Aqui está um pequeno guia sobre como editar e criar páginas no wiki do MDC.  Você é bem vindo a praticar suas habilidades em wikis na <a href="pt/Sandbox">Sandbox</a>.
</p>
<h4 name="Editando_p.C3.A1ginas"> Editando páginas </h4>
<p>Simplesmente clique no atalho <a href="Special:Userlogin">Criar Conta</a> e preencha os campos. É preciso ter uma conta e de identificar-se para poder editar páginas. Estes passos são necessários pois permitem lutar contra ações de vandalismo e torna mais fácil registrar (e agradecer-lhe pelas) contribuições.
</p><p>Na coluna da direita de todas as páginas você vai ver um link "Editar".  Clicando neste link você será levado a uma página onde poderá editar o conteúdo fazendo as alterações que achar necessárias, pré-visualizá-las, então salvá-las no Wiki. Uma vez salvas, você pode ver suas modificações imetiatamente na página
</p>
<h4 name="Iniciando_uma_nova_p.C3.A1gina"> Iniciando uma nova página </h4>
<p>O caminho mais fácil para criar uma nova página é criar um link para ela em sua página de usuário, então use este link para entrar no modo de edição da página.  
</p><p>Para chegar até sua página de usuário, clique em seu nome de usuário no topo da página do wiki.  Se você ainda não adicionou nada em sua página, você será levado imentiatamente para o formulário de edição da página, onde poderá adicionar o conteúdo que quiser. 
</p><p>Creating a link to the page you want to add is as simple as writing the title for the page enclosed with double square brackets, like this: <code><span class="plain">[[Here is an example]]</span></code>.  When saved, that will be turned into a link, like this: <a href="pt/Here_is_an_example">Here is an example</a>.
</p><p>If the page doesn't already exist, the link will be in red.  If it <i>does</i> already exist, the link will be in blue.  Should you want to create a new page but the page title you want is already taken, check first to see if you might be better to help edit and improve the page that's already there.  Otherwise, think of a different title for your new page and create a link for it.
</p><p>When you want to add content to your new page, simply click on the red link you just created and start writing.  Remember to use the "Save page" button at the bottom of the editing form to save your work (often, if you're working on a long piece).
</p>
<h5 name="Page_naming_guide"> Page naming guide </h5>
<p>For more information about creating and naming new pages, see our <a href="Project:pt/Page_Naming_Guide">page naming guide</a>.
</p>
<h4 name="Wiki_markup"> Wiki markup </h4>
<p>If you click "Edit" in the right-hand column now, you'll see that the text of this page contains some special characters, for example the "==" marks around headings and the "[{{mediawiki.external(' ]')}}" brackets around links.  This is a very simple form of textual markup that is unique to wiki systems.  The power of this markup system is that it's very easy to learn, and tends to be pretty forgiving if you make a mistake.
</p>
<h5 name="Wiki_markup_reference"> Wiki markup reference </h5>
<p>We have a full <a href="Project:pt/Wiki_Markup_Reference">wiki markup reference</a> you can use to learn the markup language as you're editing the wiki.
</p>
<h3 name="Writing.2C_editing.2C_and_reviewing"> Writing, editing, and reviewing </h3>
<p>Here's a slightly longer introduction to the MDC for writers, editors, and reviewers.
</p>
<h4 name="Writers"> Writers </h4>
<p>The MDC is always interested in new content, so you're encouraged to write new articles on whatever <a href="Special:Tags?tag=All_Categories&amp;language=pt">topics</a> we currently cover in the wiki.  New content can be as simple as a one page "tip" or as complex as a full-blown book-length programming guide or reference.  The amount of new content you contribute is entirely up to you.
</p><p>If you're going to undertake a large project, I suggest you join the <a href="Project:pt/Getting_Started#Joining_the_MDC_community">MDC community</a> and discuss it there first, just in case someone else is planning to start (or has already started) a similar project.
</p><p>Refer to our <a href="Project:pt/Writer's_guide">writer's guide</a> if you have questions about style or usage policies within the wiki.
</p>
<h4 name="Editors"> Editors </h4>
<p>Copyediting is always welcome in this wiki, particularly to improve or correct writing style, grammar, or spelling.  Please see our <a href="Project:pt/Writer's_guide">writer's guide</a> for more information.
</p>
<h4 name="Reviewers"> Reviewers </h4>
<p>Technical improvements and review are always welcome here, so if you're reading through a page and spot a technical error (be it in code or text), please feel free to correct it.  If it is a possibly controversial change, make a note in the "talk" page (accessed by clicking the "Discuss" link in the right hand column) and leave a note outlining your reasons for the change there.
</p>
<h4 name="Writer.27s_guide"> Writer's guide </h4>
<p>We have a <a href="Project:pt/Writer's_guide">writer's guide</a> outlining preferred writing style practices for the MDC wiki.  If you have questions about usage and style that aren't covered there, I recommend referring to the <a class="external" href="http://www.economist.com/research/StyleGuide/">Economist style guide</a> or, failing that, the <a class="external" href="http://www.amazon.com/gp/product/0226104036/">Chicago Manual of Style</a>.
</p><p>We will be expanding the guide over time, so if you do have specific questions that aren't covered by the <a href="Project:pt/Writer's_guide">writer's guide</a>, please send them to the <a href="Project:pt/Community">MDC mailing list</a> or <a href="User:Dria">project lead</a> so we know what should be added.
</p>
<h3 name="Migrating_old_documentation"> Migrating old documentation </h3>
<p>One of the longer ongoing sub-projects at the MDC is to migrate all of the currently-existing developer documentation from the <a class="external" href="http://www.mozilla.org">mozilla.org</a> website into the MDC wiki.  The procedure is fairly simple:
</p>
<ol><li> Pick a document you would like to migrate from the <a href="Project:pt/Existing_Content">existing content</a> list.
</li><li> Refer to the <a href="Project:pt/Page_Naming_Guide">page naming guide</a> and decide what the page or pages for that document should be called in the wiki.
</li><li> Create those pages and migrate the content, marking it up as best you can using the <a href="Project:pt/Wiki_Markup_Reference">wiki markup reference</a> as a guide.
</li><li> Delete the item from the <a href="Project:pt/Existing_Content">existing content</a> list.
</li><li> Add the item to the <a href="Project:pt/Needs_Redirect">needs redirect</a> list.
</li></ol>
<p>If you're keen on doing a comprehensive job on this, you'll also:
</p>
<ol><li> Use <a class="external" href="http://search.developer.mozilla.org">our search system</a> to search for any links to the original document in the wiki, then change those links so they point at the new wiki page.
</li><li> Check for <a href="Project:pt/External_Redirects">external redirects</a> to the original document, and flag those redirects for deletion by putting them in the "Junk" category by adding <code><span class="plain">[[Category:Junk]]</span></code>.
</li></ol>
<h3 name="Localizing_the_MDC"> Localizing the MDC </h3>
<p>If you're interested in helping translate the documentation in any of the MDC wikis to another language, you can do so simply by visiting the relevant language's wiki and editing/creating pages.
</p>
<h4 name="Localiza.C3.A7.C3.A3o_de_projetos_existentes"> Localização de projetos existentes </h4>
<p>Atualmente o MDC possui wikis para as seguintes línguas: <a class="external" href="http://developer.mozilla.org/ca/docs/">Català</a>,
<a class="external" href="http://developer.mozilla.org/cn/docs/">中文(简体)</a>,
<a class="external" href="http://developer.mozilla.org/de/docs/">Deutsch</a>,
<a class="external" href="http://developer.mozilla.org/en/docs/">English</a>,
<a class="external" href="http://developer.mozilla.org/fr/docs/">Français</a>,
<a class="external" href="http://developer.mozilla.org/it/docs/">Italiano</a>,
<a class="external" href="http://developer.mozilla.org/ja/docs/">日本語</a>,
<a class="external" href="http://developer.mozilla.org/nl/docs/">Nederlands</a>,
<a class="external" href="http://developer.mozilla.org/pl/docs/">Polski</a>,
<a class="external" href="http://developer.mozilla.org/pt/docs/">Português</a>,
<a class="external" href="http://developer.mozilla.org/es/docs/">Español</a>,
<a class="external" href="http://developer.mozilla.org/ko/docs/">한국어</a>.
</p>
<h4 name="How_to_start_a_new_localization_project"> How to start a new localization project </h4>
<p>If you would like to start a new localization project for a language we don't currently have a wiki for, please read the <a href="Project:pt/Localization_Projects">localization projects</a> page and follow the instructions there.
</p>
<h3 name="Resolving_.22edit_wars.22_or_other_conflicts"> Resolving "edit wars" or other conflicts </h3>
<p>If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please first try to resolve the conflict with the people involved.  
</p><p>Should no resolution be possible, please bring it to the attention of either (ideally) the <a href="Project:pt/Community">MDC mailing list</a> or (as a last resort) the <a href="User:Dria">MDC project lead</a>.  Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.
</p>
<h3 name="Requesting_page_deletions"> Requesting page deletions </h3>
<p>Should you create a page by accident or stumble across a page you think should be deleted, add it to the "Junk" category, by adding <code><span class="plain">[[Category:Junk]]</span></code> to the bottom of the page.
</p><p>The <a href="Special:Tags?tag=Junk&amp;language=pt">Junk category</a> is checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.
</p><p><b>Note</b>: Please do not delete other content or categories from the pages you flag as "Junk".
</p>
<h3 name="Juntando-se_.C3.A0_comunidade_MDC"> Juntando-se à comunidade MDC </h3>
<p>O Mozilla Developer Center é em sua maior parte  formado pelo trabalho de um grupo de voluntários, e nós estamos sempre felizes para ajudar escritores e editores novos a se envolverem. 
</p>
<h4 name="Listas_de_e-mail_e_newsgroup"> Listas de e-mail e newsgroup </h4>
<p>A maior parte do planejamento e discussão do projeto MDC ocorre no Grupo Google, na lista de e-mail e newsgroup.
</p>
<ul><li>Veja os fóruns do MDC...
<ul><li><a class="external" href="http://groups.google.com/group/mozilladevmdc-pt">como um grupo Google</a>
</li><li><a class="external" href="http://groups.google.com/group/mozilladevmdc-pt/feeds">como um Web Feed</a>
</li><li><a class="external" href="https://lists.mozilla.org/listinfo/dev-mdc">como uma lista de e-mail</a> - Em Inglês.
</li><li><a class="external" href="news://news.mozilla.org/mozilla.dev.mdc">como um newsgroup</a> - Em Inglês.
</li></ul>
</li></ul>
<ul><li><a class="external" href="http://mail.mozilla.org/pipermail/devmo-general/">Arquivos da antiga lista devmo-general</a>
</li></ul>
<p>Se você tiver algum problema com a lista, ou tiver alguma pergunta, sinta-se livre para entrar em contato com um administrador.
</p>
<h4 name="IRC"> IRC </h4>
<p>Você é bem vindo para juntar-se ao <a class="external" href="irc://irc.mozilla.org/mdc-pt">canal #mdc-pt</a> em irc.mozilla.org.
</p>
<h4 name="Administradores_do_MDC_em_portugu.C3.AAs"> Administradores do MDC em português </h4>
<p>Os administradores da versão em língua portuguesa do <a href="pt">Mozilla Developer Center</a> são os seguintes:
</p>
<ul><li> <a href="User:Leandro_Merc%c3%aas_Xavier">Leandro Mercês Xavier</a>
</li><li> <a href="User:RuiMaciel">Rui Maciel</a>
</li></ul>
{{ wiki.languages( { "en": "Project:en/Getting_started", "pl": "Project:pl/Na_pocz\u0105tek" } ) }}
Revert to this revision