DOCUMENTATION για αρχάριους

[ks-net]

ωραίο αλλά ένα περιοδικό θα πρέπει να πέρνει υλικό από πολλές πηγές...
από το
-blog με τα tips-howto's
-τελευταία νέα
-latest downloads
-Events
-το ιντερνετ σχετικά με seo-web development open source κτλ.
να έχει και φώτο και να είναι μούρη... μπορεί και να στέλνεται και με μαιλ στα forum-members ή σε αλλους subscribers 
να βγαίνει σε pdf εκδοση κτλ.

[Dimitris Kanatas]

Κι εγώ είμαι μέσα...  ελπίζω να με δεχτείτε στην ομάδα σας για τους οδηγούς...

http://ubuntistas.ubuntu-gr.org/download/Ubuntistas_Issue_2_Januar-Februar_2009.pdf

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

[ks-net]

Μπορούμε να ξεκινήσουμε από μικρά tips σε στυλ blog που θα γράφουν σε ανύποπτο χρόνο διάφοροι επιλεγμένοι χρήστες από μία ευρύτερη βάση
και στη συνέχεια κάποιοι να έχουν την αρχισυνταξία ενός περιοδικού όχι απαραίτητα μηναίου(αρχικά)  και κάποιο άλλοι ακόμα θα μπορούσαν συντάξουν κατά διαστήματα ολόκληρα και πλήρη Docs online στηριζόμενοι στα κομμάτια που η ευρεία βάση χρηστών προσφέρει 

[JohnD]

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

[rentasite]

Εγώ είμαι της άποψης ότι θα πρέπει να το φτιάξει 1 το πολύ 2 άτομα. Για λόγους που έχουν σχέση με το τελικό αποτέλεσμα.

Και βέβαια σας ξαναθυμίζω αυτή μου εδώ την πρόταση για Γνωσιολογική Βάση:   https://forum.elxis.org/index.php?topic=335.0    Κι αν γίνει μπέρδεμα σαν κι αυτό που απάντησε ο datahell

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

Τότε ας μην είναι μια Γνωσιολογική βάση, αλλά ένα Wiki το οποίο πολύ άνετα θα μπορεί να ανανεώνουμε και να προσθέτουμε οτιδήποτε επιπλέον. Με τους οδηγούς και τα PDFs είναι λίγο πιο περιορισμένες οι δυνατότητες. Τι λέτε; 

[Dimitris Kanatas]

Wiki ή pdf ή και τα δύο; Συμφωνώ και στα δύο. Δε συμφωνώ με το blog (που ήδη υπάρχει)....

Για το περιοδικό σε pdf ας κάνει κάποιος ένα θέμα με μία ή δύο σελίδες και ας το στείλει με pm στα άτομα που ενδιαφέρονται να γράψουν. Έτσι θα έχουμε ένα "μπούσουλα" σχετικά με τη δομή και το ύφος του κειμένου.

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

Βέβαια μπορεί να απορρίψει κάποιο κείμενο - άρθρο  χωρίς όμως να υπάρχει παρεξήγηση.

Να μην υπάρχει συγκεκριμένος χρόνος υλοποίησης του περιοδικού. Όταν μαζευτούν αρκετά άρθρα τότε να δημιουργηθεί το τεύχος.

