Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update references to first-timer-issues. #510

Merged
merged 4 commits into from
Jan 11, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ jobs:
build:
name: Build and preview site
runs-on: ubuntu-latest
if: contains(github.event.pull_request.labels.*.name, 'generate_preview')
if: contains(github.event.pull_request.labels.*.name, 'preview')
steps:
- uses: actions/checkout@v1
with:
Expand Down
14 changes: 7 additions & 7 deletions content/contributing/how/contents+ar.lr
Original file line number Diff line number Diff line change
Expand Up @@ -20,20 +20,21 @@ body:
المساهمة بالبرمجة
------------------

إذا كنت تبحث عن شيء لتساهم فيه ، ولا تعرف من أين تبدأ فإن جهدك مرحبٌ به مهما كان بسيطا ،حاول البحث في تعقب التذاكر لمشروع ما يصب
في صلب اهتماماتك ،عادة ما سيكون هناك بضع تذاكر مشاكل معروفة ،إن أي تذكرة موجودة هي مرشحة ليتم إصلاحها . ستكون بعض التذاكر موسومة على وجه الخصوص `[up-for-grabs] <https://github.com/search?q=user%3Abeeware+label%3Aup-for-grabs+is%3Aissue+is%3Aopen&type=>`__ وهذا يدل على أنها مجالات ذات أهمية خاصة حيث يرغب المشروع في الحصول على مساهمات ، أما إذا كانت هذه مساهمتك الأولى ، فسيتم تمييز بعض التذاكر `[first-timers-only] <https://github.com/search?q=user%3Apybee+label%3Afirst-timers-only+is%3Aissue+is%3Aopen&type=>`__ وقد تم اختيارها لأنها مقدمات بسيطة نسبيًا للمساهمة في المشروع ، وسيقوم فريقنا بإرشاد أي مساهم من أجل المساهمة في تصحيح أحد هذه المشاكل .
إذا كنت تبحث عن شيء لتساهم فيه ، ولا تعرف من أين تبدأ فإن جهدك مرحبٌ به مهما كان بسيطا ،حاول البحث في تعقب التذاكر لمشروع ما يصب
في صلب اهتماماتك ،عادة ما سيكون هناك بضع تذاكر مشاكل معروفة ،إن أي تذكرة موجودة هي مرشحة ليتم إصلاحها . ستكون بعض التذاكر موسومة على وجه الخصوص `[up-for-grabs] <https://github.com/search?q=user%3Abeeware+label%3Aup-for-grabs+is%3Aissue+is%3Aopen&type=>`__ وهذا يدل على أنها مجالات ذات أهمية خاصة حيث يرغب المشروع في الحصول على مساهمات ، أما إذا كانت هذه مساهمتك الأولى ، فسيتم تمييز بعض التذاكر `[good first issue] <https://github.com/search?q=user%3Abeeware+label%3A%22good%20first%20issue%22+is%3Aissue+is%3Aopen&type=issues>`__ وقد تم اختيارها لأنها مقدمات بسيطة نسبيًا للمساهمة في المشروع ، وسيقوم فريقنا بإرشاد أي مساهم من أجل المساهمة في تصحيح أحد هذه المشاكل .

استخدام المنصة

استخدام المنصة
---------------

هل تستخدم ويندوز أو إحدى توزيعات لينكس ؟ هل كنت قادرا على تثبيت مشروع أو تطبيق على نظامك؟ إذا واجهتك أية صعوبات أثناء قيامك بذالك ، سواءا كنت قادرا على إصلاحها أم لا ، من فضلك قمت بتحديث التوثيق واشرح كيف كنت قادرا على إصلاحها ، أو تسجيل مشكلة إذا وجدت خطأ لا يمكنك إصلاحه .

التوثيق
--------

هل التوثيق محدَث ؟ هل تعتقد أنه يمكننا صياغته بطريقة أخرى ؟ هل هناك أقسام ناقصة أو غير موجودة ؟ هل عندك أية أفكار حول كيفية كتابة دروات تعليمية ؟ من فضلك قم بتنفيذ طلب دمج في المشروع .
هل التوثيق محدَث ؟ هل تعتقد أنه يمكننا صياغته بطريقة أخرى ؟ هل هناك أقسام ناقصة أو غير موجودة ؟ هل عندك أية أفكار حول كيفية كتابة دروات تعليمية ؟ من فضلك قم بتنفيذ طلب دمج في المشروع .

