Ξεκινώντας

by 2 contributors:

Εισαγωγή

Η ενασχόληση με το MDN είναι τόσο απλή όσο και η χρήση του browser σας. Εάν έχετε συμπληρώσει μια φόρμα στο web, ή γράψατε σε ένα πλαίσιο κειμένου σε ένα blog, τότε έχετε ήδη όλα τα εφόδια για να ξεκινήσετε.

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

Ενασχόληση με την ιστοσελίδα και την κοινότητα

H κοινότητα της τεκμηρίωσης είναι ένα group που αποτελείτε κυρίως από εθελοντές, με στόχο να παρέχουν χρήσιμη τεκμηρίωση στους χρήστες των προϊόντων Mozilla και του web γενικότερα. Χαιρόμαστε πάντα να βοηθάμε καινούργους εθελοντές να ασχοληθούν και τους ενθαρρύνουμε όλους να συμμετάσχουν στο να κάνουμε αυτή την τεκμηρίωση την καλύτερη δυνατή.

Είναι γνωστό σε όλους μας ότι η συμμετοχή σε νέο group μπορεί να μην είναι τόσο εύκολη, και για τον λόγο αυτό παραθέτουμε την επόμη λίστα για να σας βοηθήσει.

  • Το περιεχόμενο είναι πιο σημαντικό από το style της σελίδας, την γραμματική, ακόμα και την ορθογραφία.
  • Δεν πειράζει αν κάνετε κάποιο λάθος! Μπορείτε πολύ εύκολα να επεξεργαστείτε την σελίδα ξανά και να το διορθώσετε. Στην χειρότερη περίπτωση κάθε αλλαγή μπορεί να αναιρεθεί εύκολα και γρήγορα, και αυτό μπορείτε να το κάνετε και εσείς.
  • Κανείς δεν πρόκειται να δυσαρεστηθεί εάν κάνετε κάποια αλλαγή σε σελίδα/ες που αυτή/αυτός έχει δημιουργήσει. Όλοι στην κοινότητα της τεκμηρίωσης έχουν τον ίδιο στόχο, την καλύτερη δυνατή τεκμηρίωση.
  • Μην δυσαρεστηθείτε εάν κάποιος άλλος επεξεργαστεί την ίδια σελίδα μετά από εσάς. Το πιο πιθανό είναι επειδή η αλλαγές που κάνατε εμφανίστηκαν στην λίστα "Προσφάτων Αλλαγών" Recent changes και κάποιος σκέφτηκε ότι υπήρχε εκεί κάτι που μπορούσε να συνεισφέρει.
  • Μερικές φορές οι αλλαγές που κάνετε μπορεί να αναιρεθούν εντελώς. Η περίπτωση αυτή είναι πολύ σπάνια, και σας δίνει μια καλή ευκαιρία να γνωριστήτε με κάποιο άλλο μέλος από την κοινότητα.
  • Υπάρχουν άτομα σε πολλές διαφορετικές χρονικές ανά τον κόσμο ζώνες που συμμετέχουν στην τεκμηρίωση, για αυτό εάν δεν λάβετε άμεσα απάντση στο email ή στο IRC, παρακαλούμε κάνετε υπομονή.
  • O Mozilla απασχολεί μια μικρή και φιλική ομάδα για την διαχείριση της διαδικασίας τεκμηρίωσης. Επιβλέπουν όλες τις αλλαγές που γίνονται και κάνουν διορθώσεις όπου και όταν χρειαστεί.

Τα βασικά

Παρατείθεται ένας σύντομος οδηγός για την δημιουργία και επεξεργασία των σελίδες στα MDN wikis. Είστε ευπρόσδεκτοι να εξασκήσετε τις δυνατότητές σας στο Sandbox.

Επεξεργασία σελίδων

Για να επεξεργαστείτε μια σελίδα, θα πρέπει πρώτα να έχετε δημιουργήσει έναν λογαριασμό στο wiki. Για να το κάνετε αυτό πηγαίνετε στην σελίδα User login, εισάγετε τα στοιχεία που επιθυμείτε και υποβάλετε την αίτηση στην σελίδα. Μόλις δημιουργήσετε τον λογαριασμό, θα εισέλθετε αυτομάτως μέσα στο δίκτυο και θα μπορείτε να κάνετε επεξεργασία.

Στην κορυφή κάθε σελίδας, θα δείτε τώρα έναν σύνδεσμο (link) με το όνομα "Edit page". Κάντε κλικ και θα εμφανιστεί η φόρμα επεξεργασίας της σελίδας που βρίσκεστε, όπου μπορείτε έτσι να κάνετε αλλαγές και να έχετε μια προεσκόπιση των αλλαγών σας, προτού τις αποθηκεύσετε στο wiki. Μόλις αποθηκεύσετε τις αλλαγές σας, θα τις δείτε αμέσως στην σελίδα.

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

