Skip to content

Commit 9e13569

Browse files
committed
docs(CONTRIBUTING): Apply EbookFoundation#6878 to the rest of the CONTRIBUTING files
1 parent f0d4c43 commit 9e13569

14 files changed

+126
-14
lines changed

Diff for: docs/CONTRIBUTING-de.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ Durch Deine Mitwirkung verpflichtest Du Dich, dem [Verhaltenskodex](CODE_OF_COND
3535

3636
- Stell sicher, dass ein Buch wirklich kostenlos ist. Vergewissere Dich noch einmal, falls nötig. Es hilft den Administratoren, wenn Du in Deinem PR beschreibst, warum Du der Ansicht bist, dass das jeweilige Buch kostenlos ist.
3737
- Wir nehmen keine Dateien auf, die auf Google Drive, Dropbox, Mega, Scribd, Issuu oder einer vergleichbaren Upload-Plattform liegen.
38-
- Füge die Links in alphabetischer Reihenfolge ein. Wenn Du einen fehlerhaft eingefügten Link findest, korrigiere bitte die Reihenfolge und öffne eine PR.
38+
- Füge die Links in alphabetischer Reihenfolge ein., as described [below](#alphabetical-order).
3939
- Wähle immer den Link der maßgeblichen Quelle aus (das heißt, dass die Website des Autors besser ist als die eines Redakteurs, welche wiederum besser wäre als die einer Drittanbieterseite)
4040
- Keine File Hosting Plattformen (inklusive Links zu Dropbox, Google Drive u.ä.)
4141
- Ein `https` Link sollte einem `http` Link immer vorgezogen werden -- solange sie auf dieselbe Domain und denselben Inhalt verweisen.
@@ -133,6 +133,13 @@ Beispiel:
133133
RICHTIG: * [Wird bald ein tolles Buch sein](http://example.com/book2.html) - John Doe (HTML) (:construction: *in Bearbeitung*)
134134
```
135135
136+
### Alphabetical order
137+
138+
- When there are multiple titles beginning with the same letter order them by the second, and so on. For example: `aa` comes before `ab`.
139+
- `one two` comes before `onetwo`
140+
141+
If you see a misplaced link, check the linter error message to know which lines should be swapped.
142+
136143
137144
### Hinweise
138145
@@ -148,6 +155,7 @@ Unsere Listen enthalten einen minimalen Satz an Metadaten: Titel, URLs, Autoren,
148155
149156
- Keine erfundenen Titel. Wir versuchen, die Titel den Inhalten selbst zu entnehmen; Mitwirkende werden dazu ermahnt, sich keine Titel auszudenken oder redaktionell zu nutzen, falls dies vermieden werden kann. Eine Ausnahme bilden ältere Werke; wenn sie vor allem von historischem Interesse sind, kann das Hinzufügen einer Jahreszahl in Klammern den Nutzern helfen zu bestimmen, ob die Inhalte für sie nützlich sind.
150157
- Keine Titel, die NUR GROßBUCHSTABEN ENTHALTEN. Titelkapitalisierung ist normalerweise angemessen, aber im Zweifel nutze einfach die Formatierung der Originalquelle.
158+
- No emojis.
151159
152160
153161
##### URLs

Diff for: docs/CONTRIBUTING-el.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@
3939

4040
- σιγουρευτείτε ότι το βιβλίο είναι δωρεάν. Επανελέγξτε αν χρειάζεται. Βοηθάει τους διαχειριστές αν σχολιάζετε στο PR τον λόγο που πιστεύετε ότι αυτό το βιβλίο είναι δωρεάν.
4141
- δεν δεχόμαστε αρχεία που φιλοξενούνται στα Google Drive, Dropbox, Mega, Scribd, Issuu και άλλες παρόμοιες πλατφόρμες ανεβάσματος αρχείων
42-
- εισάγετε τους συνδέσμους σας σε αλφαβητική σειρά. Αν βάλετε έναν σύνδεσμο σε λάθος θέση, παρακαλούμε διορθώστε το και υποβάλλετε νέο PR
42+
- εισάγετε τους συνδέσμους σας σε αλφαβητική σειρά, as described [below](#alphabetical-order).
4343
- χρησιμοποιήστε έναν σύνδεσμο με την πιο έγκυρη πηγή (που σημαίνει ότι η ιστοσελίδα του συγγραφέα είναι καλύτερη από τη σελίδα του εκδότη, η οποία είναι καλύτερη από μια τρίτη ιστοσελίδα)
4444
- δεν επιτρέπονται υπηρεσίες φιλοξενίας αρχείων (αυτό περιλαμβάνει (αλλά δεν περιορίζεται στους) συνδέσμους από Dropbox και Google Drive)
4545
- να προτιμάτε ένα σύνδεσμο `https` από έναν `http` -- αρκεί να είναι στο ίδιο domain και να εξυπηρετούν τον ίδιο περιεχόμενο
@@ -145,6 +145,13 @@
145145
ΚΑΛΟ: * [Ένα Ενδιαφέρον Way-backed Βιβλίο](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: αρχειοθετημένο)*
146146
```
147147
148+
### Alphabetical order
149+
150+
- When there are multiple titles beginning with the same letter order them by the second, and so on. For example: `aa` comes before `ab`.
151+
- `one two` comes before `onetwo`
152+
153+
If you see a misplaced link, check the linter error message to know which lines should be swapped.
154+
148155
149156
<!----><a id="notes"></a>
150157
### Σημειώσεις
@@ -161,6 +168,7 @@
161168
162169
- Όχι δικοί σας τίτλοι. Προσπαθούμε να πάρουμε τους τίτλους από τις ίδιες τις πηγές· οι συνεισφέροντες επιβάλλεται να μη εφευρίσκουν τίτλους ή να τους χρησιμοποιούν εκδοτικά αν αυτό μπορεί να αποφευχθεί. Μια εξαίρεση είναι για παλαιότερα έργα· αν είναι παρουσιάζουν κυρίως ιστορικό ενδιαφέρον, το έτος στην παρένθεση προσαρτημένο με τον τίτλο βοηθά τους χρήστες να γνωρίζουν αν τους ενδιαφέρει.
163170
- Όχι τίτλοι αποκλειστικά σε ΚΕΦΑΛΑΙΑ. Η συνήθης κεφαλαιοποίηση τίτλων (title case) είναι κατάλληλη, αλλά όταν υπάρχουν αμφιβολίες χρησιμοποιήστε την κεφαλαιοποίηση της πηγής
171+
- No emojis.
164172
165173
166174
#### URLs

Diff for: docs/CONTRIBUTING-es.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Al contribuir, acepta respetar el [Código de Conducta][coc] ([traducciones / ot
3939

4040
- Revise si el libro es gratuito. Hágalo las veces que sean necesarias. Ayude a los administradores comentando en las PR por qué cree que el libro se ofrece gratis o es valioso.
4141
- No se aceptan ficheros alojados en Google Drive, Dropbox, Mega, Scribd, Issuu u otras plataformas de almacenamiento y/o descarga similares.
42-
- Inserte los enlaces ordenados alfabéticamente. Si se encuentra por casualidad con un enlace fuera de sitio, por favor ordénelo y envíe la correspondiente PR para poder arreglarlo.
42+
- Inserte los enlaces ordenados alfabéticamente, as described [below](#alphabetical-order).
4343
- Use el enlace que apunte a la fuente más fidedigna. Esto es, el sitio web del autor es mejor que el del editor y éste a su vez mejor que uno de terceros.
4444
- No use servicios de almacenamiento en la nube. Esto incluye, aunque sin limitar, enlaces a Dropbox y Google Drive.
4545
- Es siempre preferible el uso de enlaces con protocolo `https` en vez de `http` si ambos se refieren al mismo dominio y sirven el mismo contenido.
@@ -145,6 +145,13 @@ Ejemplo:
145145
CORRECTO : * [Un recurso recuperado a partir de su línea de tiempo](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archivado)*
146146
```
147147
148+
### Alphabetical order
149+
150+
- When there are multiple titles beginning with the same letter order them by the second, and so on. For example: `aa` comes before `ab`.
151+
- `one two` comes before `onetwo`
152+
153+
If you see a misplaced link, check the linter error message to know which lines should be swapped.
154+
148155
149156
<!----><a id="notes"></a>
150157
### Anotaciones
@@ -163,6 +170,7 @@ Nuestros listados proporcionan un conjunto mínimo de metadatos: títulos, URL,
163170
164171
- Sin títulos inventados: Intentamos tomar el texto de los propios recursos; se advierte a los colaboradores que, si puede evitarse, no inventen títulos ni los utilicen editorialmente. Una excepción es para obras más antiguas: si son principalmente de interés histórico, un año entre paréntesis adjunto al título ayuda a los usuarios a saber si estos son de interés.
165172
- Sin títulos TODO EN MAYÚSCULAS: Por lo general, es apropiado tener cada primera letra de palabra en mayúsculas, pero en caso de duda, use siempre el estilo tal y como viene en la fuente original.
173+
- No emojis.
166174
167175
168176
<!----><a id="urls"></a>

Diff for: docs/CONTRIBUTING-fa_IR.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@
3838

3939
* مطمئن شوید که یک کتاب رایگان است. اگر لازم بود، دوباره هم بررسی کنید. اگر درباره‌ی علت این که فکر می‌کنید کتاب رایگان است در پول‌ریکوئست (PR)، کامنت بگذارید، به ادمین‌ها کمک کرده‌اید.
4040
* ما فایل‌هایی را قبول نمی‌کنیم که روی گوگل‌درایو، دراپ‌باکس، مگا، اسکریبد، ایسیو یا پلتفرم‌های آپلود فایل مشابه قرار دارند
41-
* لینک‌های خود را به ترتیب الفبایی وارد کنید. اگر لینکی را خارج از ترتیب درست دیدید، لطفا مرتیش کنید و یک پی‌آر ثبت کنید
41+
* لینک‌های خود را به ترتیب الفبایی وارد کنید, as described [below](#alphabetical-order).
4242
* از لینک معتبرترین منبع استفاده کنید (این یعنی وبسایت نویسنده بهتر از وبسایت ویراستار و وبسایت ویراستار بهتر از وبسایت سوم شخص است)
4343
* از سرویس‌های اشتراک‌گذاری فایل استفاده نکنید (این سرویس‌ها شامل (و نه محدود به) لینک‌های دراپ‌باکس و گوگل‌درایو است)
4444
* همیشه یک لینک `https` به یک لینک `http` ترجیح داده می‌شود -- تا وقتی که هر دو لینک دامنه‌ی یکسانی داشته باشند و محتوای یکسانی نمایش دهند.
@@ -138,6 +138,14 @@
138138
```
139139
140140
141+
### Alphabetical order
142+
143+
- When there are multiple titles beginning with the same letter order them by the second, and so on. For example: `aa` comes before `ab`.
144+
- `one two` comes before `onetwo`
145+
146+
If you see a misplaced link, check the linter error message to know which lines should be swapped.
147+
148+
141149
### خودکارسازی
142150
143151
* قوانین فرمت‌بندی از طریق [GitHub Actions](https://docs.github.com/en/actions) با استفاده از [fpb-lint](https://github.com/vhf/free-programming-books-lint) بررسی می‌شوند ([`.github/workflows/fpb-lint.yml`](../.github/workflows/fpb-lint.yml) را ببینید)

Diff for: docs/CONTRIBUTING-fil.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Sa pamamagitan ng pag-aambag sumasang-ayon kang igalang ang [Code of Conduct](CO
3636

3737
- siguraduhin na ang isang libro ay libre. I-double check kung kinakailangan. Nakakatulong ito sa mga admin kung magkomento ka sa PR kung bakit sa tingin mo ay libre ang libro.
3838
- hindi kami tumatanggap ng mga file na naka-host sa Google Drive, Dropbox, Mega, Scribd, Issuu at iba pang katulad na mga platform sa pag-upload ng file
39-
- ipasok ang iyong mga link sa alphabetical order. Kung makakita ka ng maling lugar na link, mangyaring muling ayusin ito at magsumite ng PR
39+
- ipasok ang iyong mga link sa alphabetical order, as described [below](#alphabetical-order).
4040
- gamitin ang link na may pinakamakapangyarihang pinagmulan (ibig sabihin ang website ng may-akda ay mas mahusay kaysa sa website ng editor, na mas mahusay kaysa sa isang third party na website)
4141
- walang mga serbisyo sa pagho-host ng file (kabilang dito ang (ngunit hindi limitado sa) mga link ng Dropbox at Google Drive)
4242
- palaging mas gusto ang isang link na `https` kaysa sa isang link na `http` -- hangga't sila ay nasa parehong domain at naghahatid ng parehong nilalaman
@@ -142,6 +142,13 @@ Halimbawa:
142142
GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
143143
```
144144
145+
### Alphabetical order
146+
147+
- When there are multiple titles beginning with the same letter order them by the second, and so on. For example: `aa` comes before `ab`.
148+
- `one two` comes before `onetwo`
149+
150+
If you see a misplaced link, check the linter error message to know which lines should be swapped.
151+
145152
146153
### Mga Tala
147154
@@ -157,6 +164,7 @@ Nagbibigay ang aming mga listahan ng kaunting hanay ng metadata: mga pamagat, UR
157164
158165
- Walang naimbentong pamagat. Sinusubukan naming kumuha ng mga pamagat mula sa mga mapagkukunan mismo; ang mga nag-aambag ay pinapayuhan na huwag mag-imbento ng mga pamagat o gamitin ang mga ito sa editoryal kung ito ay maiiwasan. Ang isang pagbubukod ay para sa mas lumang mga gawa; kung pangunahin ang mga ito sa makasaysayang interes, ang isang taon sa panaklong na nakadugtong sa pamagat ay tumutulong sa mga user na malaman kung sila ay interesado.
159166
- Walang pamagat ng ALLCAPS. Kadalasan ay angkop ang title case, ngunit kapag may pagdududa, gamitin ang capitalization mula sa source
167+
- No emojis.
160168
161169
162170
##### URLs

Diff for: docs/CONTRIBUTING-fr.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ En contribuant, vous acceptez de respecter le [Code de Contrat](CODE_OF_CONDUCT-
3535

3636
- assurez-vous qu'un livre est gratuit. Vérifiez si nécessaire. Cela aide les administrateurs si vous commentez dans le PR pourquoi vous pensez que le livre est gratuit.
3737
- nous n'acceptons pas les fichiers hébergés sur Google Drive, Dropbox, Mega, Scribd, Issuu et autres plateformes de téléchargement de fichiers similaires.
38-
- insérez vos liens par ordre alphabétique. Si vous voyez un lien égaré, veuillez le réorganiser et soumettre un PR
38+
- insérez vos liens par ordre alphabétique, as described [below](#alphabetical-order).
3939
- utiliser le lien avec la source la plus autoritaire (c'est-à-dire que le site de l'auteur est meilleur que le site de l'éditeur, qui est meilleur qu'un site tiers)
4040
- pas de services d'hébergement de fichiers (cela inclut (mais n'est pas limité à) les liens Dropbox et Google Drive)
4141
- préférez toujours un lien `https` à un `http` - tant qu'ils sont sur le même domaine et servent le même contenu
@@ -133,6 +133,13 @@ Exemple:
133133
BIEN : * [Sera bientôt un livre génial](http://exemple.com/livre2.html) - John Doe (HTML) (:construction: *in process*)
134134
```
135135
136+
### Alphabetical order
137+
138+
- When there are multiple titles beginning with the same letter order them by the second, and so on. For example: `aa` comes before `ab`.
139+
- `one two` comes before `onetwo`
140+
141+
If you see a misplaced link, check the linter error message to know which lines should be swapped.
142+
136143
137144
### Remarques
138145
@@ -148,6 +155,7 @@ Nos listes fournissent un ensemble minimal de métadonnées : titres, URL, créa
148155
149156
- Pas de titres inventés. Nous essayons de prendre les titres des ressources elles-mêmes ; les contributeurs sont avertis de ne pas inventer de titres ou de ne pas les utiliser éditorialement si cela peut être évité. Une exception est pour les œuvres plus anciennes; s'ils présentent principalement un intérêt historique, une année entre parenthèses ajoutée au titre aide les utilisateurs à savoir s'ils présentent un intérêt.
150157
- Pas de titres TOUTES EN MAJUSCULES. Habituellement, la casse du titre est appropriée, mais en cas de doute, utilisez la majuscule de la source
158+
- No emojis.
151159
152160
153161
##### URLs

Diff for: docs/CONTRIBUTING-id.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU
3939

4040
- Pastikan sebuah buku benar-benar gratis. Periksa kembali jika perlu. Ini membantu administrator jika Anda menjelaskan dalam PR Anda mengapa menurut Anda buku tersebut gratis.
4141
- Kami tidak merekam file yang ada di Google Drive, Dropbox, Mega, Scribd, Issuu atau platform unggah file lainnya sebanding.
42-
- Masukkan tautan dalam urutan abjad. Jika Anda menemukan tautan yang salah dimasukkan, harap perbaiki pesanan dan kirimkan PR.
42+
- Masukkan tautan dalam urutan abjad, as described [below](#alphabetical-order).
4343
- Selalu pilih tautan dari sumber otoritatif (yaitu, situs web penulis lebih baik daripada situs web editor, yang pada gilirannya akan lebih baik daripada situs web pihak ketiga)
4444
- tidak ada platform hosting file (termasuk tautan ke Dropbox, Google Drive, dll.).
4545
- Tautan `https` harus selalu lebih disukai daripada tautan `http` - selama tautan tersebut mengarah ke domain dan konten yang sama.
@@ -139,6 +139,13 @@ Contoh:
139139
BAIK : * [Akan Segera Menjadi Buku yang Luar Biasa](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
140140
```
141141
142+
### Alphabetical order
143+
144+
- When there are multiple titles beginning with the same letter order them by the second, and so on. For example: `aa` comes before `ab`.
145+
- `one two` comes before `onetwo`
146+
147+
If you see a misplaced link, check the linter error message to know which lines should be swapped.
148+
142149
143150
<!----><a id="notes"></a>
144151
### Catatan
@@ -156,6 +163,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform
156163
157164
- Tidak ada judul yang diciptakan. Kami mencoba mengambil judul dari sumber itu sendiri; kontributor diperingatkan untuk tidak membuat judul atau menggunakannya secara editorial jika hal ini dapat dihindari. Pengecualian adalah untuk karya yang lebih tua; jika mereka terutama memiliki minat historis, satu tahun dalam tanda kurung yang ditambahkan ke judul membantu pengguna mengetahui apakah mereka menarik.
158165
- Tidak ada judul SEMUANYA KAPITAL. Biasanya judul kasus sesuai, tetapi jika ragu gunakan kapitalisasi dari sumbernya.
166+
- No emojis.
159167
160168
161169
##### URLs

Diff for: docs/CONTRIBUTING-it.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ I collaboratori accettano di rispettare il [Codice di Comportamento](CODE_OF_CON
3636

3737
- assicurati che il libro sia gratuito. Controlla più volte se necessario. Commentare nella PR il perché pensi che il libro sia gratuito aiuta gli admin.
3838
- non accettiamo file hostati su Google Drive, Dropbox, Mega, Scribd, Issuu e altre piattaforme simili per l'upload dei file
39-
- inserisci i link ordinandoli alfabeticamente. Se sbagli la posizione di un link, riordinalo e invia la PR
39+
- inserisci i link ordinandoli alfabeticamente, come descritto [sotto](#alphabetical-order).
4040
- usa il link più "autorevole" per segnalare la risorsa (significa che il sito web dell'autore è migliore del sito web dell'editore, che è migliore di un sito web di terze parti)
4141
- nessun servizio di file hosting (questo include (ma non è limitato a) link di Dropbox e Google Drive)
4242
- preferisci sempre un link `https` rispetto ad un `http` -- purché si trovino sullo stesso dominio e contengano lo stesso contenuto
@@ -142,6 +142,13 @@ Esempi:
142142
CORRETTO : * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
143143
```
144144
145+
### Ordinamento alfabetico
146+
147+
- Quando ci sono più titoli che iniziano con la stessa lettera devi ordinarli in base alla seconda, e così via. Per esempio: `aa` viene prima di `ab`.
148+
- `one two` viene prima di `onetwo`
149+
150+
Se vedi un link messo male, controlla gli errori dati dal linter per scoprire quali linee devi scambiare.
151+
145152
146153
### Note
147154
@@ -157,6 +164,7 @@ I nostri elenchi forniscono un set minimo di metadati: titoli, URLs, autori, pia
157164
158165
- Non inventiamo i titoli. Cerchiamo di prendere i titoli dalla risorsa originale; i contributori sono invitati a non inventare titoli o usarli editorialmente se questo può essere evitato. Un'eccezione è per i libri più vecchi; se sono principalmente di interesse storico, l'anno tra parentesi inserito nel titolo aiuta gli utenti a capire se sono interessati a quella risorsa.
159166
- Niente titoli completamente in MAIUSCOLO. Di solito il title case è appropriato, ma in caso di dubbio usa le maiuscole utilizzate nella fonte.
167+
- Niente emoji.
160168
161169
162170
##### URLs

0 commit comments

Comments
 (0)