Φήμη

Μάθε για το σύστημα φήμης.

Η φήμη είναι το σύστημα που επιτρέπει στους ανθρώπους να αποκτούν "εμπιστοσύνη" μέσα στο οικοσύστημα του Exercism.

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

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

Σκοπός

Ο σκοπός του συστήματος φήμης είναι:

  1. Να μεγιστοποιεί τις αλληλεπιδράσεις που εστιάζουν στην πρόοδο ανάμεσα σε μαθητές και καθοδηγητές
  2. Να μεγιστοποιεί τη διάθεση των καθοδηγητών να συνεισφέρουν

Απόκτηση φήμης

Η φήμη μπορεί να αποκτηθεί με πολλούς τρόπους:

Ενέργεια Φήμη
Επιτυχής καθοδήγηση σε μια λύση 5
Δημοσίευση λύσης 1-3
Συγγραφή άσκησης 20
Ενημέρωση άσκησης 10
Συγγραφή έννοιας 10
Ενημέρωση έννοιας 5
Δημιουργία pull request 3-100
Αξιολόγηση pull request 1-20
Συγχώνευση pull request 1-5

Επιτυχής καθοδήγηση σε μια λύση

Για κάθε λύση που καθοδηγήθηκε με επιτυχία (η συζήτηση ολοκληρώθηκε), απονέμονται 5 μονάδες φήμης.

Δημοσίευση λύσης

Για κάθε δημοσιευμένη λύση, η φήμη που απονέμεται εξαρτάται από τη δυσκολία της άσκησης:

Ετικέτα Φήμη
easy 1
medium 2
hard 3

Συγγραφή άσκησης

Για κάθε άσκηση όπου ο χρήστης αναφέρεται ως συγγραφέας, απονέμονται 20 μονάδες φήμης.

Ενημέρωση άσκησης

Για κάθε άσκηση όπου ο χρήστης αναφέρεται ως συνεισφέρων, απονέμονται 10 μονάδες φήμης.

Συγγραφή έννοιας

Για κάθε έννοια όπου ο χρήστης αναφέρεται ως συγγραφέας, απονέμονται 10 μονάδες φήμης.

Ενημέρωση έννοιας

Για κάθε έννοια όπου ο χρήστης αναφέρεται ως συνεισφέρων, απονέμονται 5 μονάδες φήμης.

Δημιουργία pull request

Από προεπιλογή, απονέμονται 12 μονάδες φήμης όταν συγχωνεύεται ένα pull request που άνοιξε ο χρήστης.

Ανάλογα με το περιεχόμενο του pull request, ένας συντηρητής μπορεί να απονείμει περισσότερη (ή λιγότερη) φήμη προσθέτοντας στο pull request μία από τις παρακάτω ετικέτες:

Ετικέτα Φήμη Παραδείγματα
x:rep/tiny 3
  • Διόρθωση ενός μόνο τυπογραφικού λάθους ή ενός συνδέσμου
  • Αφαίρεση μιας κενής γραμμής ή προσθήκη μιας αλλαγής γραμμής
  • Αλλαγή ή προσθήκη ενός μόνο σχολίου κώδικα
x:rep/small 5
  • Διόρθωση μίας μόνο περίπτωσης δοκιμής, εργασίας ή παραδείγματος
  • Διόρθωση πολλών τυπογραφικών λαθών ή συνδέσμων σε ένα μόνο αρχείο
  • Αποσαφήνιση περιεχομένου με την προσθήκη λίγων γραμμών σε ένα αρχείο
x:rep/medium 12
  • Συγχρονισμός μιας άσκησης με τις problem-specifications (συμπεριλαμβανομένων των αλλαγών)
  • Προσθήκη μίας ή περισσότερων περιπτώσεων δοκιμής από το μηδέν
  • Βελτίωση πολλών αρχείων σε μια άσκηση
  • Προσθήκη σημειώσεων καθοδηγητή για μια άσκηση από το μηδέν
  • Διόρθωση ενός μικρού bug σε ένα test runner/analyzer/representer
  • Προσθήκη σχολίων analyzer για μία μόνο άσκηση
x:rep/large 30
  • Προσθήκη μιας νέας άσκησης έννοιας ή άσκησης εξάσκησης
  • Προσθήκη νέας τεκμηρίωσης έννοιας
  • Σημαντική επανεγγραφή μιας υπάρχουσας έννοιας ή άσκησης
  • Προσθήκη νέων scripts CI ή άλλου αυτοματισμού
