Skip to content

Commit d3a6f5e

Browse files
authored
Merge branch 'master' into ja
2 parents 6c53b23 + 5c2c0b4 commit d3a6f5e

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

64 files changed

+4956
-189
lines changed

.travis.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@ language: node_js
22
node_js:
33
- 6
44
before_install:
5+
- gem install bundler -v 1.16.1
56
- rvm install 2.4.3
67
- npm install -g npm@5
78
install:

Gemfile.lock

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,17 @@ GEM
66
minitest (~> 5.1)
77
thread_safe (~> 0.3, >= 0.3.4)
88
tzinfo (~> 1.1)
9-
addressable (2.6.0)
10-
public_suffix (>= 2.0.2, < 4.0)
9+
addressable (2.7.0)
10+
public_suffix (>= 2.0.2, < 5.0)
1111
coffee-script (2.4.1)
1212
coffee-script-source
1313
execjs
1414
coffee-script-source (1.11.1)
1515
colorator (1.1.0)
16-
colorize (0.8.1)
1716
commonmarker (0.17.13)
1817
ruby-enum (~> 0.5)
1918
concurrent-ruby (1.1.5)
20-
dnsruby (1.61.2)
19+
dnsruby (1.61.3)
2120
addressable (~> 2.5)
2221
em-websocket (0.5.1)
2322
eventmachine (>= 0.12.9)
@@ -28,10 +27,10 @@ GEM
2827
execjs (2.7.0)
2928
faraday (0.15.4)
3029
multipart-post (>= 1.2, < 3)
31-
ffi (1.10.0)
30+
ffi (1.11.1)
3231
forwardable-extended (2.6.0)
3332
gemoji (3.0.1)
34-
github-pages (198)
33+
github-pages (200)
3534
activesupport (= 4.2.11.1)
3635
github-pages-health-check (= 1.16.1)
3736
jekyll (= 3.8.5)
@@ -48,7 +47,7 @@ GEM
4847
jekyll-readme-index (= 0.2.0)
4948
jekyll-redirect-from (= 0.14.0)
5049
jekyll-relative-links (= 0.6.0)
51-
jekyll-remote-theme (= 0.3.1)
50+
jekyll-remote-theme (= 0.4.0)
5251
jekyll-sass-converter (= 1.5.2)
5352
jekyll-seo-tag (= 2.5.0)
5453
jekyll-sitemap (= 1.2.0)
@@ -73,7 +72,7 @@ GEM
7372
listen (= 3.1.5)
7473
mercenary (~> 0.3)
7574
minima (= 2.5.0)
76-
nokogiri (>= 1.8.5, < 2.0)
75+
nokogiri (>= 1.10.4, < 2.0)
7776
rouge (= 2.2.1)
7877
terminal-table (~> 1.4)
7978
github-pages-health-check (1.16.1)
@@ -82,16 +81,15 @@ GEM
8281
octokit (~> 4.0)
8382
public_suffix (~> 3.0)
8483
typhoeus (~> 1.3)
85-
html-pipeline (2.11.0)
84+
html-pipeline (2.12.0)
8685
activesupport (>= 2)
8786
nokogiri (>= 1.4)
88-
html-proofer (3.10.2)
89-
activesupport (>= 4.2, < 6.0)
87+
html-proofer (3.12.2)
9088
addressable (~> 2.3)
91-
colorize (~> 0.8)
92-
mercenary (~> 0.3.2)
93-
nokogiri (~> 1.9)
89+
mercenary (~> 0.3)
90+
nokogiri (~> 1.10)
9491
parallel (~> 1.3)
92+
rainbow (~> 3.0)
9593
typhoeus (~> 1.3)
9694
yell (~> 2.0)
9795
http_parser.rb (0.6.0)
@@ -143,7 +141,8 @@ GEM
143141
jekyll (~> 3.3)
144142
jekyll-relative-links (0.6.0)
145143
jekyll (~> 3.3)
146-
jekyll-remote-theme (0.3.1)
144+
jekyll-remote-theme (0.4.0)
145+
addressable (~> 2.0)
147146
jekyll (~> 3.5)
148147
rubyzip (>= 1.2.1, < 3.0)
149148
jekyll-sass-converter (1.5.2)
@@ -214,24 +213,25 @@ GEM
214213
jekyll-feed (~> 0.9)
215214
jekyll-seo-tag (~> 2.1)
216215
minitest (5.11.3)
217-
multipart-post (2.0.0)
218-
nokogiri (1.10.3)
216+
multipart-post (2.1.1)
217+
nokogiri (1.10.4)
219218
mini_portile2 (~> 2.4.0)
220219
octokit (4.14.0)
221220
sawyer (~> 0.8.0, >= 0.5.3)
222221
parallel (1.17.0)
223222
pathutil (0.16.2)
224223
forwardable-extended (~> 2.6)
225-
public_suffix (3.0.3)
226-
rake (12.3.2)
224+
public_suffix (3.1.1)
225+
rainbow (3.0.0)
226+
rake (12.3.3)
227227
rb-fsevent (0.10.3)
228228
rb-inotify (0.10.0)
229229
ffi (~> 1.0)
230230
rouge (2.2.1)
231231
ruby-enum (0.7.2)
232232
i18n
233233
ruby_dep (1.5.0)
234-
rubyzip (1.2.2)
234+
rubyzip (1.2.4)
235235
safe_yaml (1.0.5)
236236
sass (3.7.4)
237237
sass-listen (~> 4.0.0)
@@ -248,8 +248,8 @@ GEM
248248
ethon (>= 0.9.0)
249249
tzinfo (1.2.5)
250250
thread_safe (~> 0.1)
251-
unicode-display_width (1.5.0)
252-
yell (2.1.0)
251+
unicode-display_width (1.6.0)
252+
yell (2.2.0)
253253

