Tweaked the structure of the contributing pages.

This commit is contained in:
Russell Keith-Magee 2017-02-23 16:13:10 -05:00
parent 5e37b73d58
commit 8fed4e0550
No known key found for this signature in database
GPG key ID: 3D2DAB6A37BB5BC3
49 changed files with 336 additions and 317 deletions

View file

@ -25,7 +25,7 @@ As primeiras 100 BeeWare Challenge Coins foram confeccionadas graças ao apoio f
.. _MaxCDN: /community/members/maxcdn/ .. _MaxCDN: /community/members/maxcdn/
.. _Revolution Systems: /community/members/revsys/ .. _Revolution Systems: /community/members/revsys/
--- ---
sort_key: 5 sort_key: 2
--- ---
summary: O que é uma challenge coin, e porque você quer ter uma? summary: O que é uma challenge coin, e porque você quer ter uma?
--- ---

View file

@ -1,6 +1,6 @@
_model: page _model: page
--- ---
sort_key: 5 sort_key: 2
--- ---
title: Challenge Coins title: Challenge Coins
--- ---

View file

@ -1,6 +1,6 @@
_model: page _model: page
--- ---
sort_key: 5 sort_key: 2
--- ---
title: Challenge Coins title: Challenge Coins
--- ---

View file

@ -1,7 +1,7 @@
body: body:
Aquelas abelhas ocupadas do `Time Principal </community/team>`_ tem Aquelas abelhas ocupadas do `Time Principal </community/team>`_ tem
algumas responsabilidades para manter a colmeia que é o BeeWare se algumas responsabilidades para manter a colmeia que é o BeeWare se
movendo. Esse é um projeto em evolução, portanto esta página deve mudar. movendo. Esse é um projeto em evolução, portanto esta página deve mudar.
Isso inclui, mas não se limita apenas a responder aos problemas, revisar e Isso inclui, mas não se limita apenas a responder aos problemas, revisar e
@ -10,47 +10,47 @@ como um todo.
Existem pessoas que nós confiamos para fazer decisões de código, pessoas que Existem pessoas que nós confiamos para fazer decisões de código, pessoas que
confiamos para decidir a organização do código e tem uma pessoa com quem a confiamos para decidir a organização do código e tem uma pessoa com quem a
responsabilidade metaforicamente fica, que guia a visão de toda a organização responsabilidade metaforicamente fica, que guia a visão de toda a organização
e muitas vezes é seu maior torcedor. e muitas vezes é seu maior torcedor.
Esses níveis podem ser descritos como: Esses níveis podem ser descritos como:
Abelha ou Abelha Operária: Abelha ou Abelha Operária:
- Qualquer membro da comunidade BeeWare. Dado que nós trabalhamos abertamente - Qualquer membro da comunidade BeeWare. Dado que nós trabalhamos abertamente
no GitHub, qualquer pessoas pode sugerir mudanças no código e ter seu código aceito. no GitHub, qualquer pessoas pode sugerir mudanças no código e ter seu código aceito.
O único limite para sua capacidade de contribuir é ter seu trabalho incluído por um O único limite para sua capacidade de contribuir é ter seu trabalho incluído por um
membro do time que tenha as permissões de faze-lo. membro do time que tenha as permissões de faze-lo.
Apicultor: Apicultor:
- Uma abelha que foi reconhecida como um contribuidor confiável. Essas abelhas - Uma abelha que foi reconhecida como um contribuidor confiável. Essas abelhas
tem demonstrado habilidade em relação a alguma parte especifica do projeto tem demonstrado habilidade em relação a alguma parte especifica do projeto
BeeWare por um período de tempo. Pode ser em um nível técnico (competência em BeeWare por um período de tempo. Pode ser em um nível técnico (competência em
JavaScript, Python, Objective-C; GTK+, conhecimento em macOS) ou em outro nível JavaScript, Python, Objective-C; GTK+, conhecimento em macOS) ou em outro nível
(administração da comunidade, revisão de código). Apicultores podem ter também (administração da comunidade, revisão de código). Apicultores podem ter também
o direito fazer commit bits para o projeto onde sua especialidade é reconhecida. o direito fazer commit bits para o projeto onde sua especialidade é reconhecida.
Apicultor Sênior: Apicultor Sênior:
- Apicultores com elevado acesso no GitHub, e também com um nível de responsabilidade - Apicultores com elevado acesso no GitHub, e também com um nível de responsabilidade
para supervisionar o projeto como um todo. Eles podem fazer decisões sobre a para supervisionar o projeto como um todo. Eles podem fazer decisões sobre a
arquitetura, mas precisão responder ao BDFN. arquitetura, mas precisão responder ao BDFN.
Apicultor Fundador: `Russell Keith-Magee <https://twitter.com/freakboy3742>`_ Apicultor Fundador: `Russell Keith-Magee <https://twitter.com/freakboy3742>`_
- O primeiro homem que subiu na colina e viu um iaque(yak) que precisava ser tosquiado - O primeiro homem que subiu na colina e viu um iaque(yak) que precisava ser tosquiado
- Esse papel nunca muda e continua ad infinitum - Esse papel nunca muda e continua ad infinitum
- Esse papel é diferente do BDFN. - Esse papel é diferente do BDFN.
Bee-nevolent Dictator for Now (BDFN): `Russell Keith-Magee <https://twitter.com/freakboy3742>`_ Bee-nevolent Dictator for Now (BDFN): `Russell Keith-Magee <https://twitter.com/freakboy3742>`_
- Assim como o `Benevolent Dictator for Life <https://en.wikipedia.org/wiki/Benevolent_dictator_for_life>`_, a responsabilidade fica com o BDFN. - Assim como o `Benevolent Dictator for Life <https://en.wikipedia.org/wiki/Benevolent_dictator_for_life>`_, a responsabilidade fica com o BDFN.
O uso de "for Now" é o oposto de "for Life" como referência ao lema do Django de não atribuir O uso de "for Now" é o oposto de "for Life" como referência ao lema do Django de não atribuir
a responsabilidade de principal mantenedor para toda a vida de uma pessoa. Existe vida para a responsabilidade de principal mantenedor para toda a vida de uma pessoa. Existe vida para
além do open source e o equilíbrio entre programar/viver e bem-estar é algo importante para além do open source e o equilíbrio entre programar/viver e bem-estar é algo importante para
se ter em mente. se ter em mente.
Orientações (não necessariamente regras) Orientações (não necessariamente regras)
----------------------------------------------------- -----------------------------------------------------
Como qualquer projeto com mais de uma pessoa com direito de fazer commit, Como qualquer projeto com mais de uma pessoa com direito de fazer commit,
existem algumas orientações que o time deve seguir: existem algumas orientações que o time deve seguir:
@ -60,10 +60,10 @@ existem algumas orientações que o time deve seguir:
* **Presumir que todos tem boas intenções, mesmo se eles não tiverem escolhido bem suas palavras.** * **Presumir que todos tem boas intenções, mesmo se eles não tiverem escolhido bem suas palavras.**
* **Presumir que se alguém fizer algo da forma "errada", é porque nós falhamos no processo de * **Presumir que se alguém fizer algo da forma "errada", é porque nós falhamos no processo de
comunicação.** comunicação.**
* **Presumir que qualquer manifestação de raiva ou frustração vem de um genuíno desejo de usar * **Presumir que qualquer manifestação de raiva ou frustração vem de um genuíno desejo de usar
uma ferramenta/biblioteca da BeeWare.** uma ferramenta/biblioteca da BeeWare.**
* **Encorajar outros membros da comunidade a refletir esses ideais em suas próprias comunicações, * **Encorajar outros membros da comunidade a refletir esses ideais em suas próprias comunicações,
@ -92,21 +92,21 @@ Tornando-se um Apicultor
--------------------------------- ---------------------------------
A inclusão de um novo apicultor no time é de inteira responsabilidade do A inclusão de um novo apicultor no time é de inteira responsabilidade do
Time Principal existente. Embora ainda não exista regras claras sobre isso, no Time Principal existente. Embora ainda não exista regras claras sobre isso, no
geral, alguém será convidado a ser um Apicultor no projeto BeeWare se ele geral, alguém será convidado a ser um Apicultor no projeto BeeWare se ele
tiver demonstrado solidas contribuições ao projeto. Isso pode ser estendido tiver demonstrado solidas contribuições ao projeto. Isso pode ser estendido
para alguém com um conhecimento específico em um domínio (por exemplo, para alguém com um conhecimento específico em um domínio (por exemplo,
iOS/macOS) que pode estar faltando no time atual. Isso não precisa ser baseado iOS/macOS) que pode estar faltando no time atual. Isso não precisa ser baseado
em commits. Qualquer um que demonstrar interesse no projeto no geral pode em commits. Qualquer um que demonstrar interesse no projeto no geral pode
pedir a permissão de poder fazer commits no projeto. pedir a permissão de poder fazer commits no projeto.
Todos os novos apicultores serão 'introduzidos' (por falta de uma palavra melhor) Todos os novos apicultores serão 'introduzidos' (por falta de uma palavra melhor)
nos valores e orientações centrais do projeto. Um resumo dos valores centrais pode nos valores e orientações centrais do projeto. Um resumo dos valores centrais pode
ser encontrado `na página Sobre o projeto <http://pybee.org/project/about/>`_. Espera-se ser encontrado `na página Sobre o projeto <http://pybee.org/project/about/>`_. Espera-se
que qualquer um que entre no time detenha esses valores e contribua para o debate e que qualquer um que entre no time detenha esses valores e contribua para o debate e
evolução desses dos mesmos no decorrer do tempo. evolução desses dos mesmos no decorrer do tempo.
Qualquer Apicultor, novo ou velho, não tem a obrigação de manter nenhuma parte Qualquer Apicultor, novo ou velho, não tem a obrigação de manter nenhuma parte
sozinho. Existem muitos apicultores e muitos outros além desses que podem oferecer sozinho. Existem muitos apicultores e muitos outros além desses que podem oferecer
ajuda, conselhos e mentorias. ajuda, conselhos e mentorias.
@ -116,16 +116,16 @@ gutter:
"Commit bit"? "Commit bit"?
-------------------------------- --------------------------------
Nos sistemas Unix, um único bit em um arquivo é usado para demonstrar Nos sistemas Unix, um único bit em um arquivo é usado para demonstrar
permissão de executar um arquivo. Em sistemas de controle de versão, um permissão de executar um arquivo. Em sistemas de controle de versão, um
bit similar existe para demonstrar a capacidade de incorporar um código. bit similar existe para demonstrar a capacidade de incorporar um código.
Dizer que alguém tem um "commit bit" significa que ele tem o direito de Dizer que alguém tem um "commit bit" significa que ele tem o direito de
escrever em uma base de código. Em termos de GitHub, isso significa que escrever em uma base de código. Em termos de GitHub, isso significa que
eles tem o direito de incorporar Pull Requests e commits de código eles tem o direito de incorporar Pull Requests e commits de código
diretamente no projeto. diretamente no projeto.
--- ---
sort_key: 4 sort_key: 3
--- ---
summary: O que é o time principal e o que ele faz? summary: O que é o time principal e o que ele faz?
--- ---