هذا الموقع
هذا الموقع
-----------

هل هناك أي شيء خاطئ أو مفقود من هذا الموقع؟
Expand All @@ -50,8 +51,7 @@ gutter:
جميع المساهمات مرحب بها
----------------------------


ليس في مجال البرمجة فقط ، بل في أي مجال ، يتطلب أيَ مشروع برمجي ناجح أشياء عدة ، ومن بينها : التوثيق الجيَد ، مهارات التصميم ، ردود الفعل و التبليغ عن الأخطاء البرمجية . إن مجتمع BeeWare يقر ويعترف بأن جميع المساهمات مهمة ، ولا يحصرها فقط في تلك التي تأتي على طريق طلب دمج على منصة GitHub .
---
incomplete: yes

4 changes: 2 additions & 2 deletions content/contributing/how/contents+es.lr
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,9 @@ Nunca has colaborado a un proyecto de código abierto antes? ¡Déjanos ayudarte
Contribuciones de código
--------------------------------

Si estás buscando algo para trabajar y no sabes dónde concentrar tus esfuerzos, trata de mirar el rastreador de tiquete de algún proyecto de tu interés. Normalmente habrá un par de entradas con problemas; cualquier tiquete es un candidato para ser arreglado. Algunos tiquetes en particular se etiquetan `[up-for-grabs] <https://github.com/search?q=user%3Abeeware+label%3Aup-for-grabs+is%3Aopen&type=Issues>`__ - esto indica que son áreas de especial interés donde el proyecto necesita contribuciones.
Si estás buscando algo para trabajar y no sabes dónde concentrar tus esfuerzos, trata de mirar el rastreador de tiquete de algún proyecto de tu interés. Normalmente habrá un par de entradas con problemas; cualquier tiquete es un candidato para ser arreglado.

Si eres un colaborador principiante, algunos tiquetes también se etiquetan como `[first-timers-only] <https://github.com/search?q=user%3Apybee+label%3Afirst-timers-only+is%3Aopen&type=Issues>`__. Estos son temas especiales que han sido seleccionados porque representan introducciones relativamente sencillas al proyecto, y el equipo PyBee servirá de mentor de cualquier colaborador principiante que realice un *Pull Request* una de estos tiquetes.
Si eres un colaborador principiante, algunos tiquetes también se etiquetan como `[good first issue] <https://github.com/search?q=user%3Abeeware+label%3A%22good%20first%20issue%22+is%3Aissue+is%3Aopen&type=issues>`__. Estos son temas especiales que han sido seleccionados porque representan introducciones relativamente sencillas al proyecto, y el equipo PyBee servirá de mentor de cualquier colaborador principiante que realice un *Pull Request* una de estos tiquetes.

Plataforma de trabajo
--------------------------
Expand Down
8 changes: 2 additions & 6 deletions content/contributing/how/contents+fr.lr
Original file line number Diff line number Diff line change
Expand Up @@ -27,14 +27,10 @@ Vos contributions de code sont les bienvenues! Familiarisez-vous avec notre
Si vous cherchez une chose sur laquelle travailler, et ne savez pas par où
commencer, jetez un oeil au suivi de tickets pour le projet qui vous intéresse.
Il y aura généralement quelques tickets avec des problèmes identifiés;
n'importe quel ticket est un bon candidat pour des corrections. Certains
tickets en particulier porteront le label `[up-for-grabs]
<https://github.com/search?q=user%3Abeeware+label%3Aup-for-grabs+is%3Aissue+is%3Aopen&type=>`__
- cela indique qu'ils sont dans des domaines où les contributions intéressent
particulièrement le projet.
n'importe quel ticket est un bon candidat pour des corrections.

Si vous contribuez pour la première fois, certains tickets portent aussi le
label `[first-timers-only] <https://github.com/search?q=user%3Abeeware+label%3Afirst-timers-only+is%3Aissue+is%3Aopen&type=>`__.
label `[good first issue] <https://github.com/search?q=user%3Abeeware+label%3A%22good%20first%20issue%22+is%3Aissue+is%3Aopen&type=issues>`__.
Ce sont des problèmes spéciaux qui ont été sélectionnés car ils permettent d'introduire le projet de manière simple, et l'équipe BeeWare guidera tout nouveau contributeur pour fournir un correctif à un ce ces problèmes.

