Tweaked the structure of the contributing pages.
This commit is contained in:
Russell Keith-Magee
parent
5e37b73d58
commit
8fed4e0550
49 changed files with 336 additions and 317 deletions
|
|
@ -25,7 +25,7 @@ As primeiras 100 BeeWare Challenge Coins foram confeccionadas graças ao apoio f
|
|||
.. _MaxCDN: /community/members/maxcdn/
|
||||
.. _Revolution Systems: /community/members/revsys/
|
||||
---
|
||||
sort_key: 5
|
||||
sort_key: 2
|
||||
---
|
||||
summary: O que é uma challenge coin, e porque você quer ter uma?
|
||||
---
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
_model: page
|
||||
---
|
||||
sort_key: 5
|
||||
sort_key: 2
|
||||
---
|
||||
title: Challenge Coins
|
||||
---
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
_model: page
|
||||
---
|
||||
sort_key: 5
|
||||
sort_key: 2
|
||||
---
|
||||
title: Challenge Coins
|
||||
---
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
body:
|
||||
|
||||
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.
|
||||
|
||||
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
|
||||
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.
|
||||
|
||||
Esses níveis podem ser descritos como:
|
||||
|
||||
Abelha ou Abelha Operária:
|
||||
- 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.
|
||||
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.
|
||||
- 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.
|
||||
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.
|
||||
|
||||
Apicultor:
|
||||
- Uma abelha que foi reconhecida como um contribuidor confiável. Essas abelhas
|
||||
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
|
||||
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
|
||||
- Uma abelha que foi reconhecida como um contribuidor confiável. Essas abelhas
|
||||
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
|
||||
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
|
||||
o direito fazer commit bits para o projeto onde sua especialidade é reconhecida.
|
||||
|
||||
Apicultor Sênior:
|
||||
- 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
|
||||
- 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
|
||||
arquitetura, mas precisão responder ao BDFN.
|
||||
|
||||
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
|
||||
- Esse papel nunca muda e continua ad infinitum
|
||||
- Esse papel é diferente do BDFN.
|
||||
- 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 é diferente do BDFN.
|
||||
|
||||
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.
|
||||
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
|
||||
além do open source e o equilíbrio entre programar/viver e bem-estar é algo importante para
|
||||
- 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
|
||||
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
|
||||
se ter em mente.
|
||||
|
||||
|
||||
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:
|
||||
|
||||
|
||||
|
|
@ -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 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.**
|
||||
|
||||
* **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.**
|
||||
|
||||
* **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
|
||||
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
|
||||
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
|
||||
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
|
||||
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.
|
||||
|
||||
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
|
||||
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
|
||||
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
|
||||
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
|
||||
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
|
||||
ajuda, conselhos e mentorias.
|
||||
|
||||
|
|
@ -116,16 +116,16 @@ gutter:
|
|||
"Commit bit"?
|
||||
--------------------------------
|
||||
|
||||
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
|
||||
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
|
||||
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
|
||||
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
|
||||
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
|
||||
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
|
||||
diretamente no projeto.
|
||||
|
||||
---
|
||||
sort_key: 4
|
||||
sort_key: 3
|
||||
---
|
||||
summary: O que é o time principal e o que ele faz?
|
||||
---
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@ _model: page
|
|||
---
|
||||
title: 核心團隊和責任
|
||||
---
|
||||
sort_key: 4
|
||||
sort_key: 3
|
||||
---
|
||||
summary: 核心團隊是什麼？他們有哪些責任？
|
||||
---
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@ _model: page
|
|||
---
|
||||
title: Core Team, and Responsibilities
|
||||
---
|
||||
sort_key: 4
|
||||
sort_key: 3
|
||||
---
|
||||
summary: What is the core team, and what do they do?
|
||||
---
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -1,10 +1,12 @@
|
|||
_model: page
|
||||
---
|
||||
_template: leaf-page.html
|
||||
---
|
||||
sort_key: 1
|
||||
---
|
||||
title: مالذي تستطيع عمله للمساعدة ؟
|
||||
---
|
||||
summary: ما نوع المساعدات المطلوبة
|
||||
summary: تريد المشاركة؟ الكل مرحب به للمساعدة
|
||||
---
|
||||
body:
|
||||
|
||||
|
|
@ -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:
|
||||
|
||||
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.
|
||||
Existem muitas formas de ajudar o BeeWare.
|
||||
|
||||
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.
|
||||
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
|
||||
------------------------------
|
||||
|
||||
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
|
||||
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.
|
||||
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.
|
||||
|
||||
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>
|
||||
|
||||
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>`__.
|
||||
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: 2
|
||||
---
|
||||
summary: O processo de desenvolvimento do BeeWare
|
||||
---
|
||||
title: Como contribuir
|
||||
|
|
|
|||
|
|
@ -1,33 +1,70 @@
|
|||
_model: page
|
||||
---
|
||||
title: 如何貢獻
|
||||
_template: leaf-page.html
|
||||
---
|
||||
sort_key: 2
|
||||
sort_key: 1
|
||||
---
|
||||
summary: BeeWare開發流程
|
||||
title: 如何幫助
|
||||
---
|
||||
summary: 你也想參與嗎？來吧--誰都可以幫忙！
|
||||
---
|
||||
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
|
||||
|
||||
|
|
|
|||
|
|
@ -1,33 +1,76 @@
|
|||
_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:
|
||||
|
||||
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.
|
||||
|
|
|
|||
7
content/contributing/how/first-time/contents.lr
Normal file
7
content/contributing/how/first-time/contents.lr
Normal 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!
|
||||
|
Before Width: | Height: | Size: 66 KiB After Width: | Height: | Size: 66 KiB |
|
Before Width: | Height: | Size: 21 KiB After Width: | Height: | Size: 21 KiB |
|
Before Width: | Height: | Size: 93 KiB After Width: | Height: | Size: 93 KiB |
|
Before Width: | Height: | Size: 37 KiB After Width: | Height: | Size: 37 KiB |
34
content/contributing/how/process/contents+pt.lr
Normal file
34
content/contributing/how/process/contents+pt.lr
Normal 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
|
||||
33
content/contributing/how/process/contents+zh.lr
Normal file
33
content/contributing/how/process/contents+zh.lr
Normal 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
|
||||
33
content/contributing/how/process/contents.lr
Normal file
33
content/contributing/how/process/contents.lr
Normal 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
|
||||
|
|
@ -14,13 +14,13 @@ por $10/mês (dólares)
|
|||
|
||||
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>`__.
|
||||
|
||||
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
|
||||
|
||||
|
|
@ -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.
|
||||
|
||||
|
||||
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
|
||||
|
|
@ -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>`__.
|
||||
---
|
||||
sort_key: 6
|
||||
sort_key: 4
|
||||
---
|
||||
summary: Como ajudar financeiramente o BeeWare
|
||||
---
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
_model: page
|
||||
---
|
||||
sort_key: 6
|
||||
sort_key: 4
|
||||
---
|
||||
_template: membership.html
|
||||
---
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
_model: page
|
||||
---
|
||||
sort_key: 6
|
||||
sort_key: 4
|
||||
---
|
||||
_template: membership.html
|
||||
---
|
||||
|
|
|
|||
|
|
@ -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?
|
||||
|
|
@ -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
|
||||
|
||||
|
|
@ -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
4
templates/leaf-page.html
Normal file
|
|
@ -0,0 +1,4 @@
|
|||
{% extends "page.html" %}
|
||||
{% block main %}
|
||||
{{ this.body }}
|
||||
{% endblock %}
|
||||
Loading…
Reference in a new issue