Πώς να φτιάξετε σελίδα ιστορικού αλλαγών: Καταχωρήσεις, ετικέτες, RSS και «Τι νέο υπάρχει»
Μια σελίδα ιστορικού αλλαγών είναι μια χρονολογική λίστα με όσα άλλαξαν στο προϊόν σας, από το νεότερο προς το παλαιότερο, γραμμένη για τους ανθρώπους που το χρησιμοποιούν. Για να τη φτιάξετε χρειάζεστε καταχωρήσεις με ημερομηνία, σαφή τίτλο, σύντομη εξήγηση και ετικέτα (Νέο, Βελτίωση, Διόρθωση), μια σελίδα που τις εμφανίζει, ξεχωριστό URL για κάθε καταχώρηση, και κατά προτίμηση feed RSS και τρόπο να ενημερώνετε τους χρήστες ότι υπάρχει κάτι νέο. Είναι ένα από τα πιο απλά πράγματα που μπορείτε να φτιάξετε, και η βασική απόφαση είναι πού ζουν οι καταχωρήσεις: ως αρχεία μέσα στον ιστότοπο ή σε βάση δεδομένων με σελίδα διαχειριστή.
Γιατί αξίζει μια σελίδα αλλαγών
Ένα ιστορικό αλλαγών δείχνει στους πελάτες και τους ενδιαφερόμενους ότι το προϊόν συντηρείται. Δίνει στην υποστήριξη και στις πωλήσεις έναν σύνδεσμο να στείλουν όταν κάποιος ρωτά «κάνει ήδη το Χ;». Είναι επίσης ο τρόπος να κλείσετε τον κύκλο των σχολίων: όταν λειτουργία που ζητήθηκε κυκλοφορεί, η καταχώρηση του ιστορικού είναι αυτό που δείχνετε στους ανθρώπους. Αν τρέχετε πύλη σχολίων πελατών, συνδέστε τα αιτήματα που υλοποιήθηκαν απευθείας με τις καταχωρήσεις τους.
Το ιστορικό αλλαγών δεν είναι το εσωτερικό ιστορικό commits σας. Το «Αναδιάρθρωση της υπηρεσίας χρέωσης» δεν σημαίνει τίποτα για έναν χρήστη. Το «Τα τιμολόγια δείχνουν πλέον τον ΑΦΜ της εταιρείας σας» σημαίνει.
Τι χρειάζεται η σελίδα
Περιεχόμενο για κάθε καταχώρηση
| Πεδίο | Σημειώσεις |
|---|---|
| Τίτλος | Τι άλλαξε, από το σημείο θέασης του χρήστη |
| Ημερομηνία | Ημερομηνία δημοσίευσης, που εμφανίζεται στη σελίδα |
| Ετικέτα | Νέο, Βελτίωση, Διόρθωση (και ίσως Αφαίρεση ή Ασφάλεια) |
| Κείμενο | Μερικές προτάσεις ή κουκκίδες· πώς χρησιμοποιείται, ποιος το παίρνει |
| Εικόνα ή βίντεο | Προαιρετικό· ένα στιγμιότυπο βοηθά περισσότερο από μια παράγραφο |
| Slug | Το URL της καταχώρησης, όπως /changelog/invoice-vat-numbers |
| Κατάσταση | Πρόχειρο ή δημοσιευμένο, και ημερομηνία προγραμματισμένης δημοσίευσης αν χρειάζεται |
Σελίδες
- Κεντρική σελίδα αλλαγών: από το νεότερο προς το παλαιότερο, με φίλτρα ετικετών και απλή σελιδοποίηση ή «φόρτωση περισσότερων».
- Σελίδα καταχώρησης: μία καταχώρηση ανά URL, ώστε να μπορεί να συνδεθεί και να μοιραστεί.
- Feed RSS ή Atom: επιτρέπει σε ανθρώπους και εργαλεία να παρακολουθούν τις ενημερώσεις χωρίς email.
- Σελίδα διαχειριστή (μόνο στην έκδοση με βάση δεδομένων): γράφετε, προεπισκοπείτε, προγραμματίζετε και δημοσιεύετε καταχωρήσεις.
Επιπλέον μέσα στην εφαρμογή
- Ένδειξη «τι νέο υπάρχει»: μια κουκκίδα σε στοιχείο μενού όταν υπάρχουν καταχωρήσεις που ο χρήστης δεν έχει δει. Αποθηκεύστε την ημερομηνία της τελευταίας καταχώρησης που άνοιξε, ανά χρήστη ή στον περιηγητή.
- Περίληψη email: μια σύνοψη που στέλνεται σε χρήστες που το επέλεξαν. Αυτό χρειάζεται πάροχο αποστολής· δείτε πώς να στέλνετε email από την εφαρμογή σας.
Η βασική απόφαση: αρχεία ή βάση δεδομένων
Καταχωρήσεις ως αρχεία στον ιστότοπο
Κάθε καταχώρηση είναι ένα αρχείο Markdown μέσα στο έργο. Η δημοσίευση μιας καταχώρησης σημαίνει προσθήκη αρχείου και νέα ανάπτυξη. Είναι η απλούστερη και πιο ανθεκτική προσέγγιση: χωρίς βάση δεδομένων, χωρίς σύνδεση διαχειριστή, τίποτα να ασφαλίσετε, και οι σελίδες μπορούν να προ-αποδοθούν ώστε να φορτώνουν γρήγορα και να διαβάζονται εύκολα από μηχανές αναζήτησης.
Αυτό ταιριάζει σε ομάδες όπου όσοι γράφουν καταχωρήσεις είναι άνετοι να ζητούν από έναν πράκτορα AI ή να επεξεργάζονται ένα αρχείο.
Καταχωρήσεις σε βάση δεδομένων με σελίδα διαχειριστή
Οι καταχωρήσεις ζουν σε πίνακα, και μια ιδιωτική σελίδα διαχειριστή επιτρέπει σε όποιον είναι στην ομάδα να γράφει, να προεπισκοπεί, να προγραμματίζει και να δημοσιεύει. Ταιριάζει σε ομάδες όπου το μάρκετινγκ ή η υποστήριξη γράφει ενημερώσεις, ή όταν θέλετε προγραμματισμένη δημοσίευση ή καταχωρήσεις ανά κοινό (για παράδειγμα, να δείχνετε λειτουργίες επιχειρήσεων μόνο σε πελάτες επιχειρήσεων).
Το κόστος είναι περισσότερη δουλειά και συντήρηση: σύνδεση διαχειριστή, αποθηκευτικός χώρος για εικόνες και βεβαιότητα ότι οι δημόσιες σελίδες παραμένουν αναγνώσιμες από μηχανές αναζήτησης, κάτι που μια σελίδα που φορτώνει καταχωρήσεις μόνο στον περιηγητή μπορεί να μην είναι.
| Αρχεία | Βάση δεδομένων + διαχειριστής | |
|---|---|---|
| Ποιος μπορεί να δημοσιεύσει | Όποιος επεξεργάζεται το έργο | Όποιος έχει σύνδεση διαχειριστή |
| Ρύθμιση | Ελάχιστη | Σύνδεση, αποθήκευση, περιβάλλον διαχειριστή |
| SEO | Εύκολο (προ-αποδομημένες σελίδες) | Χρειάζεται φροντίδα ώστε οι σελίδες να αποδίδονται στον διακομιστή ή να προ-αποδίδονται |
| Προγραμματισμός | Δημοσίευση κατά την ανάπτυξη | Προγραμματισμός με ημερομηνία |
| Κόστος φιλοξενίας | Στατικό | Χρειάζεται εκτελούμενη εφαρμογή και βάση |
Γράφοντας καταχωρήσεις που διαβάζονται
- Ξεκινήστε με το όφελος. «Εξαγωγή αναφορών σε Excel» είναι καλύτερο από «Νέα μονάδα εξαγωγής».
- Πείτε ποιος το παίρνει. Όλα τα πλάνα, μόνο Pro, διάθεση αυτή την εβδομάδα.
- Δείξτε το. Ένα στιγμιότυπο ή ένα σύντομο βίντεο.
- Ομαδοποιήστε τις μικρές διορθώσεις. Μια εβδομαδιαία καταχώρηση «Διορθώσεις και βελτιώσεις» με κουκκίδες κρατά τη σελίδα από το να πλημμυρίζει.
- Να είστε ειλικρινείς για αφαιρέσεις. Αν κάτι καταργείται, πείτε πότε και τι να χρησιμοποιήσουν αντί.
Μια πρώτη εντολή που δουλεύει
Πρόσθεσε ένα δημόσιο ιστορικό αλλαγών στον ιστότοπό μας στο /changelog. Κάθε καταχώρηση είναι αρχείο Markdown με τίτλο, ημερομηνία, ετικέτα (Νέο, Βελτίωση ή Διόρθωση), προαιρετική εικόνα εξωφύλλου και κείμενο. Η κεντρική σελίδα εμφανίζει τις καταχωρήσεις από το νεότερο προς το παλαιότερο με ημερομηνία, ετικέτα και πρώτη παράγραφο, έχει κουμπιά φίλτρου ανά ετικέτα, και δείχνει 10 καταχωρήσεις ανά σελίδα. Κάθε καταχώρηση έχει τη δική της σελίδα στο /changelog/<slug>, με σωστό τίτλο σελίδας και περιγραφή για μηχανές αναζήτησης. Πρόσθεσε feed RSS στο /changelog/rss.xml. Φτιάξε τρεις δοκιμαστικές καταχωρήσεις. Ταίριαξε με τον υπάρχοντα σχεδιασμό του ιστότοπου, κράτα το ευανάγνωστο στα κινητά, και προ-απέδωσε τις σελίδες ώστε να φορτώνουν γρήγορα.
Για την έκδοση με βάση δεδομένων, αντικαταστήστε την πρώτη πρόταση με «Αποθήκευσε τις καταχωρήσεις σε βάση δεδομένων με κατάσταση πρόχειρου/δημοσιευμένου και ημερομηνία δημοσίευσης, και πρόσθεσε σελίδα διαχειριστή με προστασία κωδικού για να γράφω, να προεπισκοπώ και να δημοσιεύω.»
Βήματα κατασκευής
- Αποφασίστε αρχεία ή βάση δεδομένων με βάση τον πίνακα παραπάνω.
- Φτιάξτε τις σελίδες λίστας και καταχώρησης με μερικές δοκιμαστικές καταχωρήσεις.
- Προσθέστε ετικέτες και φίλτρα.
- Προσθέστε το feed RSS και συνδέστε το από τη σελίδα.
- Προσθέστε τίτλους σελίδων, περιγραφές και καταχώρηση στον sitemap για κάθε καταχώρηση. Ο οδηγός μας για SEO για ιστότοπους φτιαγμένους με AI καλύπτει τα βασικά.
- Σελίδα διαχειριστή και σύνδεση, αν επιλέξατε τη διαδρομή της βάσης δεδομένων.
- Ένδειξη «τι νέο υπάρχει» στην εφαρμογή σας.
- Γράψτε πραγματικές καταχωρήσεις για τους τελευταίους μήνες, ώστε η σελίδα να μην εμφανιστεί άδεια.
Συχνά λάθη
- Αντιγραφή μηνυμάτων commit. Γράψτε για τους χρήστες, όχι για τους προγραμματιστές.
- Μία τεράστια σελίδα χωρίς URL ανά καταχώρηση. Κανείς δεν μπορεί να συνδέσει μια συγκεκριμένη αλλαγή, και οι μηχανές αναζήτησης βλέπουν μία σελίδα αντί για πολλές.
- Οι ενημερώσεις σταματούν μετά από ένα μήνα. Ιστορικό που τελευταία ενημερώθηκε πριν από έναν χρόνο υπονοεί εγκαταλελειμμένο προϊόν. Ορίστε έναν ρυθμό που μπορείτε να κρατήσετε.
- Φόρτωση καταχωρήσεων μόνο στον περιηγητή. Οι μηχανές αναζήτησης και οι προεπισκοπήσεις συνδέσμων μπορεί να δουν άδεια σελίδα. Προ-αποδώστε ή αποδώστε στον διακομιστή.
- Ανάμειξη βλαβών. Οι διακοπές ανήκουν σε μια σελίδα κατάστασης, όχι στο ιστορικό αλλαγών.
Πότε μια φιλοξενούμενη υπηρεσία ιστορικού είναι καλύτερη επιλογή
Υπάρχουν φιλοξενούμενα εργαλεία ιστορικού αλλαγών και ενημερώσεων προϊόντος, μερικά ενσωματωμένα σε πίνακες σχολίων ή widgets εφαρμογής. Αξίζουν αν θέλετε αναδυόμενο μήνυμα μέσα στην εφαρμογή, στόχευση κοινού και αναλύσεις χωρίς να τα χτίσετε, ή αν η ομάδα σας ήδη πληρώνει για εργαλείο που τα περιλαμβάνει. Το λογισμικό του blog ή του κέντρου βοήθειας σας μπορεί επίσης να έχει ήδη μορφή κατάλληλη.
Φτιάξτε το δικό σας όταν θέλετε το ιστορικό στο δικό σας domain, με τον δικό σας σχεδιασμό, και πλήρως ευρετηριοποιήσιμο, κάτι που για απλή λίστα χρονολογημένων αναρτήσεων δεν είναι πολλή δουλειά.
Χτίζοντας με Mythex
Στο Mythex μπορείτε να ζητήσετε από τον πράκτορα να προσθέσει ιστορικό αλλαγών σε υπάρχον έργο ή να το φτιάξει ως δικό του μικρό ιστότοπο, και να το δείτε στη ζωντανή προεπισκόπηση καθώς χτίζεται. Η έκδοση με αρχεία δεν χρειάζεται βάση δεδομένων. Αν επιλέξετε την έκδοση με διαχειριστή, ο πράκτορας προσθέτει dedicated βάση Postgres όταν χρειάζεται αποθήκευση καταχωρήσεων (ή πληκτρολογήστε /database), και τα στιγμιότυπα μπαίνουν στον αποθηκευτικό χώρο αρχείων του έργου. Η σύνδεση διαχειριστή είναι κάτι που προσθέτετε με τη δική σας προσέγγιση αυθεντικοποίησης (συνταγή προσθήκης σύνδεσης).
Οι νέες εφαρμογές Mythex είναι συχνά μονοσέλιδες εφαρμογές που αποδίδονται στον πελάτη, και η συνταγή SEO σημειώνει ότι είναι ασθενέστερες για αναζήτηση· γι' αυτό ζητήστε στατικές ή προ-αποδομημένες σελίδες αλλαγών αν θέλετε οι καταχωρήσεις να βρίσκονται στην αναζήτηση. Η ίδια συνταγή καλύπτει τίτλους, περιγραφές και sitemaps. Για αρχή με ενσωματωμένο ιστορικό αλλαγών, δείτε το πρότυπο κέντρου γνώσης προϊόντος.
Ερωτήσεις
Τι πρέπει να περιέχει μια καταχώρηση ιστορικού αλλαγών;
Μια ημερομηνία, έναν σύντομο τίτλο που λέει τι άλλαξε για τον χρήστη, μερικές προτάσεις ή κουκκίδες που το εξηγούν, μια ετικέτα όπως Νέο, Βελτίωση ή Διόρθωση, και προαιρετικά ένα στιγμιότυπο οθόνης και σύνδεσμο για περισσότερες λεπτομέρειες.
Χρειάζεται βάση δεδομένων μια σελίδα αλλαγών;
Όχι απαραίτητα. Αν ένα ή δύο άτομα δημοσιεύουν ενημερώσεις, οι καταχωρήσεις μπορούν να ζουν ως αρχεία Markdown μέσα στον ιστότοπο και να δημοσιεύονται με κάθε ανάπτυξη. Χρησιμοποιήστε βάση δεδομένων όταν μη τεχνικά άτομα πρέπει να γράφουν και να προγραμματίζουν καταχωρήσεις από σελίδα διαχειριστή.
Πόσο συχνά πρέπει να ενημερώνω ένα ιστορικό αλλαγών;
Όποτε αλλάζει κάτι που θα το πρόσεχαν οι χρήστες. Πολλά μικρά προϊόντα ομαδοποιούν τις αλλαγές εβδομαδιαία ή κάθε δύο εβδομάδες· το σημαντικό είναι ένας σταθερός ρυθμός ώστε η σελίδα να φαίνεται ζωντανή.
Είναι μια σελίδα αλλαγών καλή για SEO;
Βοηθά λίγο: κάθε καταχώρηση είναι σελίδα που μπορεί να ευρεθεί από μηχανές αναζήτησης για μια λειτουργία, και μια σελίδα που ενημερώνεται τακτικά δείχνει ενεργό προϊόν. Δώστε σε κάθε καταχώρηση δικό της URL και περιγραφικό τίτλο.