Utilisation des plateformes
Expand Down
7 changes: 2 additions & 5 deletions content/contributing/how/contents+pt.lr
Original file line number Diff line number Diff line change
Expand Up @@ -29,13 +29,10 @@ o nosso `Processo de Desenvolvimento </pt_BR/contributing/how/process/>`__.
Se quer fazer algo mas não sabe onde seus esforços podem ser bem-vindos,
procure no rastreador de tickets um projeto de seu interesse. Costumam existir
alguns tickets com problemas conhecidos; qualquer ticket é um candidato a ser
consertado. Alguns tickets são marcados como
`[up-for-grabs] <https://github.com/search?q=user%3Abeeware+label%3Aup-for-grabs+is%3Aissue+is%3Aopen&type=>`__
- isto indica áreas de interesse específico onde o projeto
gostaria de contribuições.
consertado.

Se quiser fazer sua primeira contribuição, veja os tickets marcados como
`[first-timers-only] <https://github.com/search?q=user%3Apybee+label%3Afirst-timers-only+is%3Aissue+is%3Aopen&type=>`__.
`[good first issue] <https://github.com/search?q=user%3Abeeware+label%3A%22good%20first%20issue%22+is%3Aissue+is%3Aopen&type=issues>`__.
Eles são problemas especiais, selecionados por serem introduções relativamente simples ao projeto,
e a equipe do PyBee orientará iniciantes no processo de contribuição para
qualquer desses problemas.
Expand Down
22 changes: 11 additions & 11 deletions content/contributing/how/contents+tr.lr
Original file line number Diff line number Diff line change
Expand Up @@ -16,17 +16,17 @@ _model: page
---------------------------

Eğer projede yeniysen (hatta genel olarak açık kaynak için yeniysen), başlangıç için en iyi yer`burasıdır </contributing/how/first-time/>`__. Açık kaynak koda herkes katkıda bulunabilir ve sana nasıl yapabileceğini göstermek için biz buradayız.

.. _First-time Contributors: /contributing/how/first-time/

Kod Katkıları
-------------------

Kod katkılarınızı bekliyoruz! Lütfen bizim `Geliştirme sürecimizi </contributing/how/process/>`__ inceleyin.
Üzerinde çalışacak bir şey arıyorsanız ve nereden başlayacağınızı bilemiyorsanız ilginizi çekebilecek bir proje bulmak için projelerin bulunduğu biletler kısmını inceleyin. Genellikle sorunları bilinen bir kaç bilet mevcuttur ve herhangi bir bilet düzeltilmeye adaydır. Özellikle bazı biletler `[up-for-grabs] <https://github.com/search?q=user%3Abeeware+label%3Aup-for-grabs+is%3Aissue+is%3Aopen&type=>`__ - olarak etiketlenecektir. Bu, projenin katkı sağlamak istediği özel alanları olduğunu gösterir.
Eğer ilk kez katkıda bulunuyorsanız bazı biletler `[first-timers-only] <https://github.com/search?q=user%3Abeeware+label%3Afirst-timers-only+is%3Aissue+is%3Aopen&type=>`__ şeklinde etiketlidir.

Üzerinde çalışacak bir şey arıyorsanız ve nereden başlayacağınızı bilemiyorsanız ilginizi çekebilecek bir proje bulmak için projelerin bulunduğu biletler kısmını inceleyin. Genellikle sorunları bilinen bir kaç bilet mevcuttur ve herhangi bir bilet düzeltilmeye adaydır.

Eğer ilk kez katkıda bulunuyorsanız bazı biletler `[good first issue] <https://github.com/search?q=user%3Abeeware+label%3A%22good%20first%20issue%22+is%3Aissue+is%3Aopen&type=issues>`__ şeklinde etiketlidir.
Bunlar seçilmiş özel konulardır çünkü nispeten basit bir şekilde tanımlanmışlardır ve PyBee ekibi bu sorunların çözülmesi aşamasında ilk kez katkıda bulunacaklara rehberlik edeceklerdir.

Platform Kullanımı
Expand All @@ -51,12 +51,12 @@ _model: page
Başka bir şey
-------------------------