View file

@ -2,7 +2,7 @@ _model: page
--- ---
title: 核心團隊和責任 title: 核心團隊和責任
--- ---
sort_key: 4 sort_key: 3
--- ---
summary: 核心團隊是什麼?他們有哪些責任? summary: 核心團隊是什麼?他們有哪些責任?
--- ---

View file

@ -2,7 +2,7 @@ _model: page
--- ---
title: Core Team, and Responsibilities title: Core Team, and Responsibilities
--- ---
sort_key: 4 sort_key: 3
--- ---
summary: What is the core team, and what do they do? summary: What is the core team, and what do they do?
--- ---

View file

@ -1,7 +1,7 @@
_model: page _model: redirect
--- ---
sort_key: 5 old_path: /contributing/first-time/
--- ---
title: First-time contributors new_path: /contributing/how/first-time/
--- ---
summary: Never contributed to open source before? Let us help you! _discoverable: no

View file

@ -1,10 +1,12 @@
_model: page _model: page
--- ---
_template: leaf-page.html
---
sort_key: 1 sort_key: 1
--- ---
title: مالذي تستطيع عمله للمساعدة ؟ title: مالذي تستطيع عمله للمساعدة ؟
--- ---
summary: ما نوع المساعدات المطلوبة summary: تريد المشاركة؟ الكل مرحب به للمساعدة
--- ---
body: body:

