Comments (6)
Η τεκμηρίωση για το 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.
Related Issues (20)
- Updates killed the the bundler and leaflet maps... HOT 1
- Wiki: Διαχείριση της βιβλιογραφίας των courses HOT 3
- Δυναμικό περιεχόμενο στο υπόβαθρο της βασικής σελίδας HOT 1
- Συλλογή από videos στο υπόβαθρο HOT 1
- Wiki: Δυναμικό Περιεχόμενο στην αρχική σελίδα HOT 6
- Σελίδα Επικοινωνίας με γεωγραφικούς χάρτες. Αλλαγές - Προσθήκες HOT 8
- Wiki Docs: Twitter Embedded Timeline HOT 8
- Φόρμα για εξωτερικούς χρήστες: Πρόγραμμα μαθημάτων HOT 1
- Wiki: Γεωγραφικοί χάρτες. HOT 9
- Wiki: Courses HOT 3
- Wiki: Update Contributors Guide HOT 5
- Action: check data for new-updated course HOT 1
- Wiki: Bίντεο στο υπόβαθρο της αρχικής σελίδας HOT 6
- πρόγραμμα εξεταστικής HOT 1
- Προσθήκη δυνατότητας επιλογής διάρκειας των μαθημάτων στο ωρολόγιο πρόγραμμα HOT 1
- Wiki: Συντομεύσεις πλοήγησης στο footer της σελίδας HOT 5
- wiki: Τεκμηρίωση της μεταφοράς του αποθετηριόυ και του wiki
- Wiki: Tagcloud HOT 6
- Wiki Docs: Data Structure for Contact section HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from site-gr.