Başka bir şey için bir fikriniz varsa ya da herhangi bir bileti göremediyseniz
ya da biletleri yönetmek istiyorsanız ya da nasıl ilerleyeceğiniz hakkında bir
Başka bir şey için bir fikriniz varsa ya da herhangi bir bileti göremediyseniz
ya da biletleri yönetmek istiyorsanız ya da nasıl ilerleyeceğiniz hakkında bir
fikriniz yoksa proje yöneticileriyle iletişime geçin
`Twitter <https://twitter.com/pybeeware/>`__ ya da
`Discord </bee/chat/>`__. Proje yöneticileri yeni katkı sağlayacak kişilerle
iş birliği yapmayı severler ve soracağınız her hangi bir soruyu memnuniyetle cevaplarlar, herhangi
`Discord </bee/chat/>`__. Proje yöneticileri yeni katkı sağlayacak kişilerle
iş birliği yapmayı severler ve soracağınız her hangi bir soruyu memnuniyetle cevaplarlar, herhangi
bir sorun yaşarsanız size yol gösterirler.


Expand Down
6 changes: 2 additions & 4 deletions content/contributing/how/contents+zh.lr
Original file line number Diff line number Diff line change
Expand Up @@ -21,10 +21,9 @@ body:
---------------------

如果你是在尋找具體任務,但是不知道應該從哪裡開始,那去看看缺陷跟蹤管理系
統。你在那邊能找到對你有趣的項目。裡面經常會有些已知問題的票;所有的票是
可以處理的,特別是有 ``up-for-grabs`` 的標籤——這標籤是表示項目裡特指的需求。
統。你在那邊能找到對你有趣的項目。

如果你是第一次貢獻,你可以看看有著 ``first-timers-only`` 標籤的票.因為
如果你是第一次貢獻,你可以看看有著 `[good first issue] <https://github.com/search?q=user%3Abeeware+label%3A%22good%20first%20issue%22+is%3Aissue+is%3Aopen&type=issues>`__ 標籤的票.因為
這些議題適合和項目剛開始接觸的貢獻者,所以這些特別的議題已經被專門給第一
次貢獻者。BeeWare團隊會輔導任何第一次貢獻者提交關於上述議題的補丁。

Expand Down Expand Up @@ -80,4 +79,3 @@ gutter:
incomplete:

yes

8 changes: 2 additions & 6 deletions content/contributing/how/contents.lr
Original file line number Diff line number Diff line change
Expand Up @@ -28,14 +28,10 @@ our `Development Process </contributing/how/process/>`__.
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] <https://github.com/search?q=user%3Abeeware+label%3Aup-for-grabs+is%3Aissue+is%3Aopen&type=>`__
- this indicates that they are areas of particular interest where the
project would like contributions.
problems; any ticket is a candidate for being fixed.

If you're a first time contributor, some tickets are also tagged as
`[first-timers-only] <https://github.com/search?q=user%3Abeeware+label%3Afirst-timers-only+is%3Aissue+is%3Aopen&type=>`__.
`[good first issue] <https://github.com/search?q=user%3Abeeware+label%3A%22good%20first%20issue%22+is%3Aissue+is%3Aopen&type=issues>`__.
These are special issues that have been selected because they're
relatively simple introductions to the project, and the BeeWare team
will mentor any first time contributor in committing a patch for
Expand Down
26 changes: 14 additions & 12 deletions content/contributing/how/first-time/what/contents.lr
Original file line number Diff line number Diff line change
Expand Up @@ -35,17 +35,19 @@ If you'd like to contribute to a tool that has a clearly defined problem
statement, but needs bugs squashed and features added, `Briefcase
<https://github.com/beeware/briefcase>`__ may be the project for you. Briefcase
is a tool for packaging a Python project as a standalone GUI application. It
takes a `pyproject.toml` configuration file, and uses that configuration data
takes a ``pyproject.toml`` configuration file, and uses that configuration data
to generate installers or distributable application bundles.

The Briefcase `issue tracker <https://github.com/beeware/briefcase/issues>`__
has a collection of feature suggestions (and a smaller number of bugs). If this
is your first time contributing, look for one of the tickets labelled
``first-timers-only`` - these are issues that have been specifically picked for
first time contributors because they should be relatively straightforward to
implement. You may also find it helpful to filter the tickets for the platform
you actually use for development - it will be difficult to fix a Linux bug if
you don't have a Linux machine to use for testing!
is your first time contributing, look for one of the tickets labelled `good
first issue
<https://github.com/beeware/briefcase/issues?q=is%3Aopen+is%3Aissue+label%3A%22good%20first%20issue%22>`__
- these are issues that have been specifically picked for first time
contributors because they should be relatively straightforward to implement. You
may also find it helpful to filter the tickets for the platform you actually use
for development - it will be difficult to fix a Linux bug if you don't have a
Linux machine to use for testing!

Pick a ticket, leave a comment that you're looking into the problem, and try
to develop a pull request implementing a fix!
Expand All @@ -69,7 +71,7 @@ GUI programming

If you've got experience with a native widget library - Cocoa on macOS, GTK+ on
Linux, Windows Forms, or the native iOS or Android libraries, you may be able to
help with `Toga </project/projects/libraries/toga/>`__. Toga is a cross platform
help with `Toga <https://github.com/beeware/toga>`__. Toga is a cross platform
widget toolkit - it provides a common interface for user interface elements like
buttons and trees.

Expand Down Expand Up @@ -164,9 +166,9 @@ summary: So you want to help - but where should you start?
---
gutter:

First Timers Only
-------------------------
First Time Contributors
------------------------

Want to start small? Once you've poked about a bit in the tutorials, check out
the BeeWare issues marked `[first-timers-only]
<https://github.com/search?utf8=%E2%9C%93&q=org%3Abeeware+is%3Aissue+is%3Aopen+label%3Aup-for-grabs&type=Issues&ref=searchresults>`__
the BeeWare issues marked `[good first issue]
<https://github.com/search?q=user%3Abeeware+label%3A%22good%20first%20issue%22+is%3Aissue+is%3Aopen&type=issues>`__
8 changes: 1 addition & 7 deletions content/project/projects/attic/voc/contents+ar.lr
Original file line number Diff line number Diff line change
Expand Up @@ -38,14 +38,8 @@ If you'd like to contribute to VOC development, we have a `guide for first time
---
help_required:

VOC is in active development.
VOC has been archived.

Check `GitHub`_ for issues marked `Up For Grabs`_ and `First Timers Only`_


.. _GitHub: https://github.com/beeware/voc
.. _Up For Grabs: https://github.com/beeware/voc/issues?q=is%3Aissue+is%3Aopen+label%3Aup-for-grabs
.. _First Timers Only: https://github.com/beeware/voc/issues?q=is%3Aissue+is%3Aopen+label%3Afirst-timers-only
---
pun:

Expand Down
9 changes: 1 addition & 8 deletions content/project/projects/attic/voc/contents+es.lr
Original file line number Diff line number Diff line change
Expand Up @@ -35,14 +35,7 @@ Si desea contribuir al desarrollo de VOC, tenemos una `guía para principiantes`
---
help_required:

VOC está en desarrollo activo.

Revisa `GitHub`_ para buscar tiquetes marcados como `"Up For Grabs"`_ y `"First Timers Only"`_


.. _GitHub: https://github.com/beeware/voc
.. _"Up For Grabs": https://github.com/beeware/voc/issues?q=is%3Aissue+is%3Aopen+label%3Aup-for-grabs
.. _"First Timers Only": https://github.com/beeware/voc/issues?q=is%3Aissue+is%3Aopen+label%3Afirst-timers-only
VOC ha sido archivado.
---
pun:

Expand Down
8 changes: 1 addition & 7 deletions content/project/projects/attic/voc/contents.lr
Original file line number Diff line number Diff line change
Expand Up @@ -38,14 +38,8 @@ If you'd like to contribute to VOC development, we have a `guide for first time
---
help_required:

VOC is in active development.
VOC has been archived.

Check `GitHub`_ for issues marked `Up For Grabs`_ and `First Timers Only`_


.. _GitHub: https://github.com/beeware/voc
.. _Up For Grabs: https://github.com/beeware/voc/issues?q=is%3Aissue+is%3Aopen+label%3Aup-for-grabs
.. _First Timers Only: https://github.com/beeware/voc/issues?q=is%3Aissue+is%3Aopen+label%3Afirst-timers-only
---
pun:

Expand Down