Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
106 commits
Select commit Hold shift + click to select a range
74ed698
Update security-best-practices-for-your-project.md
BlueButterflies Jun 26, 2025
b1c9c5a
Update security-best-practices-for-your-project.md
BlueButterflies Jun 26, 2025
3b80362
feat(fonts): add Vazirmatn variable font
Revisto Jun 27, 2025
18fdce1
feat(fonts): register Vazirmatn variable font and apply to fa locale
Revisto Jun 27, 2025
4341fd3
refactor(css): Scope Persian font to specific text elements
Revisto Jun 27, 2025
6375d0e
Add information about Gitlab
Wodsfort Jul 13, 2025
2c5a732
Change after creating mistake
Wodsfort Jul 13, 2025
02af73f
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Jul 16, 2025
c6311cf
chore(deps): bump nokogiri in the dependencies group
dependabot[bot] Jul 21, 2025
cc0b2f6
Merge pull request #3469 from github/dependabot/bundler/dependencies-…
jmeridth Jul 21, 2025
df51ed5
Merge pull request #3468 from github/dependabot/github_actions/depend…
jmeridth Jul 21, 2025
4c6fee2
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Jul 22, 2025
4b977e4
Merge branch 'main' into patch-1
Wodsfort Jul 22, 2025
d3ad374
Merge pull request #3470 from github/dependabot/github_actions/depend…
jmeridth Jul 24, 2025
fddc6ef
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Jul 25, 2025
1b145c1
Update ko.nav.about
hahwul Jul 31, 2025
388d6f7
fix: ensure sourcesort link is to web archive
jmeridth Aug 1, 2025
2ce3736
Merge pull request #3472 from github/dependabot/github_actions/depend…
jmeridth Aug 1, 2025
ff7f9f7
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Aug 4, 2025
7a4ddb4
Merge pull request #3474 from github/dependabot/github_actions/depend…
jmeridth Aug 5, 2025
00eca59
add RU translate for security-best-practices-for-your-project
vldmrdev Aug 8, 2025
33c1447
Merge branch 'main' into patch-1
Wodsfort Aug 8, 2025
de527a7
add RU translate of Maintaining Balance for Open Source Maintainers
vldmrdev Aug 8, 2025
03d216e
Merge pull request #3461 from BlueButterflies/bg
tomthorogood Aug 8, 2025
20fec61
Merge pull request #3462 from BlueButterflies/it
tomthorogood Aug 8, 2025
79ee1bc
Merge pull request #3463 from Revisto/feat/fa-vazirmatn-font-support
tomthorogood Aug 8, 2025
fd30666
Merge branch 'main' into update-ko
tomthorogood Aug 8, 2025
99002a4
Merge branch 'main' into ru-security-best-practices
tomthorogood Aug 8, 2025
700dc78
Merge branch 'main' into patch-1
tomthorogood Aug 8, 2025
58d670c
Merge pull request #3466 from Wodsfort/patch-1
tomthorogood Aug 8, 2025
c0e429b
chore(deps): bump actions/checkout from 4.2.2 to 5.0.0
dependabot[bot] Aug 12, 2025
c831db6
fix: newline between list and header
jmeridth Aug 12, 2025
00a5c84
Merge pull request #3479 from github/dependabot/github_actions/action…
jmeridth Aug 12, 2025
148b168
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Aug 12, 2025
3cfbdeb
Merge pull request #3480 from github/dependabot/github_actions/depend…
jmeridth Aug 12, 2025
2ffca5f
Merge branch 'main' into ru-security-best-practices
jmeridth Aug 12, 2025
e33833f
Merge branch 'main' into ru-maintaining-balance-for-open-source-maint…
jmeridth Aug 12, 2025
0ea3544
fix: add RU translation security-best-practices-for-your-project.md
vldmrdev Aug 12, 2025
711d563
Merge branch 'main' into ru-security-best-practices
vldmrdev Aug 12, 2025
68deec3
Merge branch 'ru-security-best-practices' of github.com:vldmrdev/open…
vldmrdev Aug 12, 2025
7fe4e90
Merge branch 'main' into ru-maintaining-balance-for-open-source-maint…
vldmrdev Aug 12, 2025
eb57cb1
fix: add RU translation maintaining-balance-for-open-source-maintainer
vldmrdev Aug 12, 2025
674e6c1
Merge branch 'ru-maintaining-balance-for-open-source-maintainers' of …
vldmrdev Aug 12, 2025
bffaf0e
Merge pull request #3475 from vldmrdev/ru-security-best-practices
jmeridth Aug 12, 2025
6554bed
fix: add RU translation maintaining-balance-for-open-source-maintainer
vldmrdev Aug 12, 2025
1a036c9
Merge branch 'main' into ru-maintaining-balance-for-open-source-maint…
vldmrdev Aug 12, 2025
784d64c
Merge pull request #3476 from vldmrdev/ru-maintaining-balance-for-ope…
jmeridth Aug 12, 2025
76716c6
fix: typo in GitLab
alexandear Aug 14, 2025
d1272ac
Merge pull request #3481 from alexandear-org/fix/spell-gitlab
jmeridth Aug 14, 2025
7613e1a
chore(deps): bump actions/upload-pages-artifact from 3.0.1 to 4.0.0
dependabot[bot] Aug 15, 2025
bb402b2
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Aug 21, 2025
2210796
Merge pull request #3482 from github/dependabot/github_actions/action…
jmeridth Aug 22, 2025
21c4d68
Merge pull request #3485 from github/dependabot/github_actions/depend…
jmeridth Aug 22, 2025
d080f2c
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Sep 1, 2025
5bd3230
Merge pull request #3491 from github/dependabot/github_actions/depend…
jmeridth Sep 1, 2025
dccf0f8
chore(deps): bump actions/stale from 9.1.0 to 10.0.0
dependabot[bot] Sep 4, 2025
81a2b98
Merge pull request #3494 from github/dependabot/github_actions/action…
jmeridth Sep 4, 2025
83a4e0d
chore(deps): bump actions/setup-node from 4.4.0 to 5.0.0
dependabot[bot] Sep 4, 2025
c546638
Merge pull request #3496 from github/dependabot/github_actions/action…
jmeridth Sep 4, 2025
9b7941d
Merge pull request #3473 from hahwul/update-ko
ahpook Sep 7, 2025
c46d82e
docs: add Turkish translation for security-best-practices guide
Sep 12, 2025
6ac664b
docs: add Turkish translation for maintaining balance for Open Source…
Sep 12, 2025
796754a
Add workflow to fix file permissions
Sep 12, 2025
acc67d9
Delete fix permission workflow
Sep 12, 2025
8aca92f
minor update
Sep 12, 2025
0d0892c
minor updates
Sep 12, 2025
64981ba
minor updates
Sep 12, 2025
aa4ea20
chore(deps): bump nokogiri in the dependencies group
dependabot[bot] Sep 15, 2025
c392bc8
Merge pull request #3502 from github/dependabot/bundler/dependencies-…
jmeridth Sep 15, 2025
700660e
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Sep 17, 2025
f89c25a
Merge pull request #3503 from github/dependabot/github_actions/depend…
jmeridth Sep 17, 2025
2138151
Merge branch 'main' into main
samirrhashimov Sep 17, 2025
a15b5eb
chore(deps): bump rexml in the bundler group across 1 directory
dependabot[bot] Sep 17, 2025
508f327
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Sep 19, 2025
431694e
fix: ignore npmjs.com url as it 403s
jmeridth Sep 25, 2025
f569da1
Merge pull request #3505 from github/dependabot/github_actions/depend…
jmeridth Sep 25, 2025
80cb76e
Merge pull request #3500 from samirrhashimov/main
jmeridth Sep 25, 2025
39f91f1
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Sep 26, 2025
9ac30ef
Merge pull request #3507 from github/dependabot/github_actions/depend…
jmeridth Sep 26, 2025
55f4bfa
Improve alt text in building-community
edent Oct 1, 2025
75b7c0d
chore(deps): bump actions/stale in the dependencies group
dependabot[bot] Oct 6, 2025
0f8eb42
fix: ignore quora.com due to 403 and fix rust-lang.org url
jmeridth Oct 7, 2025
bacaa42
Merge pull request #3515 from github/dependabot/github_actions/depend…
jmeridth Oct 7, 2025
f180cd7
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Oct 9, 2025
c764ddd
Merge pull request #3517 from github/dependabot/github_actions/depend…
jmeridth Oct 9, 2025
841f01f
Merge branch 'main' into patch-1
jmeridth Oct 9, 2025
59844f1
Merge pull request #3509 from edent/patch-1
jmeridth Oct 10, 2025
c13d42f
Merge pull request #3504 from github/dependabot/bundler/bundler-6d4d9…
jmeridth Oct 11, 2025
9b410ae
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Oct 13, 2025
aed5c8c
Merge pull request #3519 from github/dependabot/github_actions/depend…
jmeridth Oct 13, 2025
50a5ed5
chore(deps): bump actions/setup-node from 5.0.0 to 6.0.0
dependabot[bot] Oct 14, 2025
fb5dc20
Merge pull request #3520 from github/dependabot/github_actions/action…
jmeridth Oct 14, 2025
569a2fd
Added Quick Tip section for beginners
Dhanyasri7 Oct 14, 2025
d357751
Added spanish translation: security-best-practices-for-your-code.md
AlexJauregui02 Oct 21, 2025
7c0b0b0
fixed sintax error with the curly quotation marks
AlexJauregui02 Oct 21, 2025
4beb2a6
Merge pull request #3521 from Dhanyasri7/add-quick-tip
jmeridth Oct 23, 2025
3514224
Merge branch 'main' into es-fixed-errors
AlexJauregui02 Oct 23, 2025
2c0dc8f
Merge pull request #3531 from AlexJauregui02/es-fixed-errors
jmeridth Oct 25, 2025
f5051b2
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Oct 27, 2025
387ed19
Merge pull request #3533 from github/dependabot/github_actions/depend…
jmeridth Oct 28, 2025
5f1142b
chore(deps): bump ruby/setup-ruby in the dependencies group
dependabot[bot] Oct 29, 2025
fd4f254
Merge pull request #3540 from github/dependabot/github_actions/depend…
jmeridth Oct 29, 2025
95657f3
chore(deps): bump rake from 13.3.0 to 13.3.1 in the dependencies group
dependabot[bot] Oct 30, 2025
a907e07
Merge pull request #3541 from github/dependabot/bundler/dependencies-…
jmeridth Oct 30, 2025
f218329
Add funding sources
ansharora28 Oct 30, 2025
19daccd
Merge pull request #3542 from ansharora28/patch-3
jmeridth Oct 30, 2025
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
4 changes: 2 additions & 2 deletions .github/workflows/jekyll-preview.yml
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ jobs:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4.2.2
uses: actions/checkout@v5.0.0
with:
# For PRs make sure to checkout the PR branch
ref: ${{ github.event.pull_request.head.sha }}
Expand All @@ -44,7 +44,7 @@ jobs:
destination: ./_site
- name: Upload artifact
# Automatically uploads an artifact from the './_site' directory by default
uses: actions/upload-pages-artifact@v3.0.1
uses: actions/upload-pages-artifact@v4.0.0
# Deployment job
deploy:
environment:
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/jekyll.yml
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ jobs:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4.2.2
uses: actions/checkout@v5.0.0
- name: Setup Pages
uses: actions/configure-pages@v5.0.0
- name: Build with Jekyll
Expand All @@ -37,7 +37,7 @@ jobs:
destination: ./_site
- name: Upload artifact
# Automatically uploads an artifact from the './_site' directory by default
uses: actions/upload-pages-artifact@v3.0.1
uses: actions/upload-pages-artifact@v4.0.0
# Deployment job
deploy:
environment:
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/stale.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ jobs:
stale:
runs-on: ubuntu-latest
steps:
- uses: actions/stale@v9.1.0
- uses: actions/stale@v10.1.0
with:
stale-pr-message: >
This pull request has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.
Expand Down
6 changes: 3 additions & 3 deletions .github/workflows/tests.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,13 +11,13 @@ jobs:
runs-on: ubuntu-latest
steps:
- name: Set up Git repository
uses: actions/checkout@v4.2.2
uses: actions/checkout@v5.0.0
- name: Set up Ruby
uses: ruby/setup-ruby@a4effe49ee8ee5b8b5091268c473a4628afb5651 # v1
uses: ruby/setup-ruby@d5126b9b3579e429dd52e51e68624dda2e05be25 # v1
with:
bundler-cache: true
- name: Set up Node
uses: actions/setup-node@v4.4.0
uses: actions/setup-node@v6.0.0
- name: Bootstrap
run: script/bootstrap
env:
Expand Down
8 changes: 8 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,14 @@ If you'd like to contribute, start by searching through the [pull requests](http