View file

@ -1,34 +1,76 @@
_model: page
---
_template: leaf-page.html
---
sort_key: 1
---
title: O que eu posso fazer para ajudar?
---
summary: Quer contribuir com o BeeWare? Todos são bem-vindos para ajudar!
---
body: body:
Aqui é onde o guia de contribuição para o BeeWare eventualmente virá. Nós não temos uma política de procedimentos concretas ainda - mas sabemos Existem muitas formas de ajudar o BeeWare.
que elas são realmente importantes e temos intenção de escreve-las em breve.
No meio tempo: Sigam a `PEP8 <https://www.python.org/dev/peps/pep-0008/>`__ (prestando bastante atenção a `Seção 2 <https://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds>`__), e os procedimentos padrões de como fazer um Primeiras Contribuições
forking do GitHub. Nós vamos trabalhar no resto enquanto isso. ----------------------------
Se você é novo em contribuir para projetos open source veja o `guia das Primeiras contribuições <../first-time/>`__.
Contribuições com Código
------------------------------
Assine seu trabalho Se você está procurando algo para trabalhar e não sabe onde seus
esforços podem ser bem-vindos, tente procurar no rastreador de tickets
por um projeto do seu interesse. Normalmente haverão alguns tickets
com problemas conhecidos; qualquer ticket é um candidato a ser
consertado. Alguns tickets em particular tem a tag ``up-for-grabs`` -
isto indica que são areas de particular interesse onde o projeto
gostaria de contribuições.
Se esta é sua primeira contribuição, alguns tickets possuem a tag
``first-timers-only``. Esses são problemas especiais que foram selecionados
porque eles são relativamente simples para apresenta-lo ao projeto, e o
time do PyBee vai ajudar qualquer primeiro contribuidor a enviar um
patch para algum desses problemas.
Uso da Plataforma
---------------------
Você usa Windows ou algum "flavor" de Linux? Você consegue instalar um projeto ou uma aplicação no seu sistema? Você encontrou algum problema?
Se sim, por favor atualize a documentação para mostrar como você fez para faze-lo funcionar, ou relate uma issue se você encontrou um bug que não pode consertar.
Documentação
-------------------
A documentação está atualizada? Você acha que alguma coisa pode ser explicada de outra forma? Existem seções perdidas? Você tem alguma ideia para um tutorial que pode ser escrita? Por favor envie um Pull Request!
Esse Website
--------------------
Existe algo errado ou perdido nesse website? Por favor sinta-se a vontade para `fazer uma edição <https://github.com/pybee/pybee.github.io>`__ e submeta uma pull request!
Alguma outra coisa
------------------------- -------------------------
Antes de nós podermos aceitar sua contribuição no BeeWare, você precisa nos dar permissão para faze-lo. Já que você é um autor de um trabalho Se você tiver alguma ideia para algo, ou se você não ver nenhum
criativo (um pedaço de código, ou alguma documentação), você automaticamente detêm os direitos desse trabalho. BeeWare não pode usar sua contribuição legalmente a menos que você nos dê permissão para faze-lo. ticket, ou você gostaria de ser ajudado com um ticket, ou se você
não tem certeza de como proceder, contate os mantenedores do projeto no
`Twitter <http://twitter.com/pybeeware/>`__ ou `Gitter <http://gitter.im/pybee/general>`__.
Os mantenedores do projeto amam colaborar, especialmente com
novos contribuidores e vão ficar felizes em responder qualquer
pergunta ou ajuda-lo com qualquer a passar por qualquer problema
que você possa encontrar.
O projeto BeeWare usa um mecanismo conhecido como um `Certificado de Origem do Desenvolvedor(DCO) <./dco/>`__ para admnistrar esse processo. O DCO é uma declaração legal obrigatória que atesta que você é o criador de uma contribuição e que você permite que o BeeWare use o seu trabalho.
Para indicar que você concorda com os termos do DCO, você precisa adicionar uma linha em todas suas mensagens de commit:: ---
gutter:
Signed-off-by: Joe Smith <joe.smith@email.com> Todas as Contribuições são Bem-Vindas
------------------------------------------------
Se você configurou seu ``user.name`` e ``user.email`` na sua configuração do git, você pode assinar seu commit automaticamente com ``git commit -s``.
Se você tem mais perguntas sobre o DCO, porque ele é necessário, o que significa e como configurar seu sistema para usa-lo, veja `Guia do Iniciante do DCO <./dco/>`__, ou `entre em contato com o time de desenvolvimento </community/team>`__.
Não apenas com código. Um software bem sucedido precisa ter documentação, design bem trabalhado, feedback e bugs reportados. A comunidade
BeeWare reconhece que todas as contribuições são importantes - não somente aquelas que vem como uma pull request no GitHub
--- ---
incomplete: yes incomplete: yes
---
sort_key: 2
---
summary: O processo de desenvolvimento do BeeWare
---
title: Como contribuir