254254
PLATFORMS
255255
ruby

_articles/best-practices.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -172,6 +172,8 @@ You don't have to do everything yourself. Your project's community exists for a
172172

173173
If you're looking for others to pitch in, start by asking around.
174174

175+
One way to gain new contributors is to explicitly [label issues that are simple enough for beginners to tackle](https://help.github.com/en/articles/helping-new-contributors-find-your-project-with-labels). GitHub will then surface these issues in various places on the platform, increasing their visibility.
176+
175177
When you see new contributors making repeated contributions, recognize their work by offering more responsibility. Document how others can grow into leadership roles if they wish.
176178

177179
Encouraging others to [share ownership of the project](../building-community/#share-ownership-of-your-project) can greatly reduce your own workload, as @lmccart discovered on her project, [p5.js](https://github.com/processing/p5.js).
@@ -241,6 +243,8 @@ There are a [variety of tools available](https://github.com/showcases/tools-for-
241243
* [semantic-release](https://github.com/semantic-release/semantic-release) automates your releases
242244
* [mention-bot](https://github.com/facebook/mention-bot) mentions potential reviewers for pull requests
243245
* [Danger](https://github.com/danger/danger) helps automate code review
246+
* [no-response](https://github.com/probot/no-response) closes issues where the author hasn't responded to a request for more information
247+
* [dependabot-preview](https://github.com/marketplace/dependabot-preview) checks your dependency files every day for outdated requirements and opens individual pull requests for any it finds
244248

245249
For bug reports and other common contributions, GitHub has [Issue Templates and Pull Request Templates](https://github.com/blog/2111-issue-and-pull-request-templates), which you can create to streamline the communication you receive. @TalAter made a [Choose Your Own Adventure guide](https://www.talater.com/open-source-templates/#/) to help you write your issue and PR templates.
246250

_articles/building-community.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,7 @@ Start with your documentation:
3232

3333
* **Make it easy for someone to use your project.** [A friendly README](../starting-a-project/#writing-a-readme) and clear code examples will make it easier for anyone who lands on your project to get started.
3434
* **Clearly explain how to contribute**, using [your CONTRIBUTING file](../starting-a-project/#writing-your-contributing-guidelines) and keeping your issues up-to-date.
35+
* **Good first issues**: To help new contributors get started, consider explicitly [labeling issues that are simple enough for beginners to tackle](https://help.github.com/en/articles/helping-new-contributors-find-your-project-with-labels). GitHub will then surface these issues in various places on the platform, increasing useful contributions, and reducing friction from users tackling issues that are too hard for their level.
3536

3637
[GitHub's 2017 Open Source Survey](http://opensourcesurvey.org/2017/) showed incomplete or confusing documentation is the biggest problem for open source users. Good documentation invites people to interact with your project. Eventually, someone will open an issue or pull request. Use these interactions as opportunities to move them down the funnel.
3738

@@ -117,10 +118,10 @@ Any popular project will inevitably attract people who harm, rather than help, y
117118
Do your best to adopt a zero-tolerance policy towards these types of people. If left unchecked, negative people will make other people in your community uncomfortable. They may even leave.
118119

119120
<aside markdown="1" class="pquote">
120-
<img src="https://avatars.githubusercontent.com/karissa?s=180" class="pquote-avatar" alt="avatar">
121+
<img src="https://avatars.githubusercontent.com/okdistribute?s=180" class="pquote-avatar" alt="avatar">
121122
The truth is that having a supportive community is key. I'd never be able to do this work without the help of my colleagues, friendly internet strangers, and chatty IRC channels. (...) Don't settle for less. Don't settle for assholes.
122123
<p markdown="1" class="pquote-credit">
123-
@karissa, ["How to Run a FOSS Project"](https://okdistribute.xyz/post/okf-de)
124+
@okdistribute, ["How to Run a FOSS Project"](https://okdistribute.xyz/post/okf-de)
124125
</p>
125126
</aside>
126127

_articles/de/best-practices.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -179,6 +179,8 @@ Sie müssen nicht alles selbst machen. Die Gemeinschaft Ihres Projekts existiert
179179

180180
Wenn Sie auf der Suche nach Mitwirkenden sind, fragen Sie doch einfach mal herum.
181181

182+
Sie können auch [Issues, die für Anfänger einfach genug sind, explizit markieren (Englisch)](https://help.github.com/en/articles/helping-new-contributors-find-your-project-with-labels). GitHub weist auf solche Issues vermehrt hin, sodass beitragswillige Neulinge zu nützlicher Mitarbeit ermuntert werden.
183+
182184
Wenn Sie neue Mitwirkende bemerken, die wiederholt Beiträge leisten, erkennen Sie deren Arbeit an, indem Sie ihnen mehr Verantwortung anbieten. Dokumentieren Sie, wie andere in Führungsrollen hineinwachsen können, wenn sie es wünschen.
183185

184186
Andere zu ermutigen, [sich am Projekt zu beteiligen](../building-community/#teilen-sie-die-eigentümerschaft-an-ihrem-projekt), kann den eigenen Arbeitsaufwand erheblich reduzieren, wie @lmccart in ihrem Projekt [p5.js](https://github.com/processing/p5.js) feststellte.
@@ -262,6 +264,8 @@ Viele Maintainer\*innen populärer Projekte sind mit ähnlichen Problemen konfro
262264
* [semantic-release](https://github.com/semantic-release/semantic-release) automatisiert Ihre Veröffentlichungen
263265
* [mention-bot](https://github.com/facebook/mention-bot) erwähnt potentielle Reviewer für Pull Requests
264266
* [Danger](https://github.com/danger/danger) hilft bei der Automatisierung des Code Review
267+
* [no-response](https://github.com/probot/no-response) schließt Issues deren Autor\*in nicht auf Nachfragen antwortet
268+
* [dependabot-preview](https://github.com/marketplace/dependabot-preview) prüft bekannte Abhängigkeitsdateien täglich und eröffnet Pull Requests, sobald Aktualisierungen verfügbar werden
265269

266270
Für Fehlerberichte und andere allgemeine Beiträge hat GitHub [Issue- und Pull-Request-Templates](https://github.com/blog/2111-issue-and-pull-request-templates), die Sie erstellen können, um die Kommunikation zu optimieren. @TalAter hat einen [Choose Your Own Adventure Guide](https://www.talater.com/open-source-templates/#/) erstellt, der Ihnen beim Schreiben dieser Vorlagen hilft.
267271

_articles/de/building-community.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@ Beginnen Sie mit der Dokumentation:
2828

2929
* **Helfen Sie beim Einstieg in ihr Projekt.** [Eine freundliche README](../starting-a-project/#eine-readme-schreiben) und anschauliche Codebeispiele erleichtern Allen, die auf Ihr Projekt stoßen, den Einstieg.
3030
* **Erklären Sie in klaren Worten, wie Leute beitragen sollen**, bspw. in [einer CONTRIBUTING-Datei](../starting-a-project/#ihre-beitragsrichtlinien-aufschreiben), und indem Sie die Issues stets aktuell halten.
31+
* **Good first issues**: Um neuen Mitwirkenden den Einstieg zu erleichtern, sollten Sie [für Anfänger\*innen* geeignete Issues explizit kenntlich machen (Englisch)](https://help.github.com/en/articles/helping-new-contributors-find-your-project-with-labels). GitHub weist auf solche Issues vermehrt hin, sodass beitragswillige Neulinge zu nützlicher Mitarbeit ermuntert werden, ohne sich erst durch vermutlich zu schwere Issues durchkämpfen zu müssen.
3132

3233
[GitHubs 2017er Open-Source-Umfrage](http://opensourcesurvey.org/2017/) zeigte, dass unvollständige oder verwirrende Dokumentation das größte Problem für Open-Source-Anwender\*innen ist. Eine gute Dokumentation lädt zur Interaktion mit Ihrem Projekt ein. Wenn jemand ein Issue oder Pull Request erstellt, bietet sich für Sie die Möglichkeit, diese Person durch den Trichter zu bugsieren.
3334

@@ -123,14 +124,14 @@ Jedes populäre Projekt wird unweigerlich Menschen anziehen, die Ihrer Gemeinsch
123124
Tun Sie Ihr Bestes, um eine Null-Toleranz-Politik gegenüber solchen Leuten zu verfolgen. Denn wenn obiges Verhalten unsanktioniert bleibt, werden andere Kontributor\*innen sich genervt fühlen und evtl. sogar Ihr Projekt verlassen.
124125

125126
<aside markdown="1" class="pquote">
126-
<img src="https://avatars.githubusercontent.com/karissa?s=180" class="pquote-avatar" alt="avatar">
127+
<img src="https://avatars.githubusercontent.com/okdistribute?s=180" class="pquote-avatar" alt="avatar">
127128

128129
Es ist wahrlich wichtig, eine unterstützende Gemeinschaft zu haben. Ohne die Hilfe meiner Kollegen\*innen, freundlicher Fremder aus dem Internet und gesprächiger IRC-Kanäle wäre ich nie in der Lage, diese Arbeit zu tun. (...) Geben Sie sich nicht mit weniger zufrieden. Geben Sie sich nicht mit Arschlöchern zufrieden.
129130

130131
_The truth is that having a supportive community is key. I'd never be able to do this work without the help of my colleagues, friendly internet strangers, and chatty IRC channels. (...) Don't settle for less. Don't settle for assholes._
131132

132133
<p markdown="1" class="pquote-credit">
133-
@karissa, ["How to Run a FOSS Project"](https://okdistribute.xyz/post/okf-de)
134+
@okdistribute, ["How to Run a FOSS Project"](https://okdistribute.xyz/post/okf-de)
134135
</p>
135136
</aside>
136137

_articles/de/getting-paid.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -121,7 +121,7 @@ Wenn Ihr Unternehmen diesen Weg einschlägt, ist es wichtig, die Grenzen zwische
121121
Wenn Sie Ihren derzeitigen Arbeitgeber nicht davon überzeugen können, Open-Source-Arbeit zu priorisieren, sollten Sie sich überlegen, einen neuen Arbeitgeber zu finden, der Mitarbeit an Open Source fördert. Zum Beispiel:
122122

123123
* Manche Firmen, wie [Netflix](https://netflix.github.io/) oder [PayPal](https://paypal.github.io/), zeigen ihr Open-Source-Engagement auf ihren Webseiten
124-
* [Rackspace](https://www.rackspace.com/en-us) veröffentlicht seine [Open-Source-Beitragsrichtlinie](https://blog.rackspace.com/rackspaces-policy-on-contributing-to-open-source/) für Angestellte
124+
* [Zalando](https://opensource.zalando.com) veröffentlicht seine [Open-Source-Beitragsrichtlinie](https://opensource.zalando.com/docs/using/contributing/) für Angestellte
125125

126126
Aus einer großen Firma stammende Projekte, wie z.B. [Go](https://github.com/golang) oder [React](https://github.com/facebook/react), stellen vermutlich auch weiterhin Leute für Open-Source-Arbeit an.
127127

_articles/de/how-to-contribute.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,10 @@ Zu Open Source beizutragen, kann ein lohnender Weg sein, um nahezu alle erdenkli
2828

2929
Warum tragen Menschen zu Open Source bei? Es gibt viele Gründe!
3030

31+
### Software verbessern, auf die Sie sich verlassen.
32+
33+
Viele Open-Source-Beitragende waren vorher Nutzer\*innen der Software, zu der sie beitragen. Wenn Sie einen Fehler in einer von Ihnen verwendeten Open-Source-Software finden, sollten Sie sich im Quellcode umsehen, ob Sie den Fehler evtl. selbst patchen können. Wenn ja, ist einen Patch einzureichen der beste Weg sicherzustellen, dass Ihre Kolleg\*innen (und Sie selbst, wenn Sie auf die nächste Version aktualisieren) davon profitieren können.
34+
3135
### Bestehende Fähigkeiten verbessern
3236

3337
Ob Programmierung, User Interface Design, Grafikdesign, Schreiben oder Organisieren: Wenn Sie auf der Suche nach Praxiserfahrung sind, werden Sie dafür passende Aufgaben in einem Open-Source-Projekt finden.
@@ -229,7 +233,9 @@ Sie können eine README überfliegen und einen defekten Link oder einen Tippfehl
229233
>
230234
> [28% of casual contributions](https://www.igor.pro.br/publica/papers/saner2016.pdf) to open source are documentation, such as a typo fix, reformatting, or writing a translation.
231235
232-
Auf einer der folgenden Seiten können Sie neue Projekte zum Beitragen entdecken (alle englischsprachig):
236+
Wenn Sie Issues suchen, die Sie beheben könnten, hat jedes Open-Source-Projekt eine Seite, die Neuling-freundliche Issues aufzeigt. Navigieren Sie zur Repository-Hauptseite auf GitHub und fügen Sie `/contribute` der URL hinzu (z.B.[`https://github.com/facebook/react/contribute`](https://github.com/facebook/react/contribute)).
237+
238+
Weiterhin, können Sie auf folgenden Seiten neue Projekte zum Beitragen entdecken (alle englischsprachig):
233239

234240
* [GitHub Explore](https://github.com/explore/)
235241
* [Open Source Friday](https://opensourcefriday.com)

_articles/de/index.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
layout: index
3+
title: Open Source Guides
34
lang: de
45
permalink: /de/
56
---

_articles/es/building-community.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -113,10 +113,10 @@ Cualquier proyecto popular inevitablemente atraer&aacute; a personas que perjudi
113113
Haz todo lo posible para adoptar una pol&iacute;tica de tolerancia cero hacia este tipo de personas. Si no se controla, las personas negativas har&aacute;n que otras personas de tu comunidad se sientan inc&oacute;modas. Incluso pueden irse.
114114

115115
<aside markdown="1" class="pquote">
116-
<img src="https://avatars.githubusercontent.com/karissa?s=180" class="pquote-avatar" alt="avatar">
116+
<img src="https://avatars.githubusercontent.com/okdistribute?s=180" class="pquote-avatar" alt="avatar">
117117
La verdad es que tener una comunidad de apoyo es clave. Nunca hubiera sido capaz de realizar este trabajo sin la ayuda de mis colegas, los extra&ntilde;os de internet que fueron amigables y los canales IRC de conversaci&oacute;n. (...) No te conformes con menos. No te conformes con los idiotas.
118118
<p markdown="1" class="pquote-credit">
119-
@karissa, ["How to Run a FOSS Project"](https://okdistribute.xyz/post/okf-de)
119+
@okdistribute, ["How to Run a FOSS Project"](https://okdistribute.xyz/post/okf-de)
120120
</p>
121121
</aside>
122122

0 commit comments

Comments
 (0)