Generated files και πηγή αλήθειας
Πώς το Jenna Press αντιμετωπίζει τα generated files και γιατί το markdown περιεχόμενο παραμένει η πηγή αλήθειας.
Το generated επιτρέπεται, αλλά δεν είναι επεξεργάσιμη αλήθεια
Ένα generated file μπορεί να υπάρχει στο Jenna Press επειδή η static publishing εξακολουθεί να χρειάζεται μια πρακτική γέφυρα ανάμεσα στο source content και στο runtime rendering. Αυτό δεν σημαίνει ότι το generated file είναι το μέρος όπου πρέπει να εργάζονται οι συντάκτες.
Η πηγή αλήθειας παραμένει το markdown περιεχόμενο και η generation logic που το μετασχηματίζει. Το generated output μπορεί να γίνεται commit για λόγους ευκολίας, αλλά πρέπει να αντιμετωπίζεται ως output, να ελέγχεται ως output και να αναδημιουργείται όταν αλλάζει η πραγματική πηγή.
Αυτή η διάκριση έχει σημασία επειδή προστατεύει τόσο τη σαφήνεια της συγγραφής όσο και τη σαφήνεια του code review.