View file

@ -1,33 +1,70 @@
_model: page _model: page
--- ---
title: 如何貢獻 _template: leaf-page.html
--- ---
sort_key: 2 sort_key: 1
--- ---
summary: BeeWare開發流程 title: 如何幫助
---
summary: 你也想參與嗎?來吧--誰都可以幫忙!
--- ---
body: body:
這裡是貢獻指南將去的地方。我們還是沒有具體的規範和程序——可是我們承認都很重要,而且打算一有機會就要寫好。 幫忙的方式豐富哦!
在此期間: 參考 `PEP8 <https://www.python.org/dev/peps/pep-0008/>`__ (而且仔細關注 `Section 2 <https://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds>`__), and Github vanilla forking procedures. 其他的一出現我們就處理。 第一次貢獻者
------------------------
如果你從來沒向開源貢獻過,請參閱 `第一次貢獻者的指南 <http://pybee.org/contributing/first-time/>`__.
貢獻源碼
---------------------
簽上您的工作 如果你是在尋找具體任務,但是不知道應該從哪裡開始,那去看看缺陷跟蹤管理系
統。你在那邊能找到對你有趣的項目。裡面經常會有些已知問題的票;所有的票是
可以處理的,特別是有 ``up-for-grabs`` 的標籤——這標籤是表示項目里特指的需求。
如果你是第一次的貢獻者,你可以看看有著 ``first-timers-only`` 標籤的票.因為
這些議題適合和項目剛開始接觸的貢獻者,所以這些特別的議題已經被專門給第一
次貢獻者。PyBee團隊會輔導任何第一次貢獻者提交關於上述議題的補丁。
平台使用
--------------- ---------------
我們把你的貢獻合並起來之前你必須給我們許可這樣做。因為你是作品的製造者源碼或者文檔的作者時你有知識產權的。BeeWare必須得到你的許可才能合法地使用你的貢獻。 你會使用微軟還是不同類型的Linux你能把項目安裝好嗎你碰到了問題沒有
BeeWare項目是以 `Developer Certificate of Origin (DCO) <./dco/>`__ 來管理這個過程. DCO是一種有法律约束力的宣告是保證你是貢獻的製造者而且你想讓BeeWare使用貢獻。 有的話,請編輯文檔給其他人看怎麼做。如果找到了你自己沒辦法解決的問題,請
報告問題。
為了表示你同意DCO的條款把下面的一行加入你的git commit message:: 文檔
-------------------
Signed-off-by: Joe Smith <joe.smith@email.com> 文檔最新語氣合適步驟清楚想加入一個輔導材料請提交一個Pull Request!
如果在git配置你指定 ``user.name`` 和 ``user.email``, 你能以 ``git commit -s`` 來自動地簽commit message. 本網頁
--------------------
如果你還有關於Developer Certificates of Origin的問題為什麼需要它它是什麼意思以及怎麼配置系統使用它看看 `The Beginners Guide to DCOs <./dco/>`__, 或者 `聯繫核心團隊 </community/team>`__. 本網頁是有錯誤還是缺少些內容?請自在地 `編輯 <https://github.com/pybee/pybee.github.io>`__ 然後提交pull request!
其他的
-------------------------
如果你有自己的想法,找不到有關的票,想收到輔導,或者不知道在哪入手,請在
`Twitter <http://twitter.com/pybeeware/>`__ 或
`Gitter <http://gitter.im/pybee/general>`__ 聯繫維護項目著。
維護項目著熱愛協作,特別適合新貢獻者協作,而且會高高興興的回答任何問題以
及幫你解決任何問題。
---
gutter:
歡迎所有的貢獻
----------------------------------
項目里不只是包括代碼——要成功的軟體項目有著文檔設計技能意見以及臭蟲報告。BeeWare社區覺得不只是GitHub上的pull request很重要——所有的貢獻非常重要。
--- ---
incomplete: yes incomplete: yes