Δημιουργώντας μια νέα σελίδα

Ο ευκολότερος τρόπος να ξεκινήσετε μια νέα σελίδα είναι να δημιουργήσετε έναν σύνδεσμο για αυτήν στην σελίδα του προφίλ σας, και στην συνέχεια να χρησιμοποιήσετε αυτό το link για να μπείτε στην κατάσταση "Επεξεργασίας" για την σελίδα.

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

Για να μεταβείτε στην σελίδα του προφίλ σας, κάντε κλικ στο όνομα χρήστη σας στο επάνω μπλε bar του wiki. Εάν δεν έχετε προσθέσει κάτι στην σελίδα του προφίλ σας, θα μεταβείτε αυτόματα σε μια φόρμα επεξεργασίας της όπου θα μπορέσετε να προσθέσετε ό,τι περιεχόμενο επιθυμείτε.

Υπάρχουν δύο τρόποι να δημιουργήσετε έναν σύνδεσμο σε μια νέα σελίδα. Μπορείτε να κάνετε κλικ στο κουμπί Insert/Edit στην editor's toolbar, και στην συνέχεια να δώσετε το όνομα της σελίδας όταν σας ζητηθεί. Ή μπορείτε απλώς να γράψετε τον τίτλο για την σελίδα μέσα σε διπλά εισαγωγικά, ως εξής: [[en/Here is an example]]. Όταν αποθηκευτεί, αυτό θα μετατραπεί σε έναν σύνδεσμο, όπως εδώ: Here is an example. Σημειώστε ότι πρέπει να γράψετε τον κατάλληλο κώδικα της γλώσσας που επιθυμείτε.

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

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

Οδηγός ονομάτων για τις σελίδες

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

Wiki markup

Το MindTouch Deki, το λογισμικό που χρησιμοποιεί το Mozilla Developer Network, έχει ως markup language την  XHTML  για την τεκμηρίωση. Εάν θέλετε να δείτε ή να επεξεργαστείτε το XHTML περιεχόμενο, μπορείτε να το κάνετε κάνοντας κλικ στο κουμπί "Source" που εμφανίζεται στην toolbar όσο βρίσκεστε στο edit mode. Κάνετε κλικ ξανά για να επιστρέψετε στον WYSIWYG  επεξεργαστή.

Συγγραφή, επεξεργασία και εποπτεία

Στην συνέχεια παρατίθεται μια εκτενέστερη εισαγωγή στον MDN για συγγραφείς εθελοντές και συντάκτες.

Εθελοντές για συγγραφή

Το MDN ενδιαφέρεται πάντα για νέο περιεχόμενο, για αυτό σας ενθαρρύνουμε να γράψετε νέα άρθρα σε οποιαδήποτε θέματα καλύπτουμε αυτή την στιγμή στο wiki. Το νέο περιεχόμενο μπορεί να είναι απλό όσο μια συμβουλή σε μία σελίδα, ή τόσο περίπλοκο όσο και ένας οδηγός προγραμματισμού. Η ποσότητα του νέου περιεχομένου που θα συνεισφέρετε εξαρτάται αποκλειστικά από εσάς.

Υπάρχουν πολλά Bugs στο Bugzilla σχετικά με την τεκμηρίωση. Δείτε το άθρο για λεπτομέρειες σχετικά με το πώς θα βρείτε και θα ταξινομήσετε κατά προτεραιότητα τα bugs της τεκμηρίωσης.

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

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

Συντάκτες

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

Δεν χρειάζεστε ειδικά δικαιώματα χρήστη για να επεξεργαστείτε αυτό το wiki. Απλώς δημιουργείστε έναν λογιαριασμό και ξεκινήστε αμέσως!

Επιθεωρητές