Σημείωση: Αν γίνει αυτή η προσπάθεια για δημιουργία ηλεκτρονικού περιοδικού τότε καλό θα ήταν να υπάρχει ένα "κλειδωμένο" θέμα για να καταθέτουμε τα θέματα των άρθρων και να συζητάμε γι` αυτά.

[datahell]

Έχω δει το DocuWiki ( http://www.dokuwiki.org ) το οποίο είναι πολύ καλό, έχει πολυγλωσσία, SEF URLs, καλή σύνταξη, css και typography, κλπ, αλλά μου φαίνεται λίγο χαοτικό για τους νέους χρήστες μιας και περισσότερο αυτοί θα το χρησιμοποιούν. Δεν ξέρω αν θα ήταν καλό να δουλέψουμε σε κάτι τέτοιο.

[ks-net]

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

Wiki ή pdf ή και τα δύο; Συμφωνώ και στα δύο. Δε συμφωνώ με το blog (που ήδη υπάρχει)....

Δεν υπάρχει... σίγουρα ένα μικρός τομέας σε στιλ blog είναι το πιο απλό για ξεκινήσει κάποιος και τα κύρια πλεονεκτήματα είναι

-ελευθεριά χρόνου
-απλότητα
-ελεύθερη θεματολογία, χωρίς αυστηρό πλάνο

θα μπορούσε κάλλιστα να γίνει με το eblog του elxis (αρκεί να έχουμε πολλαπλούς ελεγχόμενους authors/blog)

-δεν αποκλείει την μετέπειτα ή την ταυτόχρονη ακόμα ύπαρξη wiki/fqa/docs/
-Απλά το blog βρίσκεται ανάμεσα σε ένα forum και σε ένα wiki... στο forum είναι χύμα στο wiki όλα μέσα σε καλούπι
στο blog κοντρολάρουμε λίγο τα πράγματα

Ας δούμε μερικά παραδείγματα:
http://www.learningjquery.com/category/levels
http://php.about.com/
http://ajaxblog.com/archives/2006/03/16/want-to-learn-how-to-use-ajax

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

τί να τα κάνουμε τα χτένια αν δεν έχουμε γένια(υλικό)?

Ενα  wiki θέλει τρομερή δουλεία ... και το 2009 έχουμε καινούργια version (από 1 άντε 2 ατομα)  ένα wiki θα πρέπει αμέσως να ενημερωθεί τουλάχιστον με τις αλλαγές της 2009... ποιος θα τις κάνει?... ποιος άλλος...
που θέλω να καταλήξω? χρειάζονται άτομα...και χρόνος... δε φτάνουμε να κάνουμε μεγάλα πράγματα!

[rentasite]

Θέλουμε documentation για αρχάριους ή περιοδικό με δραστηριότητες κλπ κλπ; Ιδού το ερώτημα....

Αλλιώς ξεκίνησε το θέμα και αλλού πάει. Ο Γιάννης αναφέρθηκε σε documentation για αρχάριους. Συνεπώς για τι.... περιοδικό λέτε; Κάποιος που θέλει να εγκαταστήσει ένα template ή να δημοσιεύσει ένα αντικείμενο Menu και δεν το γνωρίζει... δεν θα πάει να κατεβάσει ένα "περιοδικό" 5-10-15 σελίδων για να βρει τη λύση μέσα εκεί.

Και επειδή φαίνεται ότι θα συμπράξουν παραπάνω από 1-2 άτομα στο όλο εγχείρημα.... γι αυτό και ανέφερα την λύση του Wικι. Τέλος, κανείς δεν είπε ότι θα ολοκληρωθεί μέσα σε 1 βδομάδα ή 1 μήνα.

Σε οποιαδήποτα άλλη περίπτωση, καλή είναι και η αναζήτηση του Forum ως βοήθεια. Οι λύσεις υπάρχουν και μάλιστα όχι μόνο σε 1 γλώσσα. Απλά ΔΕΝ ψάχνουν.

[ks-net]

Βασικά εγώ είμαι μέσα και στη λύση wiki... που όπως είπα την θεωρώ την πιο ολοκληρωμένη.
Το περιοδικό ο Γιάννης το ανέφερε(σαν παράλληλο επακόλουθο), δεν είναι και άσχημο, άμα υπάρχει το υλικό όλα γίνονται εύκολα...
Δεν θεωρώ το wiki εύκολο πράγμα όμως...

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

και βλέπουμε πώς θα πάει ... και το ανακοινώνουμε στο κοινό..όταν θα έχουμε στήσει το βασικό κορμό και κάποια αντικείμενα!

Edit

Και επειδή φαίνεται ότι θα συμπράξουν παραπάνω από 1-2 άτομα στο όλο εγχείρημα.... γι αυτό και ανέφερα την λύση του Wικι. Τέλος, κανείς δεν είπε ότι θα ολοκληρωθεί μέσα σε 1 βδομάδα ή 1 μήνα.

1-2 ατομα τις elxis team είναι υποχρεωμένα να ασχοληθούν με το wiki και ορισμένες κατηγορίες του που είναι υποχρεωτικές να υπάρχουν όπως οι διαφορές τις version 2009( παράδειγμα) και βασικά στοιχεία elxis-core που μόνο η elxis-team είναι σε θέση να κατέχει.... ένα wiki σε βάζει σε καλούπι και σου βγάζει απαιτήσεις, είναι καλύτερα μην το έχεις καθόλου παρά να  λείπουν βασικά στοιχεία

[Dimitris Kanatas]

Παιδιά για αναλυτικό DOCUMENTATION σε ένα αρχείο απαιτεί πολύ χρόνο ή πολλά άτομα... και μέχρι να ετοιμαστεί θα φτάσει η επόμενη έκδοση. Αν υπάρξει περιοδική έκδοση ενός αρχείου με μικρούς οδηγούς και πρακτικές εφαρμογές του elxis θα ήταν κάπως προτιμότερο. Αυτό θα προωθούσε καλύτερα και το εργαλείο, θα μπορούσε να διαδοθεί ευκολότερα μέσω e-mails και ακόμη.... οι επαγγελματίες που συμμετείχαν στο project θα διαφήμιζαν έτσι την εργασία τους (στο ελάχιστο - γράφοντας απλά το όνομά τους - ένα επιπλέον κίνητρο εργασίας).

Πάντως ότι και αν αποφασιστεί πρέπει να ξεκινήσει από κάποιον και οι υπόλοιποι (όποιοι θέλουν) συνεχίζουν...

Wiki ή pdf αρχείο ή blog;

Επειδή το θέμα δεν αφορά τους επισκέπτες... μη τους ζαλίζουμε μ` αυτά... μήπως να το "περιορίσουμε" σε επίπεδο μελών;

