You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _articles/hu/best-practices.md
+42-42Lines changed: 42 additions & 42 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -157,97 +157,97 @@ Lehet, hogy valaki a közösségedben rendszeresen nyújt be olyan hozzájárul
157
157
158
158
Ha azt látod, hogy valaki lelkesedik a projekted iránt, de egy kis segítségre van szüksége, légy türelmes. Mindig magyarázd el világosan, hogy miért nem felelnek meg a hozzájárulások a projekt elvárásainak. Próbálj ajánlani egy könnyebb vagy kevésbé bonyolult feladatot, például egy feladatot a _"good first issue"_ jelöléssel, hogy a megtegye az első lépéseket. Ha van időd, akkor fontold meg a mentorálásukat az első hozzájárulásuk alkalmával, vagy keress meg valaki mást a közösségében, aki hajlandó mentorálni őket.
159
159
160
-
## Leverage your community
160
+
## Használd ki a közösség erejét
161
161
162
-
You don't have to do everything yourself. Your project's community exists for a reason! Even if you don't yet have an active contributor community, if you have a lot of users, put them to work.
162
+
Nem kell mindent egymagad csinálni. A projekt közösség okkal létezik! Ha még nincs aktív közreműködő közösség, de már sokan vannak benne, akkor is próbáld munkára fogni őket.
163
163
164
-
### Share the workload
164
+
### Osszd el a munkaterhelést
165
165
166
-
If you're looking for others to pitch in, start by asking around.
166
+
Ha szeretnél másokat bevonni, akkor kérdezz körbe.
167
167
168
-
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.
168
+
Az új közreműködők megszerzésének egyik módja az, hogy kifejezetten [olyan issue-kat nevezel meg, amelyek elég egyszerűek a kezdők számára](https://help.github.com/en/articles/helping-new-contributors-find-your-project-with-labels). A GitHub segíti ezen issue-k kiemelésén és láthatóvá tételét.
169
169
170
-
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.
170
+
Amikor azt látod, hogy az új résztvevők rendszeresen hozzájárulnak a projekhez, akkor ismerd el a munkájukat azzal, hogy nagyobb felelősséget adsz számukra. Dokumentáld le, hogy hogyan válhat valaki a projekt irányító tagjává, ha azt szeretné.
171
171
172
-
Encouraging others to [share ownership of the project](../building-community/#share-ownership-of-your-project)can greatly reduce your own workload, as @lmccartdiscovered on her project, [p5.js](https://github.com/processing/p5.js).
172
+
Ösztönözz másokat arra, hogy [résztvegyenek a projekt irányításában](../building-community/#share-ownership-of-your-project)ezzel jelentősen csökkented a saját terhelésed, mint ahogy @lmccartészrevette ezt a saját projektjénél, [p5.js](https://github.com/processing/p5.js).
I’d been saying, "Yeah, anyone can be involved, you don’t have to have a lot of coding expertise [...]." We had people sign up to come [to an event] and that’s when I was really wondering: is this true, what I’ve been saying? There are gonna be 40 people who show up, and it’s not like I can sit with each of them...But people came together, and it just sort of worked. As soon as one person got it, they could teach their neighbor.
176
+
Azt mondtam: "Igen, bárki jöhet, nem kell sok tapasztalattal rendelkeznie a kódolás területén [...]." Az emberek feliratkoztak, hogy eljöjjenek [a rendezvényre], és nagyon kiváncsi voltam rá, hogy valóban jó-e az, amit mondtam? 40 ember megjelent, és nem úgy tünt hogy mindenkivel, egyenként le tudok ülni beszélni... De az emberek összeálltak, és egyszerűen csak elkezdett minden jól működni. Amint egy ember megértette a dolgot, elkezdte a többieket tanítani.
177
177
<pmarkdown="1"class="pquote-credit">
178
-
— @lmccart, ["What Does "Open Source" Even Mean? p5.js Edition"](https://medium.com/@kenjagan/what-does-open-source-even-mean-p5-js-edition-98c02d354b39)
178
+
— @lmccart, ["Mit jelent még az "Nyílt Forrás"? p5.js Kiadás"](https://medium.com/@kenjagan/what-does-open-source-even-mean-p5-js-edition-98c02d354b39)
179
179
</p>
180
180
</aside>
181
181
182
-
If you need to step away from your project, either on hiatus or permanently, there's no shame in asking someone else to take over for you.
182
+
Ha a projektet magára kell hagynod rövid vagy akár hosszabb időre, akkor nincs semmi szégyelleni való abban, ha megkérsz mást, hogy vegye át a helyed.
183
183
184
-
If other people are enthusiastic about its direction, give them commit access or formally hand over control to someone else. If someone forked your project and is actively maintaining it elsewhere, consider linking to the fork from your original project. It's great that so many people want your project to live on!
184
+
Ha mások is lelkesek a projekt irányát illetően, akkor add meg nekik a hozzáférést, vagy formálisan is add át az irányítást. Ha valaki forkolta a projektet, és másutt aktívan fenntartja azt, fontold meg az eredeti projekt csatlakozását ehhez. Nagyszerű, ha sok ember akarja azt, hogy a projekt tovább éljen!
185
185
186
-
@progrium[found that](https://progrium.com/blog/2015/12/04/leadership-guilt-and-pull-requests/)documenting the vision for his project,[Dokku](https://github.com/dokku/dokku), helped those goals live on even after he stepped away from the project:
186
+
@progrium[úgy találta](https://progrium.com/blog/2015/12/04/leadership-guilt-and-pull-requests/)hogy a projekt vízió dokumentálása a[Dokku](https://github.com/dokku/dokku) esetén, segített abban, hogy a célok tovább éljenek még akkor is, amikor ő már nem vesz részt a projektben:
187
187
188
-
> I wrote a wiki page describing what I wanted and why I wanted it. For some reason it came as a surprise to me that the maintainers started moving the project in that direction! Did it happen exactly how I'd do it? Not always. But it still brought the project closer to what I wrote down.
188
+
> Egy wiki oldalon leírtam, hogy mit és miért akartam. Valami oknál fogva meglepetésnek számított nekem, hogy a karbantartók elkezdték vinni a projektet ebbe az irányba! Hogy pontosan úgy történt ez, ahogy én tettem volna? Nem mindig. De mégis közelebb hozta a projektet ahhoz, amit leírtam.
189
189
190
-
### Let others build the solutions they need
190
+
### Hagyd, hogy mások építsék ki a számukra szükséges megoldásokat
191
191
192
-
If a potential contributor has a different opinion on what your project should do, you may want to gently encourage them to work on their own fork.
192
+
Ha egy potenciális közreműködő eltérő véleményen van arról, hogy mit kellene a projektben megvalósítani, akkor érdemes udvariasan ösztönözni őt, hogy saját forkon dolgozzon.
193
193
194
-
Forking a project doesn't have to be a bad thing. Being able to copy and modify projects is one of the best things about open source. Encouraging your community members to work on their own fork can provide the creative outlet they need, without conflicting with your project's vision.
194
+
A projekt forkolása (elágaztatása) nem jelent rossz dolgot. A projekt lemásolása és módosítása a legjobb része a nyílt forráskódnak. A közösség tagjainak ösztönzése arra, hogy saját forkon dolgozzanak alkalmas arra, hogy saját kreatívitásukat kiélhessék anélkül, hogy ez ütközne a projekted eredeti víziójával.
I cater to the 80% use case. If you are one of the unicorns, please fork my work. I won't get offended! My public projects are almost always meant to solve the most common problems; I try to make it easy to go deeper by either forking my work or extending it.
198
+
Én garantáltan lefedem a használati esetek 80%-át. Ha te egyike vagy az Unikornisoknak [szakmai guru], akkor kérlek, forkold el a munkám. Nem veszem sértésnek! A publikus projektjeim szinte kivétel nélkül a leggyakoribb problémákra nyújtanak megoldást; én csupán csak megpróbálom megkönnyíteni azt, hogy Te elmélyedhess a problémákban akár a munkám forkolásával vagy annak kiterjesztésével.
199
199
<pmarkdown="1"class="pquote-credit">
200
-
— @geerlingguy, ["Why I Close PRs"](https://www.jeffgeerling.com/blog/2016/why-i-close-prs-oss-project-maintainer-notes)
200
+
— @geerlingguy, ["Miért zárok le beolvasztási kérelmeket?"](https://www.jeffgeerling.com/blog/2016/why-i-close-prs-oss-project-maintainer-notes)
201
201
</p>
202
202
</aside>
203
203
204
-
The same applies to a user who really wants a solution that you simply don't have the bandwidth to build. Offering APIs and customization hooks can help others meet their own needs, without having to modify the source directly. @orta[found that](https://artsy.github.io/blog/2016/07/03/handling-big-projects/)encouraging plugins for CocoaPods led to "some of the most interesting ideas":
204
+
Ugyanez a megoldás jó akkor is, ha valaki komolyan akarna egy megoldást a projektben valamire, de erre neked már nincs kapacitásod. API-k és testreszabható hook-ok biztosítása lehetővé teszi mások számára, hogy anélkül elégítsék ki a szükségleteiket, hogy a projektet módosítani kellene közvetlenül. @orta[szerint](https://artsy.github.io/blog/2016/07/03/handling-big-projects/)a CocoaPods plugin megjelenése vezetett "néhány nagyon érdekes ötlethez":
205
205
206
-
> It's almost inevitable that once a project becomes big, maintainers have to become a lot more conservative about how they introduce new code. You become good at saying "no", but a lot of people have legitimate needs. So, instead you end up converting your tool into a platform.
206
+
> Szinte elkerülhetetlen, hogy ha egy projekt nagyméretűvé válik, a karbantartóknak sokkal konzervatívabbá kell válniuk az új kódok bevezetése terén. Az rendben van, ha tudod mondani a "nem" szót, de sok embernek van valódi, jogos igénye. Emiatt a megoldást végül platformmá alakítod át.
207
207
208
-
## Bring in the robots
208
+
## Használj robotokat
209
209
210
-
Just as there are tasks that other people can help you with, there are also tasks that no human should ever have to do. Robots are your friend. Use them to make your life as a maintainer easier.
210
+
Ahogy vannak olyan feladatok, amelyekben mások segítenek, úgy vannak olyan feladatok is, amelyeket nem embereknek kell csinálnia. A robotok a barátaid. Használd őket, hogy megkönnyítsd az életét karbantartóknak.
211
211
212
-
### Require tests and other checks to improve the quality of your code
212
+
### Szükség van tesztekre és egyéb ellenőrzésekre a kód minőségének javítása érdekében
213
213
214
-
One of the most important ways you can automate your project is by adding tests.
214
+
A projekt automatizálásának egyik legfontosabb módja a tesztek hozzáadása.
215
215
216
-
Tests help contributors feel confident that they won't break anything. They also make it easier for you to review and accept contributions quickly. The more responsive you are, the more engaged your community can be.
216
+
A tesztek segítenek a közreműködőknek, hogy biztosak legyenek abban, hogy semmit sem rontanak el. Ezenkívül megkönnyítik az észrevételek gyors áttekintését és elfogadását. Minél jobban és gyorsabban reagálsz, annál elkötelezettebbé válhat a közösség.
217
217
218
-
Set up automatic tests that will run on all incoming contributions, and ensure that your tests can easily be run locally by contributors. Require that all code contributions pass your tests before they can be submitted. You'll help set a minimum standard of quality for all submissions. [Required status checks](https://help.github.com/articles/about-required-status-checks/) on GitHub can help ensure no change gets merged without your tests passing.
218
+
Állíts be automatikus teszteket, amelyek az összes bejövő hozzájárulásra futnak, és győződj meg arról, hogy a teszteket a közreműködők könnyen, a saját gépeiken is futtathatják. Mielőtt beküldenék a hozzájárulásokat, követeld meg, hogy az az összes kódminőségi követelményt teljesítse, minden teszten átmenjen. Itt egy segítség a minimális minőségi követelmények megkövetelésére: [Kötelező ellenőrzések](https://help.github.com/articles/about-required-status-checks/), a GitHub segít abban, hogy ellenőrzés nélkül a hozzájárulás ne kerüljön beolvasztásra.
219
219
220
-
If you add tests, make sure to explain how they work in your CONTRIBUTING file.
220
+
Ha teszteket adsz hozzá, akkor bizonyosodj meg arról, hogy elmagyaráztad azt a CONTRIBUTING.mg fájlban, hogy hogyan működnek.
I believe that tests are necessary for all code that people work on. If the code was fully and perfectly correct, it wouldn't need changes – we only write code when something is wrong, whether that's "It crashes" or "It lacks such-and-such a feature". And regardless of the changes you're making, tests are essential for catching any regressions you might accidentally introduce.
224
+
Úgy gondolom, hogy tesztek szükségesek minden olyan kódhoz, amelyen az emberek dolgoznak. Ha a kód teljesen és tökéletesen helyes volt, akkor nem lenne szükség változtatásokra - csak akkor írunk kódot, ha valami nincs rendben, legyen az összeomlás vagy hiányzó funkció. És függetlenül attól, hogy milyen változtatásokat hajtunk végre, a tesztek elengedhetetlenek a véletlenszerűen bevezetett regressziós hibák kivédésében.
225
225
<pmarkdown="1"class="pquote-credit">
226
-
— @edunham, ["Rust's Community Automation"](https://edunham.net/2016/09/27/rust_s_community_automation.html)
226
+
— @edunham, ["A Rust közösségi automatizálása"](https://edunham.net/2016/09/27/rust_s_community_automation.html)
227
227
</p>
228
228
</aside>
229
229
230
-
### Use tools to automate basic maintenance tasks
230
+
### Használj eszközöket az alapvető karbantartási feladatok automatizálásához
231
231
232
-
The good news about maintaining a popular project is that other maintainers have probably faced similar issues and built a solution for it.
232
+
A jó hír egy népszerű projekt fenttartásához az, hogy más karbantartók valószínűleg hasonló problémákkal már szembesültek és megoldást találtak rá.
233
233
234
-
There are a [variety of tools available](https://github.com/showcases/tools-for-open-source)to help automate some aspects of maintenance work. A few examples:
234
+
[Számos eszköz elérhető](https://github.com/showcases/tools-for-open-source)amelyek a karbantartók munkájának különböző részeit automatizálják. Néhány példa:
235
235
236
-
*[semantic-release](https://github.com/semantic-release/semantic-release)automates your releases
237
-
*[mention-bot](https://github.com/facebook/mention-bot)mentions potential reviewers for pull requests
*[no-response](https://github.com/probot/no-response)closes issues where the author hasn't responded to a request for more information
240
-
*[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
236
+
*[semantic-release](https://github.com/semantic-release/semantic-release)automatizálja a release-elést
237
+
*[mention-bot](https://github.com/facebook/mention-bot)a beolvasztási kérelemben megemlíti automatikusan a lehetséges embereket, akik a kódot majd átnézik (kód review)
238
+
*[Danger](https://github.com/danger/danger)segít automatizálni a kód review-t
239
+
*[no-response](https://github.com/probot/no-response)lezárja azokat az issue-kat, amelyekben az issue szerzője nem válaszolt a további információkérésre
240
+
*[dependabot-preview](https://github.com/marketplace/dependabot-preview)minden nap ellenőrzi a függőségeket, ha talál frissebb verziót, akkor automatikusan beolvasztási kérelmet készít az új verzió számmal
241
241
242
-
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. @TalAtermade a [Choose Your Own Adventure guide](https://www.talater.com/open-source-templates/#/)to help you write your issue and PR templates.
242
+
A hiba jelzésekhez és más általános hozzájárulásokhoz a GitHub biztosít egy [hiba jelzés és beolvasztási kérelem formanyomtatványt](https://github.com/blog/2111-issue-and-pull-request-templates), amellyel egyszerűsíteni és egységesíteni tudod ezek beadását. @TalAterkészített egy [Választásos Kalandjátékot](https://www.talater.com/open-source-templates/#/)hogy segítse ezen formanyomtatványok elkészítését.
243
243
244
-
To manage your email notifications, you can set up [email filters](https://github.com/blog/2203-email-updates-about-your-own-activity)to organize by priority.
244
+
Az email értesítések kezeléséhez be tudod állítani az [email szűrőket](https://github.com/blog/2203-email-updates-about-your-own-activity)amellyel a priorítás megadható.
245
245
246
-
If you want to get a little more advanced, style guides and linters can standardize project contributions and make them easier to review and accept.
246
+
Ha még jobban akarod csinálni, akkor a stílus útmutatók és linterek segítenek abban, hogy a hozzájárulások könnyebben áttekinthetőbbek és beolvaszthatók legyenek.
247
247
248
-
However, if your standards are too complicated, they can increase the barriers to contribution. Make sure you're only adding enough rules to make everyone's lives easier.
248
+
Ellenben, ha a szabályok túl komplikáltak, akkor akadályozzák a hozzájárulást a projekthez. Figyelj arra, hogy annyi szabályt adj hozzá, amely feltétlenül szükséges ahhoz, hogy mindenkinek könnyebb legyen az élete.
249
249
250
-
If you're not sure which tools to use, look at what other popular projects do, especially those in your ecosystem. For example, what does the contribution process look like for other Node modules? Using similar tools and approaches will also make your process more familiar to your target contributors.
250
+
Ha nem vagy biztos abban milyen eszközt kellene használnod, akkor nézz meg más, ismert projekteket, különösen a te ökoszisztémádhoz tartozók közül. Például megnézheted, hogy hogyan néz ki egy hozzájárulási folyamat más Node modulok esetén? Hasonló eszközök és megközelítések alkalmazása segít abban, hogy a folyamatod a hozzájárulók számára már ismert legyen.
0 commit comments