Τεχνικές βελτιώσεις και επισκόπιση αλλαγών είναι πάντα ευπρόσδεκτες. Εάν κάνετε ανάγνωση μιας σελίδας και εντοπίσετε ένα τεχνικό θέμα (στον κώδικα ή στο κείμενο), παρακαλούμε διορθώστε το. Εάν είναι μια μεγάλη αλλαγή, αφήστε ένα σημείωμα στην "talk" page (που μπορείτε να βρείτε κάνοντας κλικ στην επιλογή "Talk page" του μενού "More options", και γράψτε λεπτομέρειες που να συνοψίζουν τους λόγους αυτής της αλλαγής.

Οδηγός συγγραφής

Έχουμε έναν οδηγό συγγραφής που περιέχει το προτεινόμενο στυλ συγγραφής αλλά και πρακτικές για το MDN wiki. Εάν έχετε ερωτήσεις σχετικά με την χρήση και το στυλ που δεν καλύπτονται εκεί, συνιστούμε να δείτε το Economist style guide, ή ακόμα και το Chicago Manual of Style.

Θα αυξήσουμε το περιεχόμενου του οδηγού με τον χρόνο, για αυτό εάν έχετε συγκεκριμένες ερωτήσεις που δεν καλύπτονται από τον οδηγό συγγραφής, παρακαλούμε στείλτε τες στην MDN mailing list, ή στο developer documentation lead.

Μεταφορά της παλιάς τεκμηρίωσης

Ένα μεγάλο project που συνεχίζει να υπάρχει στο MDN, είναι η μεταφορά όλης της υπάρχουσας τεκμηρίωσης των προγραμματιστών από την ιστοσελίδα mozilla.org στο MDN wiki. Η διαδικασία είναι απλή:

  1. Διαλέξτε μια σελίδα που θέλετε να μεταφέρε από τις ήδη υπάρχουσες.
  2. Ανατρέξτε στην page naming guide, και αποφασίστε πώς θα πρέπει να είναι το όνομα των σελίδων στο wiki.
  3. Δημιουργείστε αυτές τις σελίδες και μεταφέρετε το περιεχόμενο, κάνοντας τις απαραίτητες markup διορθώσεις όπως υπάρχουν εδώ.
  4. Διαγράψτε την σελίδα από τις ήδη υπάρχουσες,
  5. Προσθέστε το νέο στοιχείο στην λίστα needs redirect.

Εάν ενδιαφέρεστε περαιτέρω για αυτή την διαδικασία, μπορείτε επίσης:

  1. Να χρησιμοποιήσετε αυτό το σύστημα search system για αλλάξετε τα links στις προτότυπες σελίδες να δείχνουν στις νέες.
  2. Να ελέγξετε για external redirects στην προτότυπη σελίδα, και να σημειώσετε εκείνα τα redirects για διαγραφή, βάζοντας το tag "Junk" σε αυτά.

Μετάφραση του MDN

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

Υπάρχοντα projects μεταφράσεων σελίδων

Αυτή την στιγμή το MDN έχει wikis για τις ακόλουθες γλώσσες: Català,Čeština, 中文(简体), Deutsch, Ελληνικά, English, Español, Français, Italiano, 日本語, Magyar, Nederlands, Polski, Português, 한국어, 中文(正體), Русский, Suomi, Türkçe, فارسی.

Πώς να ξεκινήσετε ένα νέο project μετάφρασης

Εάν θέλετε να ξεκινήσετε ένα νέο project μετάφρασης για μια γλώσσα που δεν είναι τωρινά διαθέσιμη, παρακαλούμε επισκεφτείτε την σελίδα localization projects και ακολουθείστε τις οδηγίες εκεί.

Επίλυση διαφορών χρηστών για επεξεργασία σελίδων και άλλα

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

Στην περίπτωση που αυτό δεν καταστεί δυνατό, παρακαλούμε ειδοποιήστε μας στο MDN mailing list ή (ως τελευταία επιλογή) στο developer documentation lead. Άλλοι ειδικοί σε τεχνικά θέματα, στην συγγραφή και επεξεργασία θα μας συμβουλέψουν κατάλληλα, και με βάση τις απόψεις τους θα επιλυθεί το ζήτημα.

Αίτηση για διαγραφή σελίδων

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

Τα στοιχεία που χαρακτηρίζονται ως Junk ελέγχονται περιοδικά από τους διαχειριστές του wiki και οι σελίδες που περιέχουν αξιολογούνται και διαγράφονται όταν πρέπει.

Σημείωση: Παρακαλούμε μην διαγράφετε περιεχόμενο και κατηγορίες από τις σελίδες που χαρακτηρίζετε ως "Junk".

Συμμετοχή στην κοινότητα του MDN

Mailing list / newsgroup

Δείτε τα MDN forums...

Κανάλι IRC

Ένας επίσης χώρος συνάντησής μας είναι το κανάλι #devmo στον server irc.mozilla.org: #devmo on irc.mozilla.org.

Επικεφαλής του Project

Το MDN και η τεκμηρίωση του είναι υπό την εποπτεία του Eric Shepherd.

Document Tags and Contributors

Contributors to this page: teoli, syssgx
Last updated by: teoli,