[ks-net]

Αν δε βρέξεις κ...  ψάρι δεν τρώς ...
αν θέλουμε documentation πρέπει α ξεκινήσουμε καμιά φορά!

[CREATIVE Options]

Μία ερώτηση,
Γιατί δεν μας φτιάχνει ο Γιάννης ένα κλειστό τμήμα στο forum για αυτό τον σκοπό.
Και εκεί να φτιάξουμε έναν κορμό για το τι θα πρέπει να καλυφτεί σαν πληροφόρηση προς τους αρχάριους χρήστες.

Ωχ έχω πολλά να πω παραπάνω από μία ερώτηση...

Και συνεχίζω...

Και εφόσον φτιαχτεί ο κορμός εκεί αρχίζουμε και το συγγράφουμε, να έχουμε υπόψιν μας ότι θα πρέπει να γίνεται και έλεγχος πριν από την δημοσίευση στο ευρύ κοινό.

Επίσης θα πρέπει να επισημάνω ότι άμα ξεκινήσουμε όλη μας με διαφορετικό τρόπο γραφείς ειδικά στην αγγλική γλώσσα το αποτέλεσμα δεν θα είναι αντάξιο του Elxis. Για αυτό προτείνω οι αρχικές συγγραφές μας να γίνονται στην Ελληνική γλώσσα και μετά πριν την δημοσίευση στο κοινό να μεταφραστή στα Αγγλικά από 1 ή 2 άτομα max.

Ως προς την μετάφραση προς τα Αγγλικά μπορώ να συνεισφέρω με διάφορους τρόπους..
1. Να κάνω εγώ την μετάφραση με την συνεισφορά της συζύγου μου (καθηγήτρια Αγγλικών με εμπειρία 25ετών).
2. Να την αναθέσω σε καθηγήτριες του φροντιστηρίου της συζύγου μου με την επίβλεψη μου
3. Να την αναθέσω σε μεταφραστικό γραφείο

Και για εμένα η καλύτερη μορφή είναι στο forum στα F.A.Q και απλά να το αναδείξουμε περισσότερο.
Και το περιεχόμενο νομίζω αυτή η πληροφορία θα μπορούσε να προσαρμοστεί και μέσα στο Elxis σαν έξτρα βοηθητικό υλικό.

Εγώ είμαι ανοικτός σε οποιαδήποτε πρόταση ή όποια απόφαση παρθεί.

[rentasite]

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

Έτσι! Και μένα αυτός είναι ο ενδυασμός μου. Και ειδικά αν ενσωματωθούν και γραφικά/οδηγοί...θα είναι ΔΙΑΦΟΡΕΤΙΚΟ και όχι ομοιόμορφο το τελικό αποτέλεσμα.

Και για εμένα η καλύτερη μορφή είναι στο forum στα F.A.Q και απλά να το αναδείξουμε περισσότερο.

Συμφωνώ με το F.A.Q. και την ανάδειξη του!

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

4. Εργασία (μετάφραση) στους μαθητές του Φροντιστηρίου! LOL 

[ks-net]

Μάλλον με τη λύση του forum θα καταλήξουμε με μια απο τα ιδια..

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