Συμμετοχή

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

Θέλετε να κάνετε αλλαγές ή να προσθέσετε νέο περιεχόμενο? Για να βεβαιωθούμε ότι θα υπάρχει συνέπεια με το ήδη δημοσιευμένο περιεχόμενο και για να ελαχιστοποιήσουμε τον χρόνο δημοσίευσης της συνεισφοράς σας θα πρέπει να ακολουθήσετε τα παρακάτω βήματα:

  • Κάντε Fork το αποθετήριο pibookgr στο GitHub
  • Αν θέλετε να αλλάξετε ένα αρχείο που ήδη υπάρχει, τότε δημιουργήστε ένα νέο ξεχωριστό branch με ένα αντιπροσωπευτικό όνομα για κάθε αλλαγή που θέλετε να κάνετε.
  • Αν θέλετε να προσθέσετε νέο περιεχόμενο τότε μπορείτε να ομαδοποιήσετε τις προσθήκες σε ένα κλαδί, π.χ., για δύο νέες εικόνες θα πρέπει να φτιάξετε δύο branches, αντίστοιχα (π.χ., ένα branch για κάθε σετ αρχείων που θα στείλετε)
  • Αν δεν το έχετε ήδη κάνει, επεξεργαστείτε τα στοιχεία του προφίλ σας στο αρχείο authors.yml στον φάκελο _data, έτσι ώστε να φαίνεται το όνομα σας κάτω από το περιεχόμενο που προσθέσατε, αφού πρώτα δημιουργήσετε ένα διακριτό branch μόνο για αυτήν την προσθήκη
  • Επεξεργαστείτε το περιεχόμενο καθώς και όλα τα σχετικά πεδία YAML (π.χ., όνομα αρχείου της φωτογραφίας, λεζάντα, πνευματικά δικαιώματα, κατηγορία, ετικέτες) αφού πρώτα δείτε παρόμοιο περιεχόμενο που είναι ήδη δημοσιευμένο
  • Το περιεχόμενο (π.χ., παράθεση, εικόνα, μελέτη περίπτωσης, κτλ) που θα προσθέσετε θα πρέπει να σχετίζεται με το περιεχόμενο του βιβλίου με χρήση τουλάχιστον μιας κατηγορίας (π.χ. ενότητα βιβλίου) και ετικέτας (π.χ., Apple, Microsoft, κτλ). Ειδικα για τις φωτογραφίες χρειάζεται και μια λεζάντα που είναι συμβατή με το πνεύμα του βιβλίου και με τρόπο τέτοιο ώστε η φωτογραφία μαζί με την λεζάντα να λειτουργούν ως σύνολο με το υπόλοιπο βιβλίο
  • Το περιεχόμενο των πεδίων σε κάποιες περιπτώσεις (π.χ., αν υπάρχουν σημεία στίξης όπως :, ;, “”) θα πρέπει μπαίνει σε ‘’ έτσι ώστε να μην δημιουργεί πρόβλημα
  • Τα ονόματα αρχείων που θα προσθέσετε (π.χ., *.md, *.jpg) θα πρέπει να είναι μόνο με μικρά γράμματα γιατί διαφορετικά θα υπάρχουν ασυνέπειες ανάμεσα σε λειτουργικά συστήματα που είναι ευαίσθητα στα κεφαλαία και σε αυτά που δεν είναι
  • Για την περίπτωση της φωτογραφίας θα πρέπει να δημιουργήστε και μια μικρή έκδοση της εικόνας με πλάτος 160 και να την βάλετε μαζί με την κανονική έκδοση στον αντίστοιχο φάκελο.
  • Δοκιμάστε πρώτα ότι δουλεύει στο αντίγραφο σας (http://yourusername.github.io/pibookgr) και μετά κάντε ένα pull request βάζοντας και ένα σύντομο περιγραφικό σχόλιο για την αλλαγή που κάνατε
  • Το περιεχόμενο του βιβλίου και της ιστοσελίδας σκόπιμα αποφεύγουν τις πιο νέες εξελίξεις και προϊόντα έτσι ώστε το περιεχόμενο να είναι όσο γίνεται πιο διαχρονικό (στον βαθμό του εφικτού). Η έμφαση δίνεται σε παλαιότερα συστήματα, όχι επειδή υπάρχει μια ρετρολαγνεία, αλλά επειδή υπάρχουν διαχρονικές τάσεις που είναι παρούσες και σε σύγχρονα προϊόντα. Φυσικά υπάρχουν εξαιρέσεις για κάποια είδη περιεχομένου και κάποιες κατηγορίες, π.χ., Αρχέτυπα, Κατασκευές.

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

ISBN: 978-618-82423-4-0 · Άδεια Creative Commons