View file

@ -1,33 +1,76 @@
_model: page _model: page
--- ---
title: How to contribute _template: leaf-page.html
--- ---
sort_key: 2 sort_key: 1
--- ---
summary: The BeeWare development process title: What can you do to help?
---
summary: Want to contribute to BeeWare? Anyone is welcome to help out!
--- ---
body: body:
This is where the BeeWare contribution guide will eventually go. We don't have a concrete set of policies and procedures yet - but we know they're really important, and we're intending to write them as soon as we get a chance. There are many ways to help with BeeWare.
In the meantime: Follow `PEP8 <https://www.python.org/dev/peps/pep-0008/>`__ (with careful attention paid to `Section 2 <https://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds>`__), and Github vanilla forking procedures. We'll work the rest out as we go. `First-time Contributors`_
---------------------------
Never contributed to open source before? Let us help you! Everyone can contribute to open source, and we're here to show you how.
.. _First-time Contributors: first-time/
Sign your work Code Contributions
-------------------
If you're looking for something to work on, and don't know where your
effort would be welcome, try looking at the ticket tracker for a project
of interest. There will usually be a couple of tickets with known
problems; any ticket is a candidate for being fixed. Some tickets in
particular will be tagged ``up-for-grabs`` - this indicates that they
are areas of particular interest where the project would like
contributions.
If you're a first time contributor, some tickets are also tagged as
``first-timers-only``. These are special issues that have been selected
because they're relatively simple introductions to the project, and the
PyBee team will mentor any first time contributor in committing a patch
for one of these issues.
Platform Usage
--------------- ---------------
Before we can merge your contribution into BeeWare, you need to give us permission to do so. Since you're an author of a creative work (a piece of code, or some documentation), you automatically own the copyright for that work. BeeWare can't legally use that contribution unless you give us permission to do so. Do you use Windows or various flavours of Linux? Are you able to install a project or application on your system? Did you run into any problems?
The BeeWare project uses a mechansim known as a `Developer Certificate of Origin (DCO) <./dco/>`__ to manage this process. The DCO is a legally binding statement that asserts that you are the creator of your contribution, and that you wish to allow BeeWare to use your work. If so, please update the documentation to show how you were able to get it to work, or log an issue if you've found a bug that you can't fix.
To indicate that you agree to the terms of the DCO, you just add a line to every git commit message:: Documentation
--------------
Is the documentation up to date? Do you think things could be worded differently? Are there missing sections? Do you have an idea for a tutorial that could be written? Please submit a Pull Request!
This Website
-------------
Is there anything wrong or missing from this website? Please feel free to `make edits <https://github.com/pybee/pybee.github.io>`__ and submit a pull request!
Something else
-------------------------
If you've got your own idea for something, or if you don't see any
tickets, or you want to be mentored on a ticket, or you aren't sure how
to proceed, contact the project maintainers on
`Twitter <http://twitter.com/pybeeware/>`__ or
`Gitter <http://gitter.im/pybee/general>`__. The project maintainers love
collaborating, especially with new contributors, and will gladly answer
any questions or walk you through any problems you may encounter.
Signed-off-by: Joe Smith <joe.smith@email.com>
If you set your ``user.name`` and ``user.email`` as part of your git configuration, you can sign your commit automatically with ``git commit -s``.
If you have more questions about Developer Certificates of Origin, why are required, what they mean, and how to configure your system to use them, see `The Beginners Guide to DCOs <./dco/>`__, or `get in touch with the core team </community/team>`__.
--- ---
incomplete: yes gutter:
All Contributions Welcome
----------------------------------
But it's not just about code. A successful software project requires documentation, design skills, feedback and bug reports. The BeeWare community acknowledges that all contributions are important - not just the ones that come as a pull request on GitHub.

View file

@ -0,0 +1,7 @@
_model: page
---
sort_key: 1
---
title: First-time contributors
---
summary: Never contributed to open source before? Let us help you!

View file

Before

Width:  |  Height:  |  Size: 66 KiB

After

Width:  |  Height:  |  Size: 66 KiB

View file

Before

Width:  |  Height:  |  Size: 21 KiB

After

Width:  |  Height:  |  Size: 21 KiB

View file

Before

Width:  |  Height:  |  Size: 93 KiB

After

Width:  |  Height:  |  Size: 93 KiB

View file

Before

Width:  |  Height:  |  Size: 37 KiB

After

Width:  |  Height:  |  Size: 37 KiB

View file