If you don't see your idea listed, and you think it fits into the goals of this guide, open a pull request.

## 💡 Quick Tip for Beginners

1. Always create a new branch for your changes.
2. Write clear commit messages.
3. Test your changes locally before submitting a PR.
4. Follow the style guide.
5. Be patient during reviews.

## Style guide

If you're writing content, see the [style guide](./docs/styleguide.md) to help your prose match the rest of the guides.
Expand Down
24 changes: 12 additions & 12 deletions Gemfile.lock
Original file line number Diff line number Diff line change
Expand Up @@ -260,32 +260,32 @@ GEM
logger (1.6.1)
mercenary (0.3.6)
metrics (0.12.1)
mini_portile2 (2.8.8)
mini_portile2 (2.8.9)
minima (2.5.1)
jekyll (>= 3.5, < 5.0)
jekyll-feed (~> 0.9)
jekyll-seo-tag (~> 2.1)
minitest (5.25.1)
net-http (0.4.1)
uri
nokogiri (1.18.8)
nokogiri (1.18.10)
mini_portile2 (~> 2.8.2)
racc (~> 1.4)
nokogiri (1.18.8-aarch64-linux-gnu)
nokogiri (1.18.10-aarch64-linux-gnu)
racc (~> 1.4)
nokogiri (1.18.8-aarch64-linux-musl)
nokogiri (1.18.10-aarch64-linux-musl)
racc (~> 1.4)
nokogiri (1.18.8-arm-linux-gnu)
nokogiri (1.18.10-arm-linux-gnu)
racc (~> 1.4)
nokogiri (1.18.8-arm-linux-musl)
nokogiri (1.18.10-arm-linux-musl)
racc (~> 1.4)
nokogiri (1.18.8-arm64-darwin)
nokogiri (1.18.10-arm64-darwin)
racc (~> 1.4)
nokogiri (1.18.8-x86_64-darwin)
nokogiri (1.18.10-x86_64-darwin)
racc (~> 1.4)
nokogiri (1.18.8-x86_64-linux-gnu)
nokogiri (1.18.10-x86_64-linux-gnu)
racc (~> 1.4)
nokogiri (1.18.8-x86_64-linux-musl)
nokogiri (1.18.10-x86_64-linux-musl)
racc (~> 1.4)
octokit (4.25.1)
faraday (>= 1, < 3)
Expand All @@ -301,11 +301,11 @@ GEM
public_suffix (5.1.1)
racc (1.8.1)
rainbow (3.1.1)
rake (13.3.0)
rake (13.3.1)
rb-fsevent (0.11.2)
rb-inotify (0.11.1)
ffi (~> 1.0)
rexml (3.3.9)
rexml (3.4.2)
rouge (3.30.0)
ruby-rc4 (0.1.5)
rubyzip (2.3.2)
Expand Down
82 changes: 41 additions & 41 deletions _articles/bg/security-best-practices-for-your-project.md

