Ένα κέντρο τεκμηρίωσης για όλα τα προϊόντα, χωρίς συνδρομές
Οδηγίες σκορπισμένες σε παλιά sites; Πώς στήσαμε ένα κέντρο τεκμηρίωσης για πολλά προϊόντα με WordPress, GraphQL και Astro, και πότε δεν αξίζει.
Αν οι οδηγίες των προϊόντων σου ζουν σε διαφορετικά sites, αν η δημοσίευση ενός άρθρου θέλει μισή μέρα, ή αν υπάρχει ένα παλιό site οδηγιών που κανείς δεν τολμά να αγγίξει, το πρόβλημα δεν είναι το περιεχόμενο. Είναι ότι κάθε προϊόν απέκτησε, με τα χρόνια, τη δική του πλατφόρμα.
Το είδα από κοντά σε ένα πρόσφατο project: τρεις εφαρμογές του ίδιου ομίλου, και οι δύο από αυτές με το δικό τους, παλιό site οδηγιών. Αργά, δύσκολα στη συντήρηση, και με διαδικασία καταχώρησης που όσοι έγραφαν περιεχόμενο απέφευγαν όσο μπορούσαν.
Ένα site ανά προϊόν δεν κλιμακώνεται
Η πρώτη σκέψη σε τέτοιες περιπτώσεις είναι «ας φτιάξουμε ένα καινούργιο, σωστό site». Μόνο που με τρία προϊόντα αυτό σημαίνει τρία sites, τρεις εγκαταστάσεις να ενημερώνονται και τρία σημεία όπου κάτι μπορεί να χαλάσει.
Αυτό που χρειαζόταν ήταν μία πλατφόρμα για όλα, που να τη συντηρεί η ίδια η εταιρεία.
Γιατί όχι Notion ή Confluence
Τα εξετάσαμε. Είναι καλά εργαλεία και για πολλές ομάδες είναι η σωστή απάντηση. Εδώ όμως ο στόχος ήταν να μείνει χαμηλά το κόστος για εφαρμογές τρίτων, και οι συνδρομές για πολλούς χρήστες και πολλά προϊόντα αθροίζονται γρήγορα. Θέλαμε επίσης πλήρη έλεγχο στην εμφάνιση και στο πού πηγαίνει το περιεχόμενο.
Καταλήξαμε σε μια headless λύση, δηλαδή σε ένα σύστημα όπου το σημείο που γράφεις το περιεχόμενο είναι ξεχωριστό από το site που το δείχνει.
Πώς δουλεύει
Το WordPress κάνει αυτό που ξέρει καλύτερα: είναι ένα σταθερό περιβάλλον για όσους γράφουν. Ο επισκέπτης δεν το βλέπει ποτέ. Η ομάδα που διαχειρίζεται το περιεχόμενο γράφει σε Markdown και αποφασίζει η ίδια πότε δημοσιεύεται κάθε άρθρο.
Το GraphQL είναι ο τρόπος που βγαίνει το περιεχόμενο από εκεί: κάθε εφαρμογή ζητάει ακριβώς τα πεδία που χρειάζεται, ούτε περισσότερα ούτε λιγότερα.
Το Astro παίρνει το περιεχόμενο τη στιγμή του build και παράγει απλές στατικές σελίδες. Το build δεν τρέχει αυτόματα σε κάθε αλλαγή: συγκεκριμένοι, εξουσιοδοτημένοι χρήστες αποφασίζουν πότε θα βγει online η νέα έκδοση, ώστε ένα μισοτελειωμένο άρθρο ή ένα λάθος να μη φτάνει ποτέ κατά λάθος στον πελάτη. Το αποτέλεσμα φορτώνει γρήγορα, δεν χτυπάει βάση δεδομένων σε κάθε επίσκεψη, και δεν αφήνει το admin ανοιχτό στο internet.
Τι άλλαξε στην πράξη
Για όσους γράφουν: ένα σημείο, μία διαδικασία, για όλα τα προϊόντα. Για όσους διαβάζουν: οι οδηγίες είναι διαθέσιμες ακόμη κι όταν η ίδια η εφαρμογή περνάει αλλαγές, γιατί το κέντρο τεκμηρίωσης δεν εξαρτάται από αυτήν.
Υπάρχει και ένα όφελος που φαίνεται λιγότερο. Επειδή το περιεχόμενο βγαίνει από ένα API, ο ίδιος μηχανισμός μπορεί να τροφοδοτήσει και έναν AI βοηθό που απαντά με βάση τις επίσημες οδηγίες, αντί να μαντεύει.
Τι θα έκανα διαφορετικά
Θα εκτιμούσα το budget πιο νωρίς και πιο αναλυτικά. Με καλύτερη εικόνα από την αρχή, ίσως να βρίσκαμε μια λύση με λιγότερη custom ανάπτυξη. Μια custom πλατφόρμα σου δίνει έλεγχο και γλιτώνει συνδρομές, αλλά η συντήρησή της είναι πλέον δική σου δουλειά. Αυτό είναι κόστος, απλώς δεν φαίνεται στο τιμολόγιο.
Ποια λύση σου ταιριάζει;
- Ένα προϊόν, λίγοι συντάκτες, θέλεις να ξεκινήσεις αύριο. Μια έτοιμη πλατφόρμα, όπως Notion ή Confluence. Η συνδρομή κοστίζει λιγότερο από την ανάπτυξη.
- Πολλά προϊόντα, δημόσιες οδηγίες για πελάτες, έλεγχος στο κόστος και στην εμφάνιση. Μια headless λύση σαν αυτή.
- Θέλεις το ίδιο περιεχόμενο να τροφοδοτεί και άλλες εφαρμογές ή έναν AI βοηθό. Κάτι που βγάζει το περιεχόμενο από API, έτοιμο ή custom.
- Δεν υπάρχει κανείς να συντηρήσει μια custom λύση. Έτοιμη πλατφόρμα, ό,τι κι αν κοστίζει. Ένα σύστημα χωρίς ιδιοκτήτη θα καταλήξει ξανά το παλιό site που κανείς δεν αγγίζει.
Αν οι οδηγίες σου είναι σκορπισμένες, γράψε μου πόσα προϊόντα έχεις, ποιος γράφει το περιεχόμενο και ποιος το διαβάζει. Θα σου πω ποια από τις παραπάνω περιπτώσεις είσαι και τι θα κόστιζε η κάθε επιλογή.