@ -0,0 +1,34 @@
body:
Aqui é onde o guia de contribuição para o BeeWare eventualmente virá. Nós não temos uma política de procedimentos concretas ainda - mas sabemos
que elas são realmente importantes e temos intenção de escreve-las em breve.
No meio tempo: Sigam a `PEP8 <https://www.python.org/dev/peps/pep-0008/>`__ (prestando bastante atenção a `Seção 2 <https://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds>`__), e os procedimentos padrões de como fazer um
forking do GitHub. Nós vamos trabalhar no resto enquanto isso.
Assine seu trabalho
-------------------------
Antes de nós podermos aceitar sua contribuição no BeeWare, você precisa nos dar permissão para faze-lo. Já que você é um autor de um trabalho
criativo (um pedaço de código, ou alguma documentação), você automaticamente detêm os direitos desse trabalho. BeeWare não pode usar sua contribuição legalmente a menos que você nos dê permissão para faze-lo.
O projeto BeeWare usa um mecanismo conhecido como um `Certificado de Origem do Desenvolvedor(DCO) <./dco/>`__ para admnistrar esse processo. O DCO é uma declaração legal obrigatória que atesta que você é o criador de uma contribuição e que você permite que o BeeWare use o seu trabalho.
Para indicar que você concorda com os termos do DCO, você precisa adicionar uma linha em todas suas mensagens de commit::
Signed-off-by: Joe Smith <joe.smith@email.com>
Se você configurou seu ``user.name`` e ``user.email`` na sua configuração do git, você pode assinar seu commit automaticamente com ``git commit -s``.
Se você tem mais perguntas sobre o DCO, porque ele é necessário, o que significa e como configurar seu sistema para usa-lo, veja `Guia do Iniciante do DCO <./dco/>`__, ou `entre em contato com o time de desenvolvimento </community/team>`__.
---
incomplete: yes
---
sort_key: 2
---
summary: O processo de desenvolvimento do BeeWare
---
title: Como contribuir

View file

@ -0,0 +1,33 @@
_model: page
---
title: 如何貢獻
---
sort_key: 2
---
summary: BeeWare開發流程
---
body:
這裡是貢獻指南將去的地方。我們還是沒有具體的規範和程序——可是我們承認都很重要,而且打算一有機會就要寫好。
在此期間: 參考 `PEP8 <https://www.python.org/dev/peps/pep-0008/>`__ (而且仔細關注 `Section 2 <https://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds>`__), and Github vanilla forking procedures. 其他的一出現我們就處理。
簽上您的工作
---------------
我們把你的貢獻合並起來之前你必須給我們許可這樣做。因為你是作品的製造者源碼或者文檔的作者時你有知識產權的。BeeWare必須得到你的許可才能合法地使用你的貢獻。
BeeWare項目是以 `Developer Certificate of Origin (DCO) <./dco/>`__ 來管理這個過程. DCO是一種有法律约束力的宣告是保證你是貢獻的製造者而且你想讓BeeWare使用貢獻。
為了表示你同意DCO的條款把下面的一行加入你的git commit message::
Signed-off-by: Joe Smith <joe.smith@email.com>
如果在git配置你指定 ``user.name`` 和 ``user.email``, 你能以 ``git commit -s`` 來自動地簽commit message.
如果你還有關於Developer Certificates of Origin的問題為什麼需要它它是什麼意思以及怎麼配置系統使用它看看 `The Beginners Guide to DCOs <./dco/>`__, 或者 `聯繫核心團隊 </community/team>`__.
---
incomplete: yes

View file

@ -0,0 +1,33 @@
_model: page
---
title: Process
---
sort_key: 2
---
summary: The BeeWare development process
---
body:
This is where the BeeWare contribution guide will eventually go. We don't have a concrete set of policies and procedures yet - but we know they're really important, and we're intending to write them as soon as we get a chance.
In the meantime: Follow `PEP8 <https://www.python.org/dev/peps/pep-0008/>`__ (with careful attention paid to `Section 2 <https://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds>`__), and Github vanilla forking procedures. We'll work the rest out as we go.
Sign your work
---------------
Before we can merge your contribution into BeeWare, you need to give us permission to do so. Since you're an author of a creative work (a piece of code, or some documentation), you automatically own the copyright for that work. BeeWare can't legally use that contribution unless you give us permission to do so.
The BeeWare project uses a mechansim known as a `Developer Certificate of Origin (DCO) <./dco/>`__ to manage this process. The DCO is a legally binding statement that asserts that you are the creator of your contribution, and that you wish to allow BeeWare to use your work.
To indicate that you agree to the terms of the DCO, you just add a line to every git commit message::
Signed-off-by: Joe Smith <joe.smith@email.com>
If you set your ``user.name`` and ``user.email`` as part of your git configuration, you can sign your commit automatically with ``git commit -s``.
If you have more questions about Developer Certificates of Origin, why are required, what they mean, and how to configure your system to use them, see `The Beginners Guide to DCOs <./dco/>`__, or `get in touch with the core team </community/team>`__.
---
incomplete: yes

View file