Large diffs are not rendered by default.

22 changes: 11 additions & 11 deletions _articles/building-community.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ A welcoming community is an investment into your project's future and reputation

One way to think about your project's community is through what @MikeMcQuaid calls the [contributor funnel](https://mikemcquaid.com/2018/08/14/the-open-source-contributor-funnel-why-people-dont-contribute-to-your-open-source-project/):

![Contributor funnel](/assets/images/building-community/contributor_funnel_mikemcquaid.png)
![Contributor funnel starts with users, then contributors, then maintainers.](/assets/images/building-community/contributor_funnel_mikemcquaid.png)

As you build your community, consider how someone at the top of the funnel (a potential user) might theoretically make their way to the bottom (an active maintainer). Your goal is to reduce friction at each stage of the contributor experience. When people have easy wins, they will feel incentivized to do more.

Expand All @@ -38,7 +38,7 @@ Start with your documentation:
* **If there's a contribution you disagree with,** thank them for their idea and [explain why](../best-practices/#learning-to-say-no) it doesn't fit into the scope of the project, linking to relevant documentation if you have it.

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/mikeal?s=180" class="pquote-avatar" alt="avatar">
<img src="https://avatars.githubusercontent.com/mikeal?s=180" class="pquote-avatar" alt="">
Contributing to open source is easier for some than others. There's a lot of fear of being yelled at for not doing something right or just not fitting in. (...) By giving contributors a place to contribute with very low technical proficiency (documentation, web content markdown, etc) you can greatly reduce those concerns.
<p markdown="1" class="pquote-credit">
— @mikeal, ["Growing a contributor base in modern open source"](https://opensource.com/life/16/5/growing-contributor-base-modern-open-source)
Expand All @@ -52,7 +52,7 @@ Encouraging other contributors is an investment in yourself, too. When you empow
### Document everything

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/janl?s=180" class="pquote-avatar" alt="avatar">
<img src="https://avatars.githubusercontent.com/janl?s=180" class="pquote-avatar" alt="">
Have you ever been to a (tech-) event where you didn't know anyone, but everyone else seemed to stand in groups and chat like old friends? (...) Now imagine you want to contribute to an open source project, but you don't see why or how this is happening.
<p markdown="1" class="pquote-credit">
— @janl, ["Sustainable Open Source"](https://web.archive.org/web/20200723213552/https://writing.jan.io/2015/11/20/sustainable-open-source.html)
Expand Down Expand Up @@ -81,7 +81,7 @@ Try to be responsive when someone files an issue, submits a pull request, or ask

Even if you can't review the request immediately, acknowledging it early helps increase engagement. Here's how @tdreyno responded to a pull request on [Middleman](https://github.com/middleman/middleman/pull/1466):

![Middleman pull request](/assets/images/building-community/middleman_pr.png)
![@tdreyno commented "Thanks for diving in @joallard. I'm traveling right now, but will try to review and comment soon." A day later they said "You're absolutely right, this extension is really crufty. I've merged in a lot of features, not knowing which are good or bad because I only use i18n in the simplest way, myself. We'd love any direction, code and ideas you have. I really like this iterative approach, slowly adding features rather than a complete do-over. I'm going to push out v4 beta 1 today, so let's save this for beta 2. And we need to track down that failing test." @joallard commented "Awesome. I'll go forward then!"](/assets/images/building-community/middleman_pr.png)

[A Mozilla study found that](https://docs.google.com/presentation/d/1hsJLv1ieSqtXBzd5YZusY-mB8e1VJzaeOmh8Q4VeMio/edit#slide=id.g43d857af8_0177) contributors who received code reviews within 48 hours had a much higher rate of return and repeat contribution.

Expand Down Expand Up @@ -114,7 +114,7 @@ Any popular project will inevitably attract people who harm, rather than help, y
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.

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/okdistribute?s=180" class="pquote-avatar" alt="avatar">
<img src="https://avatars.githubusercontent.com/okdistribute?s=180" class="pquote-avatar" alt="">
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.
<p markdown="1" class="pquote-credit">
— @okdistribute, ["How to Run a FOSS Project"](https://okdistribute.xyz/post/okf-de)
Expand Down Expand Up @@ -146,7 +146,7 @@ For example, here's how [Rubinius](https://github.com/rubinius/rubinius/) starts
### Share ownership of your project

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/sagesharp?s=180" class="pquote-avatar" alt="avatar">
<img src="https://avatars.githubusercontent.com/sagesharp?s=180" class="pquote-avatar" alt="">
Your leaders will have different opinions, as all healthy communities should! However, you need to take steps to ensure the loudest voice doesn't always win by tiring people out, and that less prominent and minority voices are heard.
<p markdown="1" class="pquote-credit">
— @sagesharp, ["What makes a good community?"](https://sage.thesharps.us/2015/10/06/what-makes-a-good-community/)
Expand All @@ -159,7 +159,7 @@ See if you can find ways to share ownership with your community as much as possi

* **Resist fixing easy (non-critical) bugs.** Instead, use them as opportunities to recruit new contributors, or mentor someone who'd like to contribute. It may seem unnatural at first, but your investment will pay off over time. For example, @michaeljoseph asked a contributor to submit a pull request on a [Cookiecutter](https://github.com/audreyr/cookiecutter) issue below, rather than fix it himself.

![Cookiecutter issue](/assets/images/building-community/cookiecutter_submit_pr.png)
![@michaeljoseph saying "Thanks for the issue. Do you think you could submit a quick PR for this?"](/assets/images/building-community/cookiecutter_submit_pr.png)

* **Start a CONTRIBUTORS or AUTHORS file in your project** that lists everyone who's contributed to your project, like [Sinatra](https://github.com/sinatra/sinatra/blob/HEAD/AUTHORS.md) does.

Expand All @@ -174,7 +174,7 @@ The reality is that [most projects only have](https://peerj.com/preprints/1233/)
While you may not always find someone to answer the call, putting a signal out there increases the chances that other people will pitch in. And the earlier you start, the sooner people can help.

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/gr2m?s=180" class="pquote-avatar" alt="avatar">
<img src="https://avatars.githubusercontent.com/gr2m?s=180" class="pquote-avatar" alt="">
\[It's in your\] best interest to recruit contributors who enjoy and who are capable of doing the things that you are not. Do you enjoy coding, but not answering issues? Then identify those individuals in your community who do and let them have it.
<p markdown="1" class="pquote-credit">
— @gr2m, ["Welcoming Communities"](http://hood.ie/blog/welcoming-communities.html)
Expand All @@ -196,7 +196,7 @@ When your community is grappling with a difficult issue, tempers may rise. Peopl
Your job as a maintainer is to keep these situations from escalating. Even if you have a strong opinion on the topic, try to take the position of a moderator or facilitator, rather than jumping into the fight and pushing your views. If someone is being unkind or monopolizing the conversation, [act immediately](../building-community/#dont-tolerate-bad-actors) to keep discussions civil and productive.

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/kennethreitz?s=180" class="pquote-avatar" alt="avatar">
<img src="https://avatars.githubusercontent.com/kennethreitz?s=180" class="pquote-avatar" alt="">
As a project maintainer, it's extremely important to be respectful to your contributors. They often take what you say very personally.
<p markdown="1" class="pquote-credit">
— @kennethreitz, ["Be Cordial or Be on Your Way"](https://web.archive.org/web/20200509154531/https://kenreitz.org/essays/be-cordial-or-be-on-your-way)
Expand All @@ -222,7 +222,7 @@ Sometimes, voting is a necessary tiebreaker. As much as you are able, however, e
Under a consensus seeking process, community members discuss major concerns until they feel they have been adequately heard. When only minor concerns remain, the community moves forward. "Consensus seeking" acknowledges that a community may not be able to reach a perfect answer. Instead, it prioritizes listening and discussion.

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/lee-dohm?s=180" class="pquote-avatar" alt="avatar">
<img src="https://avatars.githubusercontent.com/lee-dohm?s=180" class="pquote-avatar" alt="">
Part of the reason why a voting system doesn't exist for Atom Issues is because the Atom team isn't going to follow a voting system in all cases. Sometimes we have to choose what we feel is right even if it is unpopular. (...) What I can offer and pledge to do...is that it is my job to listen to the community.
<p markdown="1" class="pquote-credit">
— @lee-dohm on Atom's decision making process
Expand All @@ -248,7 +248,7 @@ If the conversation is starting to unravel, ask the group, _"Which steps should
If a conversation clearly isn't going anywhere, there are no clear actions to be taken, or the appropriate action has already been taken, close the issue and explain why you closed it.

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/kfogel?s=180" class="pquote-avatar" alt="avatar">
<img src="https://avatars.githubusercontent.com/kfogel?s=180" class="pquote-avatar" alt="">
Guiding a thread toward usefulness without being pushy is an art. It won't work to simply admonish people to stop wasting their time, or to ask them not to post unless they have something constructive to say. (...) Instead, you have to suggest conditions for further progress: give people a route, a path to follow that leads to the results you want, yet without sounding like you're dictating conduct.
<p markdown="1" class="pquote-credit">
— @kfogel, [_Producing OSS_](https://producingoss.com/en/producingoss.html#common-pitfalls)
Expand Down
1 change: 1 addition & 0 deletions _articles/de/how-to-contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -233,6 +233,7 @@ Weiterhin, können Sie auf folgenden Seiten neue Projekte zum Beitragen entdecke
* [Up For Grabs](https://up-for-grabs.net/)
* [First Contributions](https://firstcontributions.github.io)
* [SourceSort](https://web.archive.org/web/20201111233803/https://www.sourcesort.com/)
* [OpenSauced](https://opensauced.pizza/)

### Eine Checkliste, bevor Sie einen Beitrag leisten

Expand Down
1 change: 1 addition & 0 deletions _articles/el/how-to-contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -213,6 +213,7 @@ related:
* [Up For Grabs](https://up-for-grabs.net/)
* [First Contributions](https://firstcontributions.github.io)
* [SourceSort](https://web.archive.org/web/20201111233803/https://www.sourcesort.com/)
* [OpenSauced](https://opensauced.pizza/)

### Μια λίστα ελέγχου πριν συνεισφέρετε

Expand Down
1 change: 1 addition & 0 deletions _articles/es/how-to-contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -209,6 +209,7 @@ Puedes tambi&eacute;n utilizar algunos de los siguientes recursos para ayudarte
* [Up For Grabs](https://up-for-grabs.net/)
* [First Contributions](https://firstcontributions.github.io)
* [SourceSort](https://web.archive.org/web/20201111233803/https://www.sourcesort.com/)
* [OpenSauced](https://opensauced.pizza/)

### Una lista de verificaci&oacute;n antes de que contribuyas

Expand Down
Loading