Wiki: Αρχιτεκτονική και Refactoring _pages about site-gr HOT 6 CLOSED

Η τεκμηρίωση για το refactoring _pages, είτε προστεθεί είτε όχι στη σελίδα "Style-Guide", προτείνω να είναι η παρακάτω:

Εφόσον στο αποθετήριο του site-gr, η βασική ιδέα είναι να μην υπάρχει πολύς κώδικας, καλό είναι να υπάρχουν 'include', ώστε να μην είναι τόσο εμφανής ο κώδικας που χρησιμοποιείται για την εκάστοτε λειτουργία. Για παράδειγμα, στα _pages που απαιτείται πολύς κώδικας, αυτός έχει μεταφερθεί στο minimal-ionio και καλείται πλέον με τη χρήση των 'include'. Αξίζει να σημειωθεί ότι η συγκεκριμένη πρακτική, καλό θα είναι να εφαρμόζεται σε κάθε νέα προσθήκη στο αποθετήριο.

Αναφορικά με τα all_collections, δεν υπάρχει λόγος να εμπεριέχουν τα _pages μιας και αποτελούν μια πιο γενική έννοια, για αυτό και έχουν μεταφερθεί εκτός των all_collections. Κατόπιν της μεταφοράς τους, τίθεται το ζήτημα ότι το όνομα και το url κάποιων _pages συμπίπτει με το φάκελο στα all_collections. Έτσι, για να δοθεί προτεραιότητα στα _pages και να αντιμετωπιστεί το πρόβλημα έχουν προστεθεί τα permalinks.

Σχετικό issue: #106

from site-gr.

Προσωπικά θα συμφωνήσω ότι ταιριάζει να μπει σε κάποιο style guide η τεκμηρίωσή σου, ειδικά εφόσον παρέχει και οδηγίες/καλές πρακτικές.

from site-gr.

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

Φαντάζομαιι εδώ εννοείς τον φάκελο includes στο minimal-ionio. Καλό θα ήταν να το διευκρινήσεις αυτό γιατί ενδεχομένως μετά να φτιάξουν τον φάκελο και στο site-gr

from site-gr.

Αφού κατάλαβα τι εννοούσες με το refactoring, συμφωνώ με την υλοποίηση για τη μεταφορά όλου το κώδικα στο minimal-ionio, έτσι ώστε το site-gr να χρησιμοποιείται μόνο για την επεξεργασία του περιεχομένου.
Όσο για το style guide, εφόσον έχει γίνει η μεταφορά καλό είναι να υπάρχει για να ανατρέχουν για σχετικές οδηγίες και πρακτικές.

from site-gr.

ίσως ο όρος αρχιτεκτονική (=υπάρχει μια μορφή που φαίνεται, αλλά υπάρχει και μια δομή που δεν φαίνεται τόσο καθαρά αλλά καθορίζει-επηρεάζει την μορφή)

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

επειδή γράφουμε πρώτη φορά τεκμηρίωση πρέπει να παρατηρούμε τι γραφουν οι άλλοι και να προσέχουμε για επικαλύψεις ή/και αμφισημίες-ασάφειες

from site-gr.

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

from site-gr.