@ -14,13 +14,13 @@ por $10/mês (dólares)
Membros Entusiastas podem ter seu nome listado na `Página dos Membros </community/members/>`__. Membros Entusiastas podem ter seu nome listado na `Página dos Membros </community/members/>`__.
Nós também temos um programa de bolsa de estudos que confere a associação para pessoas que tem o potencial de avançar com a comunidade BeeWare Nós também temos um programa de bolsa de estudos que confere a associação para pessoas que tem o potencial de avançar com a comunidade BeeWare
para novos e interessantes caminhos. Se você gostaria de poder aplicar para uma bolsa de estudos, por favor contate `o Time de Bolsas de Estudo do BeeWare <mailto:scholarship@pybee.org>`__. para novos e interessantes caminhos. Se você gostaria de poder aplicar para uma bolsa de estudos, por favor contate `o Time de Bolsas de Estudo do BeeWare <mailto:scholarship@pybee.org>`__.
Membro Profissional Membro Profissional
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
Se você usa o BeeWare profissionalmente, nós convidamos você a se tornar um **Membro Profissional** da comunidade BeeWare por $50/mês. Se você usa o BeeWare profissionalmente, nós convidamos você a se tornar um **Membro Profissional** da comunidade BeeWare por $50/mês.
.. raw:: html .. raw:: html
@ -81,7 +81,7 @@ Contribuições Únicas
~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~
Membros são nosso método preferido de ajuda para o BeeWare, já que eles proporcionam estabilidade ao projeto. No entanto, nós entendemos que isso nem sempre é compatível com o orçamento ou processo de gasto de algumas empresas. Membros são nosso método preferido de ajuda para o BeeWare, já que eles proporcionam estabilidade ao projeto. No entanto, nós entendemos que isso nem sempre é compatível com o orçamento ou processo de gasto de algumas empresas.
Se você não pode (ou não gostaria) de se tornar um membro do projeto BeeWare, você pode fazer uma contribuição única. Se você não pode (ou não gostaria) de se tornar um membro do projeto BeeWare, você pode fazer uma contribuição única.
.. raw:: html .. raw:: html
@ -95,7 +95,7 @@ Outras Opções
Se você gostaria de falar com alguém sobre outras oportunidades de marca ou patrocínio, ou gostaria de outras formas de opções de pagamento para ser um membro, por favor fale diretamente com `Russell Keith-Magee <mailto:russell@pybee.org>`__. Se você gostaria de falar com alguém sobre outras oportunidades de marca ou patrocínio, ou gostaria de outras formas de opções de pagamento para ser um membro, por favor fale diretamente com `Russell Keith-Magee <mailto:russell@pybee.org>`__.
--- ---
sort_key: 6 sort_key: 4
--- ---
summary: Como ajudar financeiramente o BeeWare summary: Como ajudar financeiramente o BeeWare
--- ---

View file

@ -1,6 +1,6 @@
_model: page _model: page
--- ---
sort_key: 6 sort_key: 4
--- ---
_template: membership.html _template: membership.html
--- ---

View file

@ -1,6 +1,6 @@
_model: page _model: page
--- ---
sort_key: 6 sort_key: 4
--- ---
_template: membership.html _template: membership.html
--- ---

View file

@ -1,74 +0,0 @@
body:
Existem muitas formas de ajudar o BeeWare.
Primeiras Contribuições
----------------------------
Se você é novo em contribuir para projetos open source veja o `guia das Primeiras contribuições <../first-time/>`__.
Contribuições com Código
------------------------------
Se você está procurando algo para trabalhar e não sabe onde seus
esforços podem ser bem-vindos, tente procurar no rastreador de tickets
por um projeto do seu interesse. Normalmente haverão alguns tickets
com problemas conhecidos; qualquer ticket é um candidato a ser
consertado. Alguns tickets em particular tem a tag ``up-for-grabs`` -
isto indica que são areas de particular interesse onde o projeto
gostaria de contribuições.
Se esta é sua primeira contribuição, alguns tickets possuem a tag
``first-timers-only``. Esses são problemas especiais que foram selecionados
porque eles são relativamente simples para apresenta-lo ao projeto, e o
time do PyBee vai ajudar qualquer primeiro contribuidor a enviar um
patch para algum desses problemas.
Uso da Plataforma
---------------------
Você usa Windows ou algum "flavor" de Linux? Você consegue instalar um projeto ou uma aplicação no seu sistema? Você encontrou algum problema?
Se sim, por favor atualize a documentação para mostrar como você fez para faze-lo funcionar, ou relate uma issue se você encontrou um bug que não pode consertar.
Documentação
-------------------
A documentação está atualizada? Você acha que alguma coisa pode ser explicada de outra forma? Existem seções perdidas? Você tem alguma ideia para um tutorial que pode ser escrita? Por favor envie um Pull Request!
Esse Website
--------------------
Existe algo errado ou perdido nesse website? Por favor sinta-se a vontade para `fazer uma edição <https://github.com/pybee/pybee.github.io>`__ e submeta uma pull request!
Alguma outra coisa
-------------------------
Se você tiver alguma ideia para algo, ou se você não ver nenhum
ticket, ou você gostaria de ser ajudado com um ticket, ou se você
não tem certeza de como proceder, contate os mantenedores do projeto no
`Twitter <http://twitter.com/pybeeware/>`__ ou `Gitter <http://gitter.im/pybee/general>`__.
Os mantenedores do projeto amam colaborar, especialmente com
novos contribuidores e vão ficar felizes em responder qualquer
pergunta ou ajuda-lo com qualquer a passar por qualquer problema
que você possa encontrar.
---
gutter:
Todas as Contribuições são Bem-Vindas
------------------------------------------------
Não apenas com código. Um software bem sucedido precisa ter documentação, design bem trabalhado, feedback e bugs reportados. A comunidade
BeeWare reconhece que todas as contribuições são importantes - não somente aquelas que vem como uma pull request no GitHub
---
incomplete: yes
---
sort_key: 1
---
summary: Qual ajuda é necessária
---
title:
O que eu posso fazer para ajudar?

