Νέες Οδηγίες Συνεισφοράς

Αν ένα Issue/PR που έκλεισε αυτόματα σε έφερε εδώ, μην πανικοβληθείς και μην το πάρεις σαν απόρριψη. Τις περισσότερες φορές, όποια δουλειά έχεις κάνει θα ενσωματωθεί τελικά στο Exercism, ή το πρόβλημά σου θα λυθεί. Καλωσορίζουμε και ενθαρρύνουμε τις συνεισφορές, αλλά προτιμάμε να συζητάμε τα πράγματα στο φόρουμ μας πριν πέσουμε στον κώδικα στο GitHub. Ανοίγοντας ένα θέμα στο φόρουμ, τα πράγματα θα προχωρήσουν.

Τον τελευταίο χρόνο, πειραματιζόμαστε με τον περιορισμό των συνεισφορών από μη συντηρητές, ώστε να ελευθερώσουμε χρόνο για τους βασικούς συνεισφέροντες και να τους επιτρέψουμε να κάνουν πιο σημαντικές βελτιώσεις στις διαδρομές. Αυτό λειτούργησε αρκετά καλά. Σε σύγκριση με το 2022, μέσα στο 2023 είδαμε διπλάσιο αριθμό νέων ασκήσεων να προστίθενται και τριπλάσιο αριθμό προγραμμάτων σπουδών να δημιουργούνται. Η αλλαγή μεθοδολογίας επέτρεψε πολύ μεγαλύτερες συνεισφορές, λιγότερη απογοήτευση και λιγότερους περισπασμούς για τους βασικούς συνεισφέροντες.

Ωστόσο, συνειδητοποιώ επίσης ότι δημιούργησε απογοητεύσεις σε νέους συνεισφέροντες που είναι αποφασισμένοι να βοηθήσουν, αλλά νιώθουν μπλοκαρισμένοι από τη διαδικασία συνεισφοράς μας. Έτσι, σήμερα θέλω να προτείνω κάποιες νέες (ή πιο ξεκάθαρες) κατευθυντήριες γραμμές για το πώς θα προχωρήσουμε με τις συνεισφορές τους επόμενους μήνες.

Ο θεμελιώδης κανόνας που πρέπει να καταλάβεις είναι ότι συζητάμε ιδέες, bugs και ζητήματα στο φόρουμ μας και ότι συζητάμε τις αλλαγές που προκύπτουν στον κώδικα στο GitHub (σε PR reviews). Ο δευτερεύων κανόνας είναι ότι (με εξαίρεση τους συντηρητές που είναι αυτόνομοι) συζητάμε τα πράγματα πριν τα κάνουμε. Το φόρουμ μας επιτρέπει σε συνεισφέροντες και συντηρητές από όλες τις διαδρομές να μοιράζονται γνώσεις και σοφία για μια μεγάλη γκάμα γλωσσών και ιδεών, χωρίς να χρειάζεται να εγγραφούν σε 300 διαφορετικά αποθετήρια στο GitHub και να κατακλυστούν από ειδοποιήσεις.

Ενημερωμένες κατευθυντήριες γραμμές

Λήψη υποστήριξης

• Αν κολλήσεις σε κάτι πριν λύσεις μια άσκηση (π.χ. εγκατάσταση της γραμμής εντολών, εκτέλεση των tests, κόλλημα στη λογική ή στις απαιτήσεις μιας άσκησης), οι μηχανισμοί υποστήριξής μας είναι η κατηγορία "Exercism Support" στο φόρουμ και το κανάλι #get-help στον διακομιστή μας στο Discord.
• Δε χρησιμοποιούμε το GitHub ή το email για αιτήματα υποστήριξης.
• Αν έχεις λύσει μια άσκηση αλλά έχεις απορίες γι' αυτήν, καλό είναι να ζητήσεις καθοδήγηση μέσα στο Exercism.

Αναφορά bugs/ζητημάτων

• Όλα τα bugs/ζητήματα πρέπει να ανοίγουν στο φόρουμ μας, όπου πολλοί διαφορετικοί άνθρωποι μπορούν να βοηθήσουν να κατανοηθεί και να λυθεί το πρόβλημα.
  • Αν το ζήτημα έχει να κάνει με κάποια γλώσσα, χρησιμοποίησε την αντίστοιχη κατηγορία Programming/xxx.
  • Αν είναι bug στον ιστότοπο, χρησιμοποίησε την κατηγορία "Bugs & Feature Requests".
• Τα issues στο GitHub θα κλείνουν γενικά αυτόματα και ο χρήστης που τα άνοιξε θα κατευθύνεται στο φόρουμ (με έναν σύνδεσμο ενός κλικ για αντιγραφή/επικόλληση του ζητήματός του, όπως συμβαίνει τώρα).
• Οι συντηρητές διαδρομών μπορούν να επιλέξουν να απενεργοποιήσουν τον αυτόματο κλείσιμο των issues, αλλά η επίσημη διαδρομή παραμένει το φόρουμ.

Άνοιγμα Pull Requests

• Τα Pull Requests πρέπει να συζητιούνται στο φόρουμ πριν γίνει η δουλειά.
• Τα Pull Requests από άτομα εκτός του οργανισμού θα συνεχίσουν να κλείνονται αυτόματα, αλλά συχνά θα ξανανοίγουν μόλις η δουλειά συζητηθεί στο φόρουμ. Αν η ιδέα πίσω από ένα PR έχει ήδη εγκριθεί, απλώς πρόσθεσε έναν σύνδεσμο προς το PR στο σχετικό θέμα του φόρουμ και θα το ξανανοίξουμε.
• Οι συντηρητές διαδρομών μπορούν να επιλέξουν να απενεργοποιήσουν τον αυτόματο κλείσιμο των PR, αλλά εξακολουθούμε να συνιστούμε όλα τα PR να συζητιούνται πρώτα μέσω του φόρουμ.

Σύνοψη

Η πρώτη μας προτεραιότητα παραμένει η προστασία του χρόνου και της ψυχικής ενέργειας των βασικών συνεισφερόντων μας, χωρίς τους οποίους το Exercism δεν μπορεί να λειτουργήσει. Θέλουμε όμως επίσης να διασφαλίσουμε ότι το Exercism παραμένει ένας χώρος όπου νέοι άνθρωποι μπορούν να συμμετάσχουν χωρίς υπερβολικά απαγορευτικά εμπόδια, και όπου μπορούμε να ενθαρρύνουμε και να στηρίζουμε αυτούς τους ανθρώπους ώστε να γίνουν οι ίδιοι βασικοί συνεισφέροντες!

Ανυπομονώ να δω πώς αυτές οι αλλαγές θα επηρεάσουν τις συνεισφορές που θα δούμε τους επόμενους μήνες. Θα τα επανεξετάσουμε στα μέσα του 2024.