x:rep/massive 100
  • Δημιουργία ενός test runner, analyzer, representer ή generator από το μηδέν
  • Μεγάλες αναδιαμορφώσεις σε αυτά τα εργαλεία
  • Δημιουργία σημαντικής τεκμηρίωσης από το μηδέν (π.χ. οδηγοί συνεισφοράς ή δοκιμών)

Τα παραπάνω παραδείγματα μπορούν να χρησιμεύσουν ως μια χονδρική ένδειξη για το πότε ταιριάζει κάθε ετικέτα, αλλά οι συντηρητές είναι ελεύθεροι να κρίνουν οι ίδιοι.

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

Για λόγους συμβατότητας προς τα πίσω, υποστηρίζουμε επίσης τη χρήση των ετικετών x:size για τον καθορισμό της φήμης που απονέμεται.

Αξιολόγηση pull request

Για κάθε συγχωνευμένο ή κλειστό pull request που αξιολογήθηκε από τον χρήστη, απονέμονται 5 μονάδες φήμης.

  • Αν ένα pull request είναι ακόμα ανοιχτό, δεν απονέμεται φήμη (ακόμα).

  • Η φήμη για αξιολόγηση απονέμεται μόνο μία φορά ανά χρήστη και ανά pull request.

  • Ο χρήστης που άνοιξε το pull request δεν παίρνει φήμη για την αξιολόγηση του δικού του pull request.

  • Η φήμη που απονέμεται για την αξιολόγηση ενός pull request αλλάζει αν προστεθεί στο pull request μία από τις παρακάτω ετικέτες:

    Ετικέτα Φήμη
    x:rep/tiny 1
    x:rep/small 2
    x:rep/medium 5
    x:rep/large 10
    x:rep/massive 20

    Δεν είναι δυνατόν να χρησιμοποιηθούν διαφορετικά "μεγέθη" φήμης για τον συγγραφέα και τον αξιολογητή ενός pull request. Και τα δύο βασίζονται στην ίδια ετικέτα x:rep.

    Αν οριστούν περισσότερες από μία ετικέτες, η ετικέτα με τη μεγαλύτερη τιμή φήμης καθορίζει τη φήμη που απονέμεται.

    Για λόγους συμβατότητας προς τα πίσω, υποστηρίζουμε επίσης τη χρήση των ετικετών x:size για τον καθορισμό της φήμης που απονέμεται.

Συγχώνευση pull request

Για κάθε pull request που συγχωνεύτηκε από τον χρήστη, απονέμεται 1 μονάδα φήμης.

  • Αν ένα pull request είναι ακόμα ανοιχτό, δεν απονέμεται φήμη (ακόμα).
  • Αν ένα pull request κλείσει χωρίς να συγχωνευτεί, δεν απονέμεται φήμη.
  • Ο χρήστης που άνοιξε το pull request δεν παίρνει φήμη για τη συγχώνευση του δικού του pull request.
  • Αν το pull request δεν έχει καμία αξιολόγηση, τότε απονέμονται 5 μονάδες φήμης αντ' αυτού.

Άνοιγμα issue

Όπως και με τα pull requests, από προεπιλογή δεν απονέμεται φήμη όταν ανοίγει ένα issue. Σε αντίθεση με τα pull requests, φήμη απονέμεται μόνο για μεγάλα ή τεράστια issues.

Ανάλογα με το περιεχόμενο του issue, ένας συντηρητής μπορεί να επιλέξει να απονείμει φήμη προσθέτοντας στο issue μία από τις παρακάτω ετικέτες:

Ετικέτα Φήμη Παραδείγματα
x:rep/large 30
  • Πλήρως ανεπτυγμένη άσκηση έννοιας
x:rep/massive 100
  • Σχεδιασμός του προγράμματος σπουδών ενός track

Τα παραπάνω παραδείγματα μπορούν να χρησιμεύσουν ως μια χονδρική ένδειξη για το πότε ταιριάζει κάθε ετικέτα, αλλά οι συντηρητές είναι ελεύθεροι να κρίνουν οι ίδιοι.

  • Η φήμη θα πρέπει να αντικατοπτρίζει την προσπάθεια που θα κατέβαλλε ο συντηρητής για να δημιουργήσει το issue.

  • Αν οριστούν περισσότερες από μία ετικέτες, η ετικέτα με τη μεγαλύτερη τιμή φήμης καθορίζει τη φήμη που απονέμεται.