View file

@ -1,68 +0,0 @@
_model: page
---
sort_key: 1
---
title: 如何幫助
---
summary: 具體需求
---
body:
幫忙的方式豐富哦!
第一次貢獻者
------------------------
如果你從來沒向開源貢獻過,請參閱 `第一次貢獻者的指南 <http://pybee.org/contributing/first-time/>`__.
貢獻源碼
---------------------
如果你是在尋找具體任務,但是不知道應該從哪裡開始,那去看看缺陷跟蹤管理系
統。你在那邊能找到對你有趣的項目。裡面經常會有些已知問題的票;所有的票是
可以處理的,特別是有 ``up-for-grabs`` 的標籤——這標籤是表示項目里特指的需求。
如果你是第一次的貢獻者,你可以看看有著 ``first-timers-only`` 標籤的票.因為
這些議題適合和項目剛開始接觸的貢獻者,所以這些特別的議題已經被專門給第一
次貢獻者。PyBee團隊會輔導任何第一次貢獻者提交關於上述議題的補丁。
平台使用
---------------
你會使用微軟還是不同類型的Linux你能把項目安裝好嗎你碰到了問題沒有
有的話,請編輯文檔給其他人看怎麼做。如果找到了你自己沒辦法解決的問題,請
報告問題。
文檔
-------------------
文檔最新語氣合適步驟清楚想加入一個輔導材料請提交一個Pull Request!
本網頁
--------------------
本網頁是有錯誤還是缺少些內容?請自在地 `編輯 <https://github.com/pybee/pybee.github.io>`__ 然後提交pull request!
其他的
-------------------------
如果你有自己的想法,找不到有關的票,想收到輔導,或者不知道在哪入手,請在
`Twitter <http://twitter.com/pybeeware/>`__ 或
`Gitter <http://gitter.im/pybee/general>`__ 聯繫維護項目著。
維護項目著熱愛協作,特別適合新貢獻者協作,而且會高高興興的回答任何問題以
及幫你解決任何問題。
---
gutter:
歡迎所有的貢獻
----------------------------------
項目里不只是包括代碼——要成功的軟體項目有著文檔設計技能意見以及臭蟲報告。BeeWare社區覺得不只是GitHub上的pull request很重要——所有的貢獻非常重要。
---
incomplete: yes

View file

@ -1,74 +0,0 @@
_model: page
---
sort_key: 1
---
title: What can you do to help?
---
summary: What help is needed
---
body:
There are many ways to help with BeeWare.
First-time Contributors
------------------------
If you are new to contributing on an open source project refer to the `First-time contributors guide <http://pybee.org/contributing/first-time/>`__.
Code Contributions
---------------------
If you're looking for something to work on, and don't know where your
effort would be welcome, try looking at the ticket tracker for a project
of interest. There will usually be a couple of tickets with known
problems; any ticket is a candidate for being fixed. Some tickets in
particular will be tagged ``up-for-grabs`` - this indicates that they
are areas of particular interest where the project would like
contributions.
If you're a first time contributor, some tickets are also tagged as
``first-timers-only``. These are special issues that have been selected
because they're relatively simple introductions to the project, and the
PyBee team will mentor any first time contributor in committing a patch
for one of these issues.
Platform Usage
---------------
Do you use Windows or various flavours of Linux? Are you able to install a project or application on your system? Did you run into any problems?
If so, please update the documentation to show how you were able to get it to work, or log an issue if you've found a bug that you can't fix.
Documentation
-------------------
Is the documentation up to date? Do you think things could be worded differently? Are there missing sections? Do you have an idea for a tutorial that could be written? Please submit a Pull Request!
This Website
--------------------
Is there anything wrong or missing from this website? Please feel free to `make edits <https://github.com/pybee/pybee.github.io>`__ and submit a pull request!
Something else
-------------------------
If you've got your own idea for something, or if you don't see any
tickets, or you want to be mentored on a ticket, or you aren't sure how
to proceed, contact the project maintainers on
`Twitter <http://twitter.com/pybeeware/>`__ or
`Gitter <http://gitter.im/pybee/general>`__. The project maintainers love
collaborating, especially with new contributors, and will gladly answer
any questions or walk you through any problems you may encounter.
---
gutter:
All Contributions Welcome
----------------------------------
But it's not just about code. A successful software project requires documentation, design skills, feedback and bug reports. The BeeWare community acknowledges that all contributions are important - not just the ones that come as a pull request on GitHub.
---
incomplete: yes

4
templates/leaf-page.html Normal file
View file

@ -0,0 +1,4 @@
{% extends "page.html" %}
{% block main %}
{{ this.body }}
{% endblock %}