Το “τι” και το “γιατί” του ανοικτού κώδικα
Σκέφτεστε λοιπόν να ξεκινήσετε με τον ανοιχτό κώδικα; Συγχαρητήρια! Ο κόσμος εκτιμά τη συνεισφορά σας. Ας μιλήσουμε για το τι είναι ο ανοιχτός κώδικας και γιατί οι άνθρωποι το κάνουν.
Τι σημαίνει “ανοιχτός κώδικας”;
Όταν ένα πρότζεκτ είναι ανοικτού κώδικα, αυτό σημαίνει ότι ο καθένας είναι ελεύθερος να χρησιμοποιήσει, να μελετήσει, να τροποποιήσει και να διανείμει το πρότζεκτ σας για οποιονδήποτε σκοπό. Αυτά τα δικαιώματα επιβάλλονται μέσω μιας άδειας ανοικτού κώδικα.
Ο ανοικτός κώδικας είναι ισχυρός επειδή μειώνει τα εμπόδια στην υιοθέτηση και τη συνεργασία, επιτρέποντας στους ανθρώπους να διαδίδουν και να βελτιώνουν πρότζεκτ γρήγορα. Επίσης, επειδή δίνει στους χρήστες τη δυνατότητα να ελέγχουν τους υπολογιστές τους, σε σχέση με τον κλειστό κώδικα. Για παράδειγμα, μια επιχείρηση που χρησιμοποιεί λογισμικό ανοικτού κώδικα έχει τη δυνατότητα να προσλάβει κάποιον για να κάνει προσαρμοσμένες βελτιώσεις στο λογισμικό, αντί να βασίζεται αποκλειστικά στις αποφάσεις ενός προμηθευτή κλειστού κώδικα για το προϊόν.
Το ελεύθερο λογισμικό αναφέρεται στο ίδιο σύνολο πρότζεκτ με το ανοικτού κώδικα. Μερικές φορές θα δείτε επίσης αυτούς τους όρους συνδυασμένους ως “ελεύθερο λογισμικό και λογισμικό ανοικτού κώδικα” (FOSS) ή “ελεύθερο, ελεύθερο και λογισμικό ανοικτού κώδικα” (FLOSS). Τα Free και libre αναφέρονται στην ελευθερία, όχι στην τιμή.
Γιατί οι άνθρωποι ανοίγουν το λογισμικό τους;
Υπάρχουν πολλοί λόγοι για τους οποίους ένα άτομο ή ένας οργανισμός θα ήθελε να ανοίξει τον κώδικα ενός έργου. Μερικά παραδείγματα περιλαμβάνουν:
-
Συνεργασία: Τα πρότζεκτ ανοικτού κώδικα μπορούν να δέχονται αλλαγές από οποιονδήποτε στον κόσμο. Το Exercism, για παράδειγμα, είναι μια πλατφόρμα ασκήσεων προγραμματισμού με πάνω από 350 συνεισφέροντες.
-
Υιοθέτηση και επανασύνθεση: Τα πρότζεκτ ανοικτού κώδικα μπορούν να χρησιμοποιηθούν από οποιονδήποτε για σχεδόν οποιονδήποτε σκοπό. Οι άνθρωποι μπορούν ακόμη και να τα χρησιμοποιήσουν για να κατασκευάσουν άλλα πράγματα. Το WordPress, για παράδειγμα, ξεκίνησε ως διακλάδωση ενός υπάρχοντος έργου που ονομαζόταν b2.
-
Διαφάνεια: Οποιοσδήποτε μπορεί να επιθεωρήσει ένα πρότζεκτ ανοικτού κώδικα για λάθη ή ασυνέπειες. Η διαφάνεια έχει σημασία για κυβερνήσεις όπως η Βουλγαρία ή οι Ηνωμένες Πολιτείες, ρυθμιζόμενες βιομηχανίες όπως οι τράπεζες ή η υγειονομική περίθαλψη και λογισμικό ασφαλείας όπως το Let’s Encrypt.
Ο ανοικτός κώδικας δεν είναι μόνο για το λογισμικό. Μπορείτε να ανοίξετε τα πάντα, από σύνολα δεδομένων μέχρι βιβλία. Ελέγξτε το GitHub Explore για ιδέες σχετικά με το τι άλλο μπορείτε να ανοίξετε με ανοικτό κώδικα.
Ανοιχτός κώδικας σημαίνει “δωρεάν”;
Ένα από τα μεγαλύτερα πλεονεκτήματα του ανοικτού κώδικα είναι ότι δεν κοστίζει χρήματα. Το “δωρεάν”, ωστόσο, είναι ένα υποπροϊόν της συνολικής αξίας του ανοικτού κώδικα.
Επειδή μια άδεια χρήσης ανοικτού κώδικα απαιτεί ότι ο καθένας μπορεί να χρησιμοποιήσει, να τροποποιήσει και να μοιραστεί το πρότζεκτ σας για σχεδόν οποιονδήποτε σκοπό, τα ίδια τα πρότζεκτ τείνουν να είναι δωρεάν. Αν το πρότζεκτ κόστιζε χρήματα για τη χρήση του, ο καθένας θα μπορούσε νόμιμα να δημιουργήσει ένα αντίγραφο και να χρησιμοποιήσει τη δωρεάν έκδοση αντί αυτού.
Ως αποτέλεσμα, τα περισσότερα πρότζεκτ ανοικτού κώδικα είναι δωρεάν, αλλά το “δωρεάν” δεν αποτελεί μέρος του ορισμού του ανοικτού κώδικα. Υπάρχουν τρόποι να χρεώνετε τα πρότζεκτ ανοικτού κώδικα έμμεσα μέσω διπλής αδειοδότησης ή περιορισμένων χαρακτηριστικών, ενώ παράλληλα εξακολουθούν να συμμορφώνονται με τον επίσημο ορισμό του ανοικτού κώδικα.
Πρέπει να ξεκινήσω το δικό μου πρότζεκτ ανοιχτού κώδικα;
Η σύντομη απάντηση είναι ναι, διότι, ανεξάρτητα από το αποτέλεσμα, το να ξεκινήσετε το δικό σας πρότζεκτ είναι ένας πολύ καλός τρόπος για να μάθετε πώς λειτουργεί ο ανοιχτός κώδικας.
Αν δεν έχετε ποτέ στο παρελθόν ανοίξει ένα πρότζεκτ, μπορεί να έχετε άγχος για το τι θα πει ο κόσμος ή αν θα το προσέξει κανείς. Αν αυτό σας μοιάζει, δεν είστε οι μόνοι!
Η εργασία ανοιχτού κώδικα είναι όπως κάθε άλλη δημιουργική δραστηριότητα, είτε πρόκειται για συγγραφή είτε για ζωγραφική. Μπορεί να αισθάνεστε τρομακτικό να μοιράζεστε τη δουλειά σας με τον κόσμο, αλλά ο μόνος τρόπος για να βελτιωθείτε είναι να εξασκηθείτε - ακόμη και αν δεν έχετε κοινό.
Αν δεν έχετε πειστεί ακόμα, σκεφτείτε για λίγο ποιοι μπορεί να είναι οι στόχοι σας.
Θέτοντας τους στόχους σας
Οι στόχοι μπορούν να σας βοηθήσουν να καταλάβετε τι πρέπει να δουλέψετε, σε τι να πείτε όχι και πού χρειάζεστε βοήθεια από άλλους. Ξεκινήστε ρωτώντας τον εαυτό σας, γιατί κάνω open sourcing αυτό το πρότζεκτ;
Δεν υπάρχει μια σωστή απάντηση σε αυτό το ερώτημα. Μπορεί να έχετε πολλαπλούς στόχους για ένα πρότζεκτ ή διαφορετικά πρότζεκτ με διαφορετικούς στόχους.
Αν ο μόνος σας στόχος είναι να επιδείξετε τη δουλειά σας, μπορεί να μην θέλετε καν συνεισφορές, και μάλιστα να το πείτε αυτό στο README σας. Από την άλλη πλευρά, αν θέλετε συνεισφέροντες, θα επενδύσετε χρόνο σε σαφή τεκμηρίωση και θα κάνετε τους νεοεισερχόμενους να αισθάνονται ευπρόσδεκτοι.
Καθώς το πρότζεκτ σας αναπτύσσεται, η κοινότητά σας μπορεί να χρειάζεται κάτι περισσότερο από τον κώδικα που θα σας παρέχει. Η ανταπόκριση σε ζητήματα, η αναθεώρηση κώδικα και η προώθηση του έργου σας είναι όλα σημαντικά καθήκοντα σε ένα πρότζεκτ ανοικτού κώδικα.
Αν και ο χρόνος που αφιερώνετε σε εργασίες που δεν σχετίζονται με τον προγραμματισμό εξαρτάται από το μέγεθος και το πεδίο εφαρμογής του έργου σας, θα πρέπει να είστε προετοιμασμένοι ως συντηρητής να τις αντιμετωπίσετε μόνοι σας ή να βρείτε κάποιον να σας βοηθήσει.
Αν ανήκετε σε μια εταιρεία με ανοικτό sourcing ενός έργου, βεβαιωθείτε ότι το πρότζεκτ σας διαθέτει τους εσωτερικούς πόρους που χρειάζεται για να ευδοκιμήσει. Θα πρέπει να προσδιορίσετε ποιος είναι υπεύθυνος για τη συντήρηση του έργου μετά την έναρξη και πώς θα μοιραστείτε αυτά τα καθήκοντα με την κοινότητά σας.
Αν χρειάζεστε ειδικό προϋπολογισμό ή προσωπικό για την προώθηση, τις λειτουργίες και τη συντήρηση του έργου, ξεκινήστε τις συζητήσεις αυτές από νωρίς.
Συμβολή σε άλλα πρότζεκτ
Αν ο στόχος σας είναι να μάθετε πώς να συνεργάζεστε με άλλους ή να κατανοήσετε πώς λειτουργεί ο ανοιχτός κώδικας, σκεφτείτε να συνεισφέρετε σε ένα υπάρχον πρότζεκτ. Ξεκινήστε με ένα πρότζεκτ που ήδη χρησιμοποιείτε και αγαπάτε. Η συνεισφορά σε ένα πρότζεκτ μπορεί να είναι τόσο απλή όσο η διόρθωση τυπογραφικών λαθών ή η ενημέρωση της τεκμηρίωσης.
Αν δεν είστε σίγουροι για το πώς να ξεκινήσετε να συνεισφέρετε, ανατρέξτε στον οδηγό μας Πώς να συνεισφέρετε στον Ανοιχτό Κώδικα.
Ξεκινώντας το δικό σας πρότζεκτ ανοιχτού κώδικα
Δεν υπάρχει ιδανική στιγμή για να ανοίξετε το πρότζεκτ σας. Μπορείτε να ανοίξετε τον κώδικα μιας ιδέας, μιας εργασίας σε εξέλιξη ή μετά από χρόνια κλειστού κώδικα.
Σε γενικές γραμμές, θα πρέπει να ανοίγετε το πρότζεκτ σας όταν αισθάνεστε άνετα να αφήσετε άλλους να δουν και να δώσουν ανατροφοδότηση σχετικά με το πρότζεκτ σας.
Ανεξάρτητα από το στάδιο στο οποίο θα αποφασίσετε να ανοίξετε το πρότζεκτ σας, κάθε πρότζεκτ θα πρέπει να περιλαμβάνει την ακόλουθη τεκμηρίωση:
Ως συντηρητής, αυτά τα στοιχεία θα σας βοηθήσουν να επικοινωνήσετε τις προσδοκίες, να διαχειριστείτε τις συνεισφορές και να προστατεύσετε τα νομικά δικαιώματα όλων (συμπεριλαμβανομένων των δικών σας). Αυξάνουν σημαντικά τις πιθανότητές σας να έχετε μια θετική εμπειρία.
Εάν το πρότζεκτ σας βρίσκεται στο GitHub, η τοποθέτηση αυτών των αρχείων στον ριζικό σας κατάλογο με τα συνιστώμενα ονόματα αρχείων θα βοηθήσει το GitHub να τα αναγνωρίσει και να τα εμφανίσει αυτόματα στους αναγνώστες σας.
Επιλέγοντας μια άδεια
Μια άδεια ανοικτού κώδικα εγγυάται ότι άλλοι μπορούν να χρησιμοποιούν, να αντιγράφουν, να τροποποιούν και να συνεισφέρουν στο πρότζεκτ σας χωρίς επιπτώσεις. Σας προστατεύει επίσης από δύσκολες νομικές καταστάσεις. Πρέπει να συμπεριλάβετε μια άδεια χρήσης όταν ξεκινάτε ένα πρότζεκτ ανοικτού κώδικα.
Η νομική εργασία δεν είναι διασκεδαστική. Τα καλά νέα είναι ότι μπορείτε να αντιγράψετε και να επικολλήσετε μια υπάρχουσα άδεια χρήσης στο αποθετήριό σας. Θα χρειαστεί μόνο ένα λεπτό για να προστατέψετε τη σκληρή δουλειά σας.
Οι MIT, Apache 2.0 και GPLv3 είναι οι πιο δημοφιλείς άδειες ανοικτού κώδικα, αλλά υπάρχουν και άλλες επιλογές για να επιλέξετε.
Όταν δημιουργείτε ένα νέο πρότζεκτ στο GitHub, σας δίνεται η δυνατότητα να επιλέξετε μια άδεια χρήσης. Η συμπερίληψη μιας άδειας ανοικτού κώδικα θα καταστήσει το πρότζεκτ σας στο GitHub ανοικτού κώδικα.
Αν έχετε άλλες ερωτήσεις ή ανησυχίες σχετικά με τις νομικές πτυχές της διαχείρισης ενός έργου ανοικτού κώδικα, σας καλύπτουμε.
Γράφοντας ένα README
Τα READMEs κάνουν περισσότερα από το να εξηγούν πώς να χρησιμοποιήσετε το πρότζεκτ σας. Εξηγούν επίσης γιατί το πρότζεκτ σας έχει σημασία και τι μπορούν να κάνουν οι χρήστες σας με αυτό.
Στο README σας, προσπαθήστε να απαντήσετε στις ακόλουθες ερωτήσεις:
- Τι κάνει αυτό το πρότζεκτ;
- Γιατί είναι χρήσιμο αυτό το πρότζεκτ;
- Πώς μπορώ να ξεκινήσω;
- Πού μπορώ να βρω περισσότερη βοήθεια, αν τη χρειαστώ;
Μπορείτε να χρησιμοποιήσετε το README για να απαντήσετε σε άλλες ερωτήσεις, όπως πώς χειρίζεστε τις συνεισφορές, ποιοι είναι οι στόχοι του έργου και πληροφορίες σχετικά με τις άδειες χρήσης και την απόδοση. Αν δεν θέλετε να δέχεστε συνεισφορές ή αν το πρότζεκτ σας δεν είναι ακόμα έτοιμο για παραγωγή, γράψτε αυτές τις πληροφορίες.
Μερικές φορές, οι άνθρωποι αποφεύγουν να γράψουν ένα README επειδή αισθάνονται ότι το πρότζεκτ είναι ημιτελές ή δεν θέλουν συνεισφορές. Όλοι αυτοί είναι πολύ καλοί λόγοι για να γράψετε ένα τέτοιο κείμενο.
Για περισσότερη έμπνευση, δοκιμάστε να χρησιμοποιήσετε τον “Make a README” guide του @dguo ή το README template του @PurpleBooth για να γράψετε ένα πλήρες README.
Όταν συμπεριλαμβάνετε ένα αρχείο README στον ριζικό κατάλογο, το GitHub θα το εμφανίσει αυτόματα στην αρχική σελίδα του αποθετηρίου.
Γράφοντας τις κατευθυντήριες γραμμές συνεισφοράς σας
Ένα αρχείο CONTRIBUTING λέει στο κοινό σας πώς να συμμετάσχει στο πρότζεκτ σας. Για παράδειγμα, θα μπορούσατε να συμπεριλάβετε πληροφορίες σχετικά με:
- Πώς να καταθέσετε μια αναφορά σφάλματος (δοκιμάστε να χρησιμοποιήσετε τα πρότυπα issue και pull request)
- Πώς να προτείνετε ένα νέο χαρακτηριστικό
- Πώς να ρυθμίσετε το περιβάλλον σας και να εκτελέσετε δοκιμές
Εκτός από τις τεχνικές λεπτομέρειες, ένα αρχείο ΣΥΜΒΟΛΗΣ είναι μια ευκαιρία να επικοινωνήσετε τις προσδοκίες σας για τις συνεισφορές, όπως:
- Τα είδη των συνεισφορών που αναζητάτε
- Ο οδικός χάρτης ή το όραμά σας για το πρότζεκτ
- Πώς οι συνεργάτες θα πρέπει (ή δεν θα πρέπει) να έρθουν σε επαφή μαζί σας
Χρησιμοποιώντας ένα ζεστό, φιλικό τόνο και προσφέροντας συγκεκριμένες προτάσεις για συνεισφορές (όπως η συγγραφή τεκμηρίωσης ή η δημιουργία ενός ιστότοπου) μπορείτε να κάνετε τους νεοεισερχόμενους να αισθάνονται ευπρόσδεκτοι και ενθουσιασμένοι να συμμετάσχουν.
Για παράδειγμα, το Active Admin ξεκινά τον οδηγό συνεισφοράς του με:
Πρώτα απ’ όλα, σας ευχαριστώ που σκέφτεστε να συνεισφέρετε στο Active Admin. Είναι άνθρωποι σαν εσάς που κάνουν το Active Admin ένα τόσο σπουδαίο εργαλείο.
Στα πρώτα στάδια του έργου σας, το αρχείο CONTRIBUTING μπορεί να είναι απλό. Θα πρέπει πάντα να εξηγείτε πώς να αναφέρετε σφάλματα ή θέματα αρχείων, καθώς και τυχόν τεχνικές απαιτήσεις (όπως δοκιμές) για να κάνετε μια συνεισφορά.
Με την πάροδο του χρόνου, μπορεί να προσθέσετε και άλλες συχνές ερωτήσεις στο αρχείο ΣΥΝΔΡΟΜΗ. Η καταγραφή αυτών των πληροφοριών σημαίνει ότι λιγότεροι άνθρωποι θα σας κάνουν τις ίδιες ερωτήσεις ξανά και ξανά.
Για περισσότερη βοήθεια σχετικά με τη σύνταξη του αρχείου CONTRIBUTING, δείτε το πρότυπο οδηγού συνεισφοράς του @nayafia ή το “How to Build a CONTRIBUTING.md” του @mozilla.
Συνδέστε το αρχείο CONTRIBUTING από το README, ώστε να το βλέπουν περισσότεροι άνθρωποι. Εάν τοποθετήσετε το αρχείο CONTRIBUTING στο αποθετήριο του έργου σας, το GitHub θα συνδέει αυτόματα το αρχείο σας όταν ένας συνεργάτης δημιουργεί ένα ζήτημα ή ανοίγει ένα pull request.
Καθιέρωση κώδικα δεοντολογίας
Τέλος, ένας κώδικας δεοντολογίας βοηθά στον καθορισμό βασικών κανόνων συμπεριφοράς για τους συμμετέχοντες στο πρότζεκτ σας. Αυτό είναι ιδιαίτερα πολύτιμο αν ξεκινάτε ένα πρότζεκτ ανοικτού κώδικα για μια κοινότητα ή μια εταιρεία. Ένας κώδικας δεοντολογίας σας δίνει τη δυνατότητα να διευκολύνετε την υγιή, εποικοδομητική συμπεριφορά της κοινότητας, γεγονός που θα μειώσει το άγχος σας ως συντηρητής.
Για περισσότερες πληροφορίες, ανατρέξτε στον οδηγό Κώδικας δεοντολογίας.
Εκτός από το να γνωστοποιεί πώς περιμένετε από τους συμμετέχοντες να συμπεριφέρονται, ένας κώδικας συμπεριφοράς τείνει επίσης να περιγράφει ποιους αφορούν αυτές οι προσδοκίες, πότε ισχύουν και τι πρέπει να γίνει σε περίπτωση παραβίασης.
Όπως οι άδειες ανοικτού κώδικα, έτσι και για τους κώδικες δεοντολογίας υπάρχουν αναδυόμενα πρότυπα, ώστε να μην χρειάζεται να γράψετε τους δικούς σας. Το Contributor Covenant είναι ένας drop-in κώδικας συμπεριφοράς που χρησιμοποιείται από πάνω από 40.000 πρότζεκτ ανοικτού κώδικα, συμπεριλαμβανομένων των Kubernetes, Rails και Swift. Ανεξάρτητα από το κείμενο που χρησιμοποιείτε, θα πρέπει να είστε προετοιμασμένοι να επιβάλλετε τον κώδικα συμπεριφοράς σας όταν είναι απαραίτητο.
Επικολλήστε το κείμενο απευθείας σε ένα αρχείο CODE_OF_CONDUCT στο αποθετήριό σας. Κρατήστε το αρχείο στο ριζικό κατάλογο του έργου σας, ώστε να είναι εύκολο να το βρείτε, και παραπέμψτε σε αυτό από το README σας.
Ονομασία και branding του έργου σας
Το branding είναι κάτι περισσότερο από ένα φανταχτερό λογότυπο ή ένα πιασάρικο όνομα έργου. Έχει να κάνει με το πώς μιλάτε για το πρότζεκτ σας και σε ποιον απευθύνεστε με το μήνυμά σας.
Επιλέγοντας το σωστό όνομα
Διαλέξτε ένα όνομα που να είναι εύκολο να το θυμάστε και, ιδανικά, να δίνει μια ιδέα για το τι κάνει το πρότζεκτ. Για παράδειγμα:
- Sentry παρακολουθεί τις εφαρμογές για αναφορά ατυχημάτων
- Thin είναι ένας γρήγορος και απλός διακομιστής ιστοσελίδων Ruby
Αν βασίζεστε σε ένα υπάρχον πρότζεκτ, η χρήση του ονόματός του ως πρόθεμα μπορεί να βοηθήσει να αποσαφηνιστεί τι κάνει το πρότζεκτ σας (για παράδειγμα, το node-fetch φέρνει το window.fetch στο Node.js).
Σκεφτείτε πάνω απ’ όλα τη σαφήνεια. Τα λογοπαίγνια είναι διασκεδαστικά, αλλά να θυμάστε ότι ορισμένα αστεία μπορεί να μη μεταφράζονται σε άλλους πολιτισμούς ή σε ανθρώπους με διαφορετικές εμπειρίες από εσάς. Ορισμένοι από τους δυνητικούς χρήστες σας μπορεί να είναι υπάλληλοι της εταιρείας: δεν θέλετε να τους κάνετε να νιώσουν άβολα όταν θα πρέπει να εξηγήσουν το πρότζεκτ σας στη δουλειά!
Αποφυγή συγκρούσεων ονομάτων
Ελέγξτε για πρότζεκτ ανοικτού κώδικα με παρόμοιο όνομα, ειδικά αν μοιράζεστε την ίδια γλώσσα ή το ίδιο οικοσύστημα. Εάν το όνομά σας συμπίπτει με ένα δημοφιλές υπάρχον πρότζεκτ, μπορεί να προκαλέσετε σύγχυση στο κοινό σας.
Αν θέλετε έναν ιστότοπο, μια λαβή στο Twitter ή άλλες ιδιότητες που θα αντιπροσωπεύουν το πρότζεκτ σας, βεβαιωθείτε ότι μπορείτε να πάρετε τα ονόματα που θέλετε. Ιδανικά, κρατήστε αυτά τα ονόματα τώρα για να είστε ήσυχοι, ακόμη και αν δεν σκοπεύετε να τα χρησιμοποιήσετε ακόμη.
Βεβαιωθείτε ότι το όνομα του έργου σας δεν παραβιάζει κανένα εμπορικό σήμα. Μια εταιρεία μπορεί να σας ζητήσει αργότερα να καταργήσετε το πρότζεκτ σας ή ακόμη και να κινηθεί νομικά εναντίον σας. Δεν αξίζει τον κόπο να το ρισκάρετε.
Μπορείτε να ελέγξετε τη WIPO Global Brand Database για συγκρούσεις εμπορικών σημάτων. Αν είστε σε μια εταιρεία, αυτό είναι ένα από τα πράγματα με τα οποία μπορεί να σας βοηθήσει η νομική ομάδα.
Τέλος, κάντε μια γρήγορη αναζήτηση στο Google για το όνομα του έργου σας. Θα μπορούν οι άνθρωποι να βρουν εύκολα το πρότζεκτ σας; Εμφανίζεται κάτι άλλο στα αποτελέσματα της αναζήτησης που δεν θα θέλατε να δουν;
Ο τρόπος που γράφετε (και κωδικοποιείτε) επηρεάζει και το brand σας!
Καθ’ όλη τη διάρκεια του έργου σας, θα γράφετε πολύ: READMEs, tutorials, έγγραφα της κοινότητας, απαντήσεις σε θέματα, ίσως ακόμη και ενημερωτικά δελτία και λίστες αλληλογραφίας.
Είτε πρόκειται για επίσημη τεκμηρίωση είτε για ένα απλό μήνυμα ηλεκτρονικού ταχυδρομείου, το στυλ γραφής σας αποτελεί μέρος της επωνυμίας του έργου σας. Σκεφτείτε πώς θα μπορούσατε να φανείτε στο κοινό σας και αν αυτός είναι ο τόνος που θέλετε να μεταδώσετε.
Η χρήση θερμής, περιεκτικής γλώσσας (όπως “τους”, ακόμη και όταν αναφέρεται σε ένα άτομο) μπορεί να συμβάλει σημαντικά στο να γίνει το πρότζεκτ σας φιλόξενο για τους νέους συνεισφέροντες. Μείνετε σε απλή γλώσσα, καθώς πολλοί από τους αναγνώστες σας μπορεί να μην έχουν ως μητρική γλώσσα τα αγγλικά.
Πέρα από τον τρόπο που γράφετε λέξεις, το στυλ κωδικοποίησης μπορεί επίσης να γίνει μέρος της επωνυμίας του έργου σας. Το Angular και το jQuery είναι δύο παραδείγματα πρότζεκτ με αυστηρό στυλ κωδικοποίησης και κατευθυντήριες γραμμές.
Δεν είναι απαραίτητο να γράψετε έναν οδηγό στυλ για το πρότζεκτ σας όταν ξεκινάτε, και μπορεί να διαπιστώσετε ότι σας αρέσει να ενσωματώνετε διαφορετικά στυλ κωδικοποίησης στο πρότζεκτ σας ούτως ή άλλως. Θα πρέπει όμως να προβλέψετε πώς το στυλ γραφής και κωδικοποίησης που χρησιμοποιείτε μπορεί να προσελκύσει ή να αποθαρρύνει διαφορετικούς τύπους ανθρώπων. Τα πρώτα στάδια του έργου σας είναι η ευκαιρία σας να δημιουργήσετε το προηγούμενο που επιθυμείτε.
Ο κατάλογος ελέγχου πριν από την έναρξη
Είστε έτοιμοι να ανοίξετε το πρότζεκτ σας; Ακολουθεί ένας κατάλογος ελέγχου για να σας βοηθήσει. Έχετε τσεκάρει όλα τα κουτάκια; Είστε έτοιμοι να ξεκινήσετε! Κάντε κλικ στο “publish” και χτυπήστε τον εαυτό σας στην πλάτη.
Έγγραφα
Κώδικας
Άνθρωποι
Αν είστε άτομο:
Εάν είστε εταιρεία ή οργανισμός:
Τα καταφέρατε!
Συγχαρητήρια για την ανοιχτή διάθεση του πρώτου σας έργου. Ανεξάρτητα από το αποτέλεσμα, η δημόσια εργασία είναι ένα δώρο στην κοινότητα. Με κάθε δέσμευση, σχόλιο και pull request, δημιουργείτε ευκαιρίες για τον εαυτό σας και για τους άλλους να μάθουν και να αναπτυχθούν.
