castopod/docs/src/el/contributing/guidelines.md

5.7 KiB
Raw Blame History

title
Οδηγίες

Συνεισφορά στο Castopod

Αγαπάς το Castopod και θέλεις να βοηθήσεις; Ευχαριστούμε πολύ, υπάρχει κάτι για να κάνεις!

Παρακαλούμε αφιέρωσε λίγο χρόνο για να διαβάσεις αυτό το έγγραφο προκειμένου να διευκολύνεις τη διαδικασία της συνεισφοράς για όλους τους εμπλεκόμενους.

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

::: info Σημείωση

Οποιαδήποτε συνεισφορά που γίνεται σε ένα αποθετήριο εκτός του αρχικού αποθετηρίου δεν θα γίνεται δεκτή.

:::

Χρήση του παρακολουθητή θεμάτων

Ο παρακολουθητής θεμάτων είναι η προτιμώμενη μέθοδος για αναφορές σφαλμάτων, ζητήματα χαρακτηριστικών και υποβολή αιτημάτων ενσωμάτωσης.

⚠️ Θέματα ασφαλείας και ευπάθειες

Εάν αντιμετωπίσετε οποιοδήποτε θέμα ασφαλείας ή ευπάθεια στον πηγαίο κώδικα του Castopod, παρακαλούμε επικοινωνήστε απευθείας μαζί μας μέσω email στο security@castopod.org

Αναφορά σφαλμάτων

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

Οδηγίες για τις αναφορές σφαλμάτων:

  1. Χρησιμοποιήστε την αναζήτηση θεμάτων — ελέγξτε εάν έχει ήδη αναφερθεί το θέμα.

  2. Ελέγξτε εάν το θέμα έχει διορθωθεί — προσπαθήστε να το αναπαράγετε χρησιμοποιώντας το τελευταίο main κλαδί στο αποθετήριο.

  3. Προσδιορίστε το πρόβλημα — ιδανικά δημιουργήστε ένα μειωμένο τεστ κέισ και ένα ζωντανό παράδειγμα.

Μια καλή αναφορά σφάλματος δεν θα αφήσει άλλους να σας κυνηγούν για περισσότερες πληροφορίες. Προσπαθήστε να δώσετε όσο το δυνατό περισσότερες λεπτομέρειες στην αναφορά σας. Ποιο είναι το περιβάλλον σας; Ποια βήματα θα αναπαραγάγουν το πρόβλημα; Ποιος προγραμματιστικός περιηγητής και λειτουργικό σύστημα αντιμετωπίζουν το πρόβλημα; Ποιο είναι το αναμενόμενο αποτέλεσμα; Όλες αυτές οι λεπτομέρειες θα βοηθήσουν άλλους ανθρώπους να επιδιορθώσουν πιθανά σφάλματα.

Δημιουργήθηκαν πρότυπα θεμάτων για αυτό το έργο. Μπορείτε να τα χρησιμοποιήσετε για να σας βοηθήσουν να ακολουθήσετε αυτές τις οδηγίες.

Ζητήματα χαρακτηριστικών

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

Αιτήματα ενσωμάτωσης

Τα καλά αιτήματα ενσωμάτωσης - διορθώσεις, βελτιώσεις, νέα χαρακτηριστικά - είναι μια φανταστική βοήθεια. Θα πρέπει να παραμείνουν συγκεντρωμένα στο πεδίο εφαρμογής και να αποφεύγουν να περιλαμβάνουν άσχετες δεσμεύσεις.

Παρακαλούμε ρωτήστε πρώτα πριν ξεκινήσετ