Skip to content

Commit

Permalink
chore(docs): Apply EbookFoundation#6822 (playground definition) to th…
Browse files Browse the repository at this point in the history
…e rest of CONTRIBUTING files (EbookFoundation#6824)

* Added playground definition

Added a small definition about programming/coding playgrounds for making it understandable to beginners

* Define what is a playground

Via / completes:
- What's a programming playground? EbookFoundation#6107
- Added playground definition EbookFoundation#6817
- Sentence added under playground EbookFoundation#6819

Thanks @Suman373 for the initial idea.

Co-authored-by: Suman Roy <[email protected]>

* reword playground definition as suggested

Co-authored-by: Eric Hellman <[email protected]>

* copy EbookFoundation#6822 playground definition into rest files

* translate EbookFoundation#6822 (playground definition) to spanish

* translate EbookFoundation#6822 (playground definition) to italian

Co-authored-by: ImVector <[email protected]>

* translate EbookFoundation#6822 (playground definition) to french

Thanks to @existential-nonce

Co-authored-by: nonce <[email protected]>

* translate EbookFoundation#6822 (playground definition) to chinese

Provided by @kang8. Thank you too much!

Co-authored-by: kang <[email protected]>

* Improve playground definition in `zh_TW` language

Co-authored-by: Alan Syue <[email protected]>

* Minor improve playground definition in `fr` language

Co-authored-by: lorrding <[email protected]>

Co-authored-by: Suman Roy <[email protected]>
Co-authored-by: Eric Hellman <[email protected]>
Co-authored-by: ImVector <[email protected]>
Co-authored-by: nonce <[email protected]>
Co-authored-by: kang <[email protected]>
Co-authored-by: Alan Syue <[email protected]>
Co-authored-by: lorrding <[email protected]>
  • Loading branch information
8 people authored Jul 25, 2022
1 parent eded902 commit 97022b7
Show file tree
Hide file tree
Showing 14 changed files with 28 additions and 14 deletions.
3 changes: 2 additions & 1 deletion docs/CONTRIBUTING-de.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,12 @@ Durch Deine Mitwirkung verpflichtest Du Dich, dem [Verhaltenskodex](CODE_OF_COND
2. Du musst Dich nicht mit Git auskennen: Wenn Du etwas Interessantes gefunden hast, *das noch nicht in einer der Listen enthalten ist*, öffne bitte ein [Issue](https://github.com/EbookFoundation/free-programming-books/issues) mit Deinen Linkvorschlägen.
- Wenn Du Dich mit Git auskennst, erstelle einen Fork des Repositorys und sende einen Pull Request (PR).

3. Wir führen 5 Arten von Listen. Achte darauf, die richtige zu wählen:
3. Wir führen 6 Arten von Listen. Achte darauf, die richtige zu wählen:

- *Bücher*: PDF, HTML, ePub, eine auf gitbook.io basierende Seite, ein Git Repo etc.
- *Kurse*: Ein Kurs beschreibt Lernmaterialien, die nicht in Buchform existieren. [Dies ist ein Kurs](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
- *Interaktive Tutorials*: Eine interaktive Webseite, die den Benutzer Sourcecode oder Kommandos eingeben lässt und das Resultat auswertet (mit "auswerten" meinen wir nicht "bewerten"). z.&nbsp;B.: [Try Haskell](http://tryhaskell.org), [Try GitHub](http://try.github.io).
- *Playgrounds* : are online and interactive websites, games or desktop software for learning programming. Write, compile (or run), and share code snippets. Playgrounds often allow you to fork and get your hands dirty by playing with code.
- *Podcasts und Screencasts*: Podcasts und Screencasts.
- *Problem Sets & Competitive Programming*: Eine Webseite oder Software, die Dir die Möglichkeit gibt, Deine Programmierfähigkeiten durch die Lösung einfacher oder komplexer Problemstellungen auf die Probe zu stellen, mit oder ohne Code Review und mit oder ohne den Vergleich der Leistungen mit anderen Besuchern der Seite.

Expand Down
3 changes: 2 additions & 1 deletion docs/CONTRIBUTING-el.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,11 +21,12 @@
2. Δεν χρειάζεται να γνωρίζετε Git: αν βρήκατε κάτι ενδιαφέρον που *δεν βρίσκεται ήδη σε αυτό το αποθετήριο*, παρακαλώ ανοίξτε ένα [Issue](https://github.com/EbookFoundation/free-programming-books/issues) με τις προτάσεις σας για συνδέσμους.
- Αν γνωρίζετε Git, παρακαλούμε να κάνετε Fork αυτό το αποθετήριο και να στέλνετε Pull Requests (PR).

3. Έχουμε 5 τύπους λιστών. Επιλέξτε την κατάλληλη:
3. Έχουμε 6 τύπους λιστών. Επιλέξτε την κατάλληλη:

- *Βιβλία* : PDF, HTML, ePub, ένας ιστότοπος που βασίζεται στο gitbook.io, ένα αποθετήριο Git, κλπ.
- *Μαθήματα* : Ένα μάθημα είναι εκπαιδευτικό υλικό που δεν είναι βιβλίο. [Αυτό είναι ένα μάθημα](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
- *Διαδραστικά σεμινάρια* : Μια διαδραστική ιστοσελίδα που επιτρέπει στον χρήστη να γράψει κώδικα ή εντολές και αξιολογεί τα αποτελέσματα (με το "αξιολογεί" δεν εννοούμε "βαθμολογεί"). π.χ. [Try Haskell](http://tryhaskell.org), [Try GitHub](http://try.github.io).
- *Playgrounds* : are online and interactive websites, games or desktop software for learning programming. Write, compile (or run), and share code snippets. Playgrounds often allow you to fork and get your hands dirty by playing with code.
- *Podcasts και Screencasts*: Podcasts και screencasts.
- *Προβλήματα και Ανταγωνιστικός Προγραμματισμός*: Ένας ιστότοπος ή ένα λογισμικό που σου επιτρέπει να αξιολογήσεις τις προγραμματιστικές σου ικανότητες λύνοντας απλά ή περίπλοκα προβλήματα, με ή χωρίς επιθεώρηση του κώδικα, συγκρίνοντας ή όχι τα αποτελέσματα με άλλους χρήστες.

Expand Down
3 changes: 2 additions & 1 deletion docs/CONTRIBUTING-es.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,11 +21,12 @@ Al contribuir, acepta respetar el [Código de Conducta][coc] ([traducciones / ot
2. No es necesario conocer Git: si encontró algo de interés que *no esté ya en este repositorio*, tenga el gusto de abrir una [Issue][issues] con su propuesta de enlaces.
- Si ya maneja Git, haga un Fork del repositorio y envíe su contribución mediante Pull Request (PR).

3. Dispone de 5 categorías. Seleccione aquel listado que crea conveniente según:
3. Dispone de 6 categorías. Seleccione aquel listado que crea conveniente según:

- *Libros* : PDF, HTML, ePub, un recurso alojado en gitbook.io, un repositorio Git, etc.
- *Cursos* : Un curso es aquel material de aprendizaje que no es un libro. [Esto es un curso](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
- *Tutoriales interactivos* : Un sitio web se considera interactivo si permite al usuario escribir código o comandos y evaluar su resultado ("evaluar" no significa "obtener una calificación"). Por ejemplo: [Pruebe Haskell](http://tryhaskell.org), [Pruebe GitHub](http://try.github.io).
- *Playgrounds* : se tratan de sitios en línea interactivos, juegos o software de escritorio cuyo fin es el de aprender programación. Permiten escribir, compiar (o ejecutar), y compartir partes de código fuente. A menudo, ofrecen la posibilidad de hacer bifurcaciones y ensuciarse las manos jugando con el código generado hasta dicho instante.
- *Podcasts y Screencasts* : Son aquellas retransmisiones grabadas ya sea en audio y/o en vídeo, respectivamente.
- *Conjuntos de problemas & Programación competitiva* : Se trata de un sitio web o software que le permita evaluar sus habilidades de programación resolviendo problemas simples o complejos, con o sin revisión de código, con o sin comparar los resultados con otros usuarios.

Expand Down
3 changes: 2 additions & 1 deletion docs/CONTRIBUTING-fa_IR.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,12 @@
2. نیاز نیست گیت بلد باشید: اگر چیز جذابی پیدا کردید که *در این مخزن وجود ندارد*، یک [Issue](https://github.com/EbookFoundation/free-programming-books/issues) با نوشتن لینک‌ها درست کنید.
* اگر Git را می شناسید، لطفاً مخزن را Fork کنید و درخواست های کششی (PR) ارسال کنید.

3. ما پنج نوع فهرست داریم. فهرست درست را انتخاب کنید:
3. ما شش نوع فهرست داریم. فهرست درست را انتخاب کنید:

* *کتاب‌ها* : PDF، HTML، ePub، سایت بر اساس gitbook.io، یک مخزن گیت و غیره.
* *دوره‌ها* : دوره محتوایی آموزشی است که کتاب نیست. مثلا [این یک دوره است](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
* *آموزش‌های تعاملی* : وبسایتی تعاملی که به کاربر اجازه‌ی تایپ کد یا دستور می‌دهد و نتیجه را ارزیابی می‌کند (منظور ما از "ارزیابی"، "نمره‌دهی" نیست). مثلا: [Try Haskell](http://tryhaskell.org), [Try GitHub](http://try.github.io).
- *Playgrounds* : are online and interactive websites, games or desktop software for learning programming. Write, compile (or run), and share code snippets. Playgrounds often allow you to fork and get your hands dirty by playing with code.
* *پادکست‌ها و اسکرین‌کست‌ها*
* *مجموعه مشکلات و برنامه‌نویسی رقابتی* : وبسایت یا نرم‌افزاری که به شما امکان بررسی مهارت‌های برنامه‌نویسی را با کمک حل مشکلات ساده یا پیچیده، با یا بدون بررسی کد، با یا بدون مقایسه‌ی نتایج با کاربران دیگر می‌دهد.

Expand Down
3 changes: 2 additions & 1 deletion docs/CONTRIBUTING-fil.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,12 @@ Sa pamamagitan ng pag-aambag sumasang-ayon kang igalang ang [Code of Conduct](CO
2. Hindi mo kailangang malaman ang Git: kung nakakita ka ng isang bagay na interesado na *wala pa sa repo na ito*, mangyaring magbukas ng [Issue](https://github.com/EbookFoundation/free-programming-books/issues) kasama ang iyong mga proposisyon ng link.
- Kung alam mo ang Git, mangyaring Fork ang repo at magpadala ng mga Pull Request (PR).

3. Mayroon kaming 5 uri ng mga listahan. Piliin ang tama:
3. Mayroon kaming 6 uri ng mga listahan. Piliin ang tama:

- *Mga libro* : PDF, HTML, ePub, isang site na nakabatay sa gitbook.io, a Git repo, etc.
- *Kurso* : Ang kurso ay isang materyal sa pag-aaral na hindi isang libro. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
- *Mga Interactive na Tutorial* : Isang interactive na website na nagbibigay-daan sa user na mag-type ng code o command at suriin ang resulta (sa pamamagitan ng "suriin" hindi namin ibig sabihin ay "grado"). e.g.: [Try Haskell](http://tryhaskell.org), [Try GitHub](http://try.github.io).
- *Playgrounds* : are online and interactive websites, games or desktop software for learning programming. Write, compile (or run), and share code snippets. Playgrounds often allow you to fork and get your hands dirty by playing with code.
- *Mga Podcast at Screencast* : Mga podcast at screencast.
- *Mga Set ng Problema at Kompetisyon sa Programming* : Isang website o software na nagbibigay-daan sa iyong tasahin ang iyong mga kasanayan sa programming sa pamamagitan ng paglutas ng mga simple o kumplikadong problema, mayroon man o walang code review, mayroon man o walang paghahambing ng mga resulta sa ibang mga user.

Expand Down
3 changes: 2 additions & 1 deletion docs/CONTRIBUTING-fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,12 @@ En contribuant, vous acceptez de respecter le [Code de Contrat](CODE_OF_CONDUCT-
2. Vous n'êtes pas obligé de connaître Git : si vous avez trouvé quelque chose d'intéressant qui n'est *pas déjà dans ce repositoire*, veuillez ouvrir un [Problème](https://github.com/EbookFoundation/free-programming-books/issues) avec vos propositions de liens.
- Si vous savez Git, Forkez le repo et envoyez vos Pull Requests (PR).

3. Nous avons 5 types de listes. Choisissez le bon:
3. Nous avons 6 types de listes. Choisissez le bon:

- *Livres* : PDF, HTML, ePub, un site basé sur gitlivre.io, un repositoire Git, etc.
- *Cours* : Un cours est un matériel d'apprentissage qui n'est pas un livre. [Ceci est un cours](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
- *Tutoriels interactifs* : Un site Web interactif qui permet à l'utilisateur de saisir du code ou des commandes et d'évaluer le résultat (par "évaluer" nous ne voulons pas dire "noter"). par exemple : [Essayez Haskell](http://tryhaskell.org), [Essayez GitHub](http://try.github.io).
- *Les terrains de jeux* : Ce sont des sites Web en ligne et interactifs, des jeux ou des logiciels de bureau pour l'apprentissage de la programmation. Écrivez, compilez (ou exécutez) et partagez des morceaux de code. Les terrains de jeux vous permettent souvent de forker et de vous salir les mains en jouant avec du code.
- *Podcasts et Screencasts* : Podcasts et screencasts.
- *Ensembles de Problèmes et Programmation Compétitive* : Un site Web ou un logiciel qui vous permet d'évaluer vos compétences en programmation en résolvant des problèmes simples ou complexes, avec ou sans revue de code, avec ou sans comparaison des résultats avec d'autres utilisateurs.

Expand Down
3 changes: 2 additions & 1 deletion docs/CONTRIBUTING-id.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,11 +21,12 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU
2. Anda tidak harus terbiasa dengan Git: Jika Anda telah menemukan sesuatu yang menarik *yang belum ada di salah satu daftar*, silakan buka [Masalah](https://github.com/EbookFoundation/free-programming-books/issues) dengan tautan yang Anda sarankan.
- Jika Anda sudah familiar dengan Git, fork repositori dan kirim Pull Request (PR).

3. Kami menyimpan 5 jenis daftar. Pastikan untuk memilih yang tepat:
3. Kami menyimpan 6 jenis daftar. Pastikan untuk memilih yang tepat:

- *Buku*: PDF, HTML, ePub, halaman berdasarkan gitbook.io, repo Git, dll.
- *Kursus*: Kursus menggambarkan materi pembelajaran yang tidak ada dalam bentuk buku. [Ini adalah kursus](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
- *Tutorial interaktif*: Situs web interaktif yang memungkinkan pengguna memasukkan kode sumber perintah dan mengevaluasi hasilnya (dengan "mengevaluasi" kami tidak bermaksud "menilai"). misalnya: [Coba Haskell](http://tryhaskell.org), [Coba GitHub](http://try.github.io).
- *Playgrounds* : are online and interactive websites, games or desktop software for learning programming. Write, compile (or run), and share code snippets. Playgrounds often allow you to fork and get your hands dirty by playing with code.
- *Podcast dan Screencasts*: Podcast dan Screencasts.
- *Kumpulan Masalah & Pemrograman Kompetitif*: Situs web atau perangkat lunak yang memberi Anda kesempatan untuk menguji keterampilan pemrograman Anda dengan memecahkan masalah sederhana atau kompleks, dengan atau tanpa tinjauan kode dan dengan atau tanpa membandingkan kinerja dengan orang lain Pengunjung situs.

Expand Down
3 changes: 2 additions & 1 deletion docs/CONTRIBUTING-it.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,12 @@ I collaboratori accettano di rispettare il [Codice di Comportamento](CODE_OF_CON
2. Non devi conoscere Git: se trovi qualcosa di interessante che che non è *ancora in questa repo*, apri un [Issue](https://github.com/EbookFoundation/free-programming-books/issues) con il link della risorsa.
- Se conosci Git, forka questa repository e crea una Pull Request (PR).

3. Abbiamo 5 tipi di liste. Scegli quella giusta:
3. Abbiamo 6 tipi di liste. Scegli quella giusta:

- *Libri* : PDF, HTML, ePub, gitbook.io, una Git repo, etc.
- *Corsi* : Un corso è del materiale gratuito che non è un libro. [Questo è un corso](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
- *Tutorial Interattivi* : Un sito interattivo permette all'utente di scrivere codice o comandi e analizzarne il risultato. esempi: [Try Haskell](http://tryhaskell.org), [Try GitHub](http://try.github.io).
- *Playgrounds* : Sono siti, giochi o applicazioni online ed interattive per imparare a programmare. Scrivi, compila (o esegui) e condividi codice. I playgrounds spesso ti permettono di forkare una repository e sporcarti le mani "giocando" con il codice.
- *Podcasts e Screencasts* : Podcasts and screencasts.
- *Set di problemi & Programmazione competitiva* : Un sito o software che ti permette di valutare le tue skills da programmatore risolvendo problemi semplici o complessi, con o senza la revisione del codice, con o senza la comparazione del risultato con gli altri utenti.

Expand Down
3 changes: 2 additions & 1 deletion docs/CONTRIBUTING-ko.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,12 @@
2. Git을 알 필요는 없습니다: 만약 당신이 조건에 부합하면서 *이미 등재되지 않은* 바로가기를 발견한다면, 새로운 바로가기와 함께 새로운 [이슈](https://github.com/EbookFoundation/free-programming-books/issues)를 열 수 있습니다.
- 만약 깃 사용법을 알고 있다면, 해당 리포지토리를 Fork 하며 Pull Request (PR)를 보내주세요.

3. 저희는 다섯 가지의 리스트를 제공하고 있습니다. 올바른 것을 선택해 주세요:
3. 저희는 가지의 리스트를 제공하고 있습니다. 올바른 것을 선택해 주세요:

- ** : PDF, HTML, ePub, gitbook.io 기반 웹사이트, 깃 리포지토리, 등.
- *강좌* : 여기서 강좌는 책이 아닌 교육 도구를 칭합니다. [강좌 예시](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
- *상호작용을 할 수 있는 강좌* : 사용자가 코드를 입력하거나 명령어를 입력하여 평가을 받을 수 있는 웹사이트를 칭합니다(평가는 채점이 아닙니다). 예시: [Try Haskell](http://tryhaskell.org), [Try GitHub](http://try.github.io).
- *Playgrounds* : are online and interactive websites, games or desktop software for learning programming. Write, compile (or run), and share code snippets. Playgrounds often allow you to fork and get your hands dirty by playing with code.
- *팟캐스트와 화면 녹화*
- *문제집 & 경쟁 하며 배우는 프로그래밍* : 문제를 풂으로서 프로그래밍 실력을 향상시키는데 도움을 주는 소프트웨어 또는 웹사이트를 칭합니다. 해당 소프트웨어 또는 웹사이트는 동료가 주체가 되는 코드 검토를 포함 할 수 있습니다.

Expand Down
3 changes: 2 additions & 1 deletion docs/CONTRIBUTING-pt_BR.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,12 @@ Ao contribuir você concorda em respeitar o [Código de Conduta](CODE_OF_CONDUCT
2. Não é necessário saber Git: se você encontrou algo interessante que *não está presente neste repositório*, por favor abra uma [Issue](https://github.com/EbookFoundation/free-programming-books/issues) com todas as propostas de _links_.
- Se você sabe Git, faça um _Fork_ do repositório e mande um _Pull Request (PR)_.

3. Possuimos 5 tipos de listas. Escolha a mais adequada:
3. Possuimos 6 tipos de listas. Escolha a mais adequada:

- *Livros*: PDF, HTML, ePub, sites baseados no gitbook.io, um repositório Git, etc.
- *Cursos*: Um curso é um material didático que não é um livro. [Isso é um curso](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
- *Tutoriais Interativos*: Um site interativo que permite ao usuário digitar código ou comandos e computa o resulta (por "computar" não queremos dizer "avaliar"). Por exemplo: [Try Haskell](http://tryhaskell.org), [Try GitHub](http://try.github.io).
- *Playgrounds* : are online and interactive websites, games or desktop software for learning programming. Write, compile (or run), and share code snippets. Playgrounds often allow you to fork and get your hands dirty by playing with code.
- *Podcasts e Screencasts* : Podcasts e screencasts.
- *Conjuntos de Problemas e Programação Competitiva* : Um site ou software que permite avaliar suas habilidades de programação através da resolução de problemas simples ou complexos, com ou sem revisão de código, com ou sem comparação de resultados com outros usuários.

Expand Down
Loading

0 comments on commit 97022b7